用途
gsd-complete-milestone 用于在项目里程碑完成后，创建已发布版本的历史记录，归档里程碑产物（路线图与需求），并为下一个里程碑做准备。其输出包括：里程碑归档（路线图与需求）、更新后的 PROJECT.md，以及 git 标签。
主要能力
- 检查里程碑审计：查找 .planning/v{{version}}-MILESTONE-AUDIT.md。若缺失或过期，建议先运行 {{COMMAND_PREFIX}}audit-milestone；若审计状态为 gaps_found，建议先运行 {{COMMAND_PREFIX}}plan-milestone-gaps；若审计通过，则继续执行。
- 就绪性验证：检查里程碑内所有阶段是否都有已完成的计划（存在 SUMMARY.md），展示里程碑范围与统计信息，并等待确认。
- 收集统计：统计阶段、计划、任务数量，计算 git 范围、文件变更、代码行数，从 git 日志提取时间线，展示摘要并确认。
- 提取成果：读取里程碑范围内所有阶段的 SUMMARY.md 文件，提取 4-6 项关键成果并提交审批。
- 归档里程碑：创建 .planning/milestones/v{{version}}-ROADMAP.md，从 ROADMAP.md 提取完整阶段详情，填充 milestone-archive.md 模板，并将 ROADMAP.md 更新为带链接的一行摘要。
- 归档需求：创建 .planning/milestones/v{{version}}-REQUIREMENTS.md，将所有 v1 需求标记为完成（勾选复选框），记录需求结果（已验证、已调整、已放弃），并删除 .planning/REQUIREMENTS.md（为下一里程碑创建新文件）。
- 更新 PROJECT.md：添加包含已发布版本的“Current State”部分，添加“Next Milestone Goals”部分，若为 v1.1+ 则将先前内容归档到 <details> 中。
- 提交与打标签：暂存 MILESTONES.md、PROJECT.md、ROADMAP.md、STATE.md 及归档文件；提交信息为 chore: archive v{{version}} milestone；创建标签 git tag -a v{{version}} -m "[milestone summary]"；询问是否推送标签。
- 提供后续步骤：{{COMMAND_PREFIX}}new-milestone — 开始下一个里程碑（提问 → 研究 → 需求 → 路线图）。
使用方式
执行前需加载以下文件：
@{{PLATFORM_ROOT}}/get-shit-done/workflows/complete-milestone.md（主工作流）
@{{PLATFORM_ROOT}}/get-shit-done/templates/milestone-archive.md（归档模板）
用户输入：Version: {{version}}（例如 "1.0"、"1.1"、"2.0"）。
随后按照 complete-milestone.md 工作流执行上述步骤。
成功标准
- 里程碑归档至 .planning/milestones/v{{version}}-ROADMAP.md
- 需求归档至 .planning/milestones/v{{version}}-REQUIREMENTS.md
- .planning/REQUIREMENTS.md 已删除（为下一里程碑准备新文件）
- ROADMAP.md 折叠为一行条目
- PROJECT.md 已更新当前状态
- 已创建 Git 标签 v{{version}}
- 提交成功
- 用户知晓后续步骤（包括需要全新需求）
关键规则
- 先加载工作流：执行前阅读 complete-milestone.md
- 验证完成：所有阶段必须有 SUMMARY.md 文件
- 用户确认：在验证关口等待批准
- 先归档再删除：在更新/删除原始文件前始终创建归档文件
- 一行摘要：ROADMAP.md 中折叠的里程碑应为带链接的单行
- 上下文效率：归档使 ROADMAP.md 和 REQUIREMENTS.md 每个里程碑保持恒定大小
- 全新需求：下一里程碑以 {{COMMAND_PREFIX}}new-milestone 开始，其中包含需求定义
适用场景
适用于采用里程碑式规划、需要为每个版本保留可追溯归档的开发流程，尤其是使用 get-shit-done 工作流体系的项目。
限制
资料未提供关于收费、价格、平台支持范围或具体效果的信息。