用途:在 GSD 开发流程中为已交付版本建立历史记录,归档里程碑产物(路线图与需求),并为下一里程碑做准备。输出结果为:里程碑已归档(路线图与需求)、PROJECT.md 更新、创建 Git 标签。
主要能力:检查 .planning/v{{version}}-MILESTONE-AUDIT.md 审计文件;若缺失或过期建议先运行 /gsd-audit-milestone;若审计状态为 gaps_found,建议用 /gsd-phase --insert <N> 插入收尾阶段并走 /gsd-discuss-phase → /gsd-plan-phase → /gsd-execute-phase 流程补齐,或接受缺口作为技术债;若通过则继续。随后核验各阶段是否有 SUMMARY.md,统计阶段、计划、任务数量及 git 范围、文件变更、代码行数,提取 4-6 项关键成果并请用户确认。归档阶段生成 .planning/milestones/v{{version}}-ROADMAP.md 与 v{{version}}-REQUIREMENTS.md,将 ROADMAP.md 压缩为带链接的单行摘要,删除 .planning/REQUIREMENTS.md,更新 PROJECT.md 的 Current State 与 Next Milestone Goals,提交 chore: archive v{{version}} milestone 并执行 git tag -a v{{version}} -m "[milestone summary]",询问是否推送标签,并提示下一步可用 /gsd-new-milestone。
使用方式:执行前须先读取主工作流文件与归档模板(@~/.claude/gsd-core/workflows/complete-milestone.md 与 @~/.claude/gsd-core/templates/milestone-archive.md),传入版本号(如 1.0、1.1、2.0)。各确认关口需等待用户批准。
限制:所有阶段必须存在 SUMMARY.md;必须先归档再更新或删除原文件;标签创建取决于 git.create_tag 是否启用。资料未提供具体平台、收费或价格信息。