mcpField
G
gsd-complete-milestone

gsd-complete-milestone

github.com/shoootyouAgent 工作流22111 次安装32 周前更新
代码仓库

关于 gsd-complete-milestone

gsd-complete-milestone 引导用户归档项目里程碑、更新规划文档，并创建 Git 提交和标签。流程包括就绪检查、审批环节、里程碑统计，以及面向下一里程碑的后续指引。

主要功能

  1. 01检查里程碑审计和阶段就绪情况
  2. 02汇总范围、统计数据与成果
  3. 03归档路线图和需求
  4. 04更新项目及路线图文档
  5. 05提交更改并创建 Git 标签

适用场景

  1. 01归档已交付的项目里程碑
  2. 02为下一里程碑更新项目规划文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/shoootyou/get-shit-done-multi --skill gsd-complete-milestone

安装后在 Claude Code 中输入/gsd-complete-milestone确认已加载。

详细介绍

将里程碑 {{version}} 标记为已完成，归档到 milestones/，并更新 ROADMAP.md 和 REQUIREMENTS.md。

目的：为已发布版本创建历史记录，归档里程碑文件（路线图 + 需求），并为下一个里程碑做准备。 输出：里程碑已归档（路线图 + 需求），PROJECT.md 已更新，Git 标签已创建。

<execution_context> 现在加载以下文件（继续之前）：

  • @{{PLATFORM_ROOT}}/get-shit-done/workflows/complete-milestone.md（主工作流）
  • @{{PLATFORM_ROOT}}/get-shit-done/templates/milestone-archive.md（归档模板） </execution_context>
**项目文件：** - `.planning/ROADMAP.md` - `.planning/REQUIREMENTS.md` - `.planning/STATE.md` - `.planning/PROJECT.md`

用户输入：

  • 版本：{{version}}（例如："1.0"、"1.1"、"2.0"）

遵循 complete-milestone.md 工作流：

  1. 检查审计：

    • 查找 .planning/v{{version}}-MILESTONE-AUDIT.md
    • 如果文件缺失或已过时：建议先运行 {{COMMAND_PREFIX}}audit-milestone
    • 如果审计状态为 gaps_found：建议先运行 {{COMMAND_PREFIX}}plan-milestone-gaps
    • 如果审计状态为 passed：继续步骤 1
    ## Pre-flight Check

{If no v{{version}}-MILESTONE-AUDIT.md:}
⚠ No milestone audit found. Run `{{COMMAND_PREFIX}}audit-milestone` first to verify
requirements coverage, cross-phase integration, and E2E flows.

{If audit has gaps:}
⚠ Milestone audit found gaps. Run `{{COMMAND_PREFIX}}plan-milestone-gaps` to create
phases that close the gaps, or proceed anyway to accept as tech debt.

{If audit passed:}
✓ Milestone audit passed. Proceeding with completion.

  2. 确认已就绪：

    • 检查里程碑中的所有阶段是否都有已完成的计划（SUMMARY.md 存在）
    • 展示里程碑范围和统计数据
    • 等待确认

  3. 收集统计数据：

    • 统计阶段、计划和任务数量
    • 计算 Git 范围、文件变更和代码行数
    • 从 Git 日志提取时间线
    • 展示摘要并确认

  4. 提取成果：

    • 阅读里程碑范围内所有阶段的 SUMMARY.md 文件
    • 提取 4-6 项关键成果
    • 提交审批

  5. 归档里程碑：

    • 创建 .planning/milestones/v{{version}}-ROADMAP.md
    • 从 ROADMAP.md 提取完整的阶段详情
    • 填写 milestone-archive.md 模板
    • 将 ROADMAP.md 更新为带链接的单行摘要

  6. 归档需求：

    • 创建 .planning/milestones/v{{version}}-REQUIREMENTS.md
    • 将所有 v1 需求标记为已完成（勾选复选框）
    • 记录需求结果（已验证、已调整、已删除）
    • 删除 .planning/REQUIREMENTS.md（为下一个里程碑创建新的文件）

  7. 更新 PROJECT.md：

    • 添加“当前状态”部分，注明已发布的版本
    • 添加“下一个里程碑目标”部分
    • 将之前的内容归档到 <details> 中（如果是 v1.1+）

  8. 提交并打标签：

    • 暂存：MILESTONES.md、PROJECT.md、ROADMAP.md、STATE.md、归档文件
    • 提交：chore: archive v{{version}} milestone
    • 打标签：git tag -a v{{version}} -m "[milestone summary]"
    • 询问是否推送标签

  9. 提供后续步骤：

    • {{COMMAND_PREFIX}}new-milestone — 开始下一个里程碑（提问 → 调研 → 需求 → 路线图）

<success_criteria>

  • 里程碑已归档到 .planning/milestones/v{{version}}-ROADMAP.md
  • 需求已归档到 .planning/milestones/v{{version}}-REQUIREMENTS.md
  • .planning/REQUIREMENTS.md 已删除（为下一个里程碑创建新的文件）
  • ROADMAP.md 已精简为单行条目
  • PROJECT.md 已更新当前状态
  • Git 标签 v{{version}} 已创建
  • 提交成功
  • 用户了解后续步骤（包括需要创建新的需求文件） </success_criteria>

<critical_rules>

  • 先加载工作流： 执行前先阅读 complete-milestone.md
  • 确认完成状态： 所有阶段都必须有 SUMMARY.md 文件
  • 等待用户确认： 在确认节点等待用户批准
  • 先归档再删除： 更新或删除原文件前，始终先创建归档文件
  • 单行摘要： ROADMAP.md 中精简后的里程碑应为带链接的单行内容
  • 提高上下文效率： 通过归档，让 ROADMAP.md 和 REQUIREMENTS.md 的大小在每个里程碑中保持稳定
  • 创建新的需求文件： 下一个里程碑从 {{COMMAND_PREFIX}}new-milestone 开始，其中包含需求定义 </critical_rules>

评论

支持 Markdown