当用户完成一个项目功能、里程碑、调试会话、交付阶段或学习节点,并希望生成一份 Markdown 格式的复盘文档,用于后续学习、面试准备、简历中的故事化呈现或技术回顾时使用,尤其适用于……
总结工程里程碑
功能概述
总结工程里程碑是一项面向实际任务的技能,主要用于概览. 创建一个磨损的Markdown里程碑审查, 由当前对话, 本地代码上下文, diffs, 测试, 以及用户的指定目标。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
项目里程碑总结
概述
基于当前对话、本地代码上下文、变更差异(diffs)、测试结果以及用户明确陈述的目标,生成一份专业、精炼的 Markdown 格式里程碑复盘文档。该文档需兼顾两大用途:便于日后快速回顾,以及满足技术面试中清晰讲述项目故事的需求。
当用户使用中文输入时,默认输出中文版本。所有技术标识符、CLI 命令、路径、代码符号等均保持原文不变。中文输出时,章节标题应自然翻译为符合中文技术文档习惯的表达,而非直译或保留英文标签。
工作流程
- 确认输出目录与文档标题。
- 若用户提供目录,则直接采用。
- 若用户未提供目录,则在生成前仅作一次简短澄清询问。
- 若用户未提供标题,则根据所实现的功能或里程碑内容推断一个简洁准确的标题。
- 汇总证据后再进行总结。
- 通读当前对话,提取关键决策、阻塞问题、修复措施及验证结论。
- 在可用前提下,检查相关源文件、近期 diff、测试用例、日志输出和执行命令。
- 优先引用具体代码位置或行为,避免笼统描述。
- 生成单个 Markdown 文件,命名为
YYYY-MM-DD-。.md - 对文件名中主机操作系统不支持的字符进行清洗(sanitize)。
- 若输出目录不存在,则自动创建。
- 禁止静默覆盖已有文件;当覆盖意图不明确时,应追加数字后缀或主动向用户确认。
- 结尾附一段简明备注,说明已保存的文件路径,并指出任何证据缺失项。
文档结构
除非用户另行指定,否则统一采用以下结构:
# <标题> ## 一句话总结 ## 背景与目标 ## 已完成工作 ## 核心实现 ## 解决的关键难点 ## 优化点与权衡取舍 ## 关键代码索引 ## 验证方式 ## 面试叙事 ## 复盘检查清单 ## 后续风险或改进方向
各章节撰写指引
一句话总结:用一句紧凑的话说明实现了什么,以及其技术或业务价值。
背景与目标:阐述原始问题、用户需求、所属业务或工程背景,以及明确的成功标准。
已完成工作:逐条列出可验证的具体交付成果,例如新增/修改的行为、变更的文件、调用的 API、UI 状态变化、部署配置更新、产出的文档等。
核心实现:说明主要技术方案设计、数据流向、关键方法/类/组件及其协作关系。
解决的关键难点:聚焦需工程判断的问题,例如需求模糊、集成失败、环境异常、边界情况、性能瓶颈、兼容性问题、权限限制、数据一致性挑战,或调试过程中的意外发现。
优化点与权衡取舍:说明为何选择当前方案、被否决的替代方案,以及在可维护性、性能、可靠性、可读性或用户体验等方面所做的改进。
关键代码索引:列出关键文件路径、函数/组件/类名称,并附简要说明;若行号可靠,可标注具体行号;代码片段应尽量简短,以引用加解释为主。
验证方式:记录实际执行的命令、运行的测试、人工检查步骤、截图、构建结果、部署验证结果,以及已知尚未验证的部分。
面试叙事:提供 2–4 条第一人称表述、可用于技术面试的要点,并在里程碑内容足够充实的前提下,补充可能的追问问题及简洁有力的回答。
复盘检查清单:以紧凑的条目形式罗列用户后续可快速扫读的关键内容:核心概念、常用命令、易错陷阱、典型模式、领域术语等。
后续风险或改进方向:指出尚存的技术风险、待偿还的技术债、需关注的监控指标,或下一步合理可行的工作项;不虚构问题,对不确定性需明确标注。
证据使用规范
- 严格区分事实与推断。必要时使用“根据代码”“由本次对话推断”等明确措辞;中文输出中需自然转译此类提示语。
- 避免空泛表扬。每一处亮点都必须锚定到具体的实现选择、缺陷修复、命令执行、文件变更或可观测结果上。
- 若缺少代码上下文,应如实说明缺失内容,并基于现有对话信息尽力完成最合理的复盘,不得虚构或掩饰。
- 若当前仓库存在未提交或无关的变更,不得回退;仅使用与本里程碑直接相关的证据。
- 若某项测试或构建未实际运行,须在
验证方式中直接注明。
质量标准
最终生成的文档应能切实帮助用户回答以下问题:
- 该功能解决了什么问题?
- 用户具体实现了哪些可验证的部分?
- 过程中遇到了哪些困难?如何诊断并解决?
- 为何选择该设计方案?做了哪些关键权衡?
- 如何验证功能的正确性?
- 面对面试官的深入追问,能否清晰讲解代码细节与工程决策?
热门AI工具
相关专题
本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题梳理XORM框架的入门路径,从框架定位、依赖安装、连接数据库到跑通第一个增删改查示例,讲清Engine初始化、日志开启与项目目录规划,并对比GORM等同类ORM的差异,帮助Go开发者建立整体认知。
0
2026.11.04
本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。
0
2026.11.03
想使用Docker Desktop将本地项目构建成Docker镜像?本专题围绕镜像构建的实际操作展开,介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容,同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。
0
2026.11.03
本专题聚焦Docker Desktop容器创建与运行配置,介绍通过本地镜像或远程镜像创建容器的方法,以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况,也整理了相应的排查方向。
0
2026.11.03
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.7万人学习
共6课时 | 54.7万人学习