项目里程碑总结（复习与面试）

要解决什么问题

做完一个功能或里程碑后，对话记录、改动文件和验证步骤往往散落在 IDE、终端和聊天里。过几周再复习时很难快速还原「当时定了什么、改了哪、卡在哪」；面试里要讲清楚实现细节，也缺少一份按结构组织、能对照代码的证据链。

技能如何工作

该技能从当前对话、本地代码上下文、diff、测试与日志（若可用）以及你声明的目标里收集事实，写出一份带日期的 Markdown 复盘（YYYY-MM-DD-*.md）。默认流程包括：确认输出目录与标题；在总结前先核对决策、阻塞项、修复与验证；按固定章节组织正文，避免空泛描述。

文档结构覆盖工程复盘与叙述准备两类用途，例如：

• 一句话摘要与背景目标
• 已完成工作、关键实现（数据流、核心类/方法/组件）
• 难点与排查、方案取舍与优化
• 关键代码索引（路径、符号，必要时行号）
• 验证方式（命令、测试、未验证项需写明）
• 面试叙述：第一人称要点、可能的追问与简短回答
• 复习清单与后续风险/改进

写作要求区分事实与推断（如「从代码可见」「据本次对话推断」），缺代码上下文时会说明缺口，而不是编造实现细节。

适用边界与注意点

• 未指定输出目录时，技能会先向你确认路径，不会静默覆盖已有同名文件。
• 若仓库存在无关或未提交改动，技能只使用与本次里程碑相关的证据，不会替你回滚工作区。
• 未实际运行的测试或构建，会在验证章节如实标注，适合作为诚实的技术复盘，而非对外发布稿。