完工总结

要解决的问题

完工总结不是一个“生成报告”的按钮，而是把一次任务的零散信息整理成项目记忆的过程。很多团队在交付后只留下 commit message 和聊天记录，关键决策、验证方式、踩坑路径很快被遗忘，导致重复劳动和文档脱节。当任务涉及多个文件、命令、环境或外部服务时，谁做了什么、为什么这么做、验证是否真的通过，往往只有当事人清楚。这个技能的目标是在任务结束或阶段性收尾时，强制产出一份结构化、可审计、可复用的总结，并且自动识别哪些知识应该写回项目文档。

核心能力与工作流

技能按六步推进：

• 确认完成状态：先明确本次工作是否真正结束，或列出未完成项、阻塞项。避免把“看起来做完了”当成“已验证通过”。
• 收集证据：从当前回合提取文件变更、命令、验证结果、链接、工件、决策和阻塞项。证据优先，不凭空脑补。
• 区分事实与推断：推断的原因 必须标注，不能把猜测写成事实。
• 结构化输出：根据用户语言选择中英文章节。小任务可合并为短段落；中大型任务保留标题。
• 回写建议：识别持久知识，如真实路径、部署命令、工具故障模式、数据定义、用户偏好等。如果任务允许修改文档，直接更新；否则给出回写位置建议。
• 隐私清洗：在生成可分享总结前，移除密钥、令牌、私钥、完整凭证、客户数据、私人联系方式等敏感信息。

适用边界与注意点

• 技能不会自动执行验证，它只记录验证是否真实运行并得出结果。没有运行或未通过，就不能写“验证通过”。
• 安全规则是硬约束：即使资料里有原始凭证，也必须删除或脱敏。公开示例必须使用 sanitized 版本，不能复制私有项目细节。
• 回写文档需要上下文权限。如果任务不允许编辑文件，技能会明确建议应写到哪里，而不是悄悄忽略。
• 模板支持 en、zh、ar-sa、ko、ja、th 六种语言，可以根据用户语言生成对应空白 Markdown 文件。
• 总结的质量取决于证据完整度。如果证据不足，宁可少写，也不要编造命令结果或验证结论。