用途:将已完成里程碑的历史执行细节从活跃路径移出,生成精简快照摘要,折叠 roadmap.md 中对应阶段,防止历史文档持续污染 AI 对当前项目状态的判断。
前置成熟度检查:读取 milestones/{slug}/tasks.md,需全部任务已完成;并满足以下任一条件——距完成日期 ≥ 60 天(依据 frontmatter 的 completed_at),或当前进行中里程碑索引 ≥ slug + 2。不满足则拒绝执行并输出原因。
主要能力:阶段 2 始终从 tasks.md 提取完成日期、≤5 条关键交付物、遗留缺口(指向后续里程碑)、关键 ADR 引用,生成 milestones/_archive/{slug}-summary.md;阶段 3 分析 roadmap.md 需折叠的阶段段落,以及全仓引用旧 tasks.md 路径的文件。
使用方式:默认 dry-run(apply=false)仅输出预览报告,不修改文件,列出将生成、修改、删除的内容与引用更新位置;apply=true 时按预览执行并输出操作日志。apply=true 要求 git 工作区干净,先 commit 保存现场。
验收标准:执行后 AI 读取 _archive 摘要即可理解该里程碑关键结果,无需读取原始 tasks.md;roadmap.md 对应阶段折叠为 ≤3 行;全仓 grep 旧 tasks.md 路径无结果;milestones/{slug}/ 目录已移除。
限制与反模式:未经成熟度检查不得执行;apply=false 时不得修改任何文件;摘要不得省略遗留缺口;不得只生成摘要而不折叠 roadmap.md;删除任务目录前必须先完成全仓引用更新。文档未提供具体命令、依赖与平台信息。