用途：把已交付的版本固化为历史记录，归档里程碑产物（路线图与需求），并准备下一个里程碑。调用方式为在提示中提及 $gsd-complete-milestone，其后文本作为参数；无参数时视为空。
主要能力：先检查 .planning/v{{version}}-MILESTONE-AUDIT.md 审计文件；缺失或过期时建议先运行 $gsd-audit-milestone，审计存在缺口时建议运行 $gsd-plan-milestone-gaps。随后核验里程碑内所有阶段是否都有 SUMMARY.md，展示里程碑范围与统计（阶段、计划、任务数，Git 范围、文件变更、代码行数、时间线），提取 4-6 项关键成果待确认。归档时创建 .planning/milestones/v{{version}}-ROADMAP.md 与 v{{version}}-REQUIREMENTS.md，把 ROADMAP.md 压缩为带链接的一行摘要，将需求标记为完成并记录结果，删除 .planning/REQUIREMENTS.md。更新 PROJECT.md，加入当前状态与下一里程碑目标，并把旧内容折叠保存。最后暂存 MILESTONES.md、PROJECT.md、ROADMAP.md、STATE.md 及归档文件，提交信息为 chore: archive v{{version}} milestone，并执行 git tag -a v{{version}} -m "[milestone summary]"，再询问是否推送标签。
适用场景：GSD 项目完成一个版本、需要归档并开启下一版本时。限制：需先加载 complete-milestone.md 工作流；必须在用户确认的检查点等待批准；先归档再删除原文件；若审计缺失或存在缺口，需接受技术债或先处理缺口；下一步需通过 $gsd-new-milestone 重新定义需求。该技能同时给出 Codex 适配映射，如 AskUserQuestion 转为 request_user_input、Task 转为 spawn_agent。