chief-retro 用于对当前里程碑或最新批次做复盘(retrospective),属于只读分析流程,不会改动目标、契约或计划。
用途与范围识别:读取当前里程碑下的 _plan/_todo.md。若所有任务都标记为 [x],执行里程碑复盘;若仍有未完成任务,则执行批次复盘,仅覆盖最近完成的批次。
输入来源:批次复盘读取最新的 _report/autopilot-run-batch-<N>.md、_plan/_todo.md(已完成与未完成)、_goal/ 与 _contract/ 文件,以及自上一份批次报告(或里程碑起点)以来的 git log。里程碑复盘则读取全部 _report/ 文件、完整 _plan/_todo.md 历史、_goal/ 与 _contract/ 文件,以及整个里程碑的 git log。
报告结构:包含覆盖率检查(逐一对每个目标与契约文件标注 ✅ 满足 / ⚠️ 部分 / ❌ 缺失,并注明已完成或缺失内容)、计划与实际交付对比(TODO 中有什么、实际完成了什么、执行中被跳过或变更的部分)、遇到的阻碍及解决情况、经验教训(好与坏的模式、反复出现的问题、意外结果、值得重复的做法)、建议的规则更新(每条包含 What、Where、Why、Suggestion,Where 指向 .chief/_rules/ 下的具体文件)、以及需要人工决策的事项(需要新一批次处理的目标或契约、是否升级为永久规则、自动化无法处理的手动步骤)。
输出文件:批次复盘写入 .chief/<milestone>/_report/retro-batch-<N>.md;里程碑复盘写入 .chief/<milestone>/_report/retro-milestone.md,其中 <N> 对应当前审查的批次号。
报告完成后:向用户展示建议的规则更新并询问是否应用,由用户选择。对批准的提案,在 .chief/_rules/ 中创建或更新对应文件;被拒绝的提案仅保留在报告中。
规则约束:绝不跳过覆盖率检查,这是复盘的核心价值;绝不自动应用规则提案,必须先询问;不修改目标、契约或计划,复盘对它们只读,仅 _rules/ 可更新;必须基于真实 git log 与文件内容,不得凭记忆总结;遵循规则层级 AGENTS.md > .chief/_rules > 里程碑目标。
适用场景为使用 chief 工作流管理里程碑与批次的开发项目。限制:资料未提供具体安装方式、支持的平台、运行环境要求及是否收费等信息。