v[X.Y] [Name] (Shipped: YYYY-MM-DD)【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-doneDelivered:[One sentence describing what shipped]Phases completed:[X-Y] ([Z] plans total)Key accomplishments:[Major achievement 1][Major achievement 2][Major achievement 3][Major achievement 4]Stats:files created/modified[Y] lines of code (primary language)[Z] phases, [N] plans, [M] tasks[D] days from start to ship (or milestone to milestone)Git range:feat(XX-XX)→feat(YY-YY)Whats next:[Brief description of next milestone goals, or Project complete]### 2.1 标题行## v[X.Y] [Name] (Shipped: YYYY-MM-DD) - 版本号遵循 [complete-milestone 工作流](https://link.gitcode.com/i/11c4ad15fc7aed25880be587d70774d3) milestone_naming 中的约定**v1.0** 表示初始 MVP**v1.1、v1.2** 表示次要更新/新特性/修复**v2.0、v3.0** 表示重大重写或方向转变 - 名称保持简短12 个词即可例如 v1.0 MVP、v1.1 Security、v1.2 Performance、v2.0 Redesign - Shipped 日期为真实交付日期格式 YYYY-MM-DD。 ### 2.2 Delivered一句话交付摘要 描述该版本对外交付了什么。注意它强调一句话与下方 Key accomplishments 的多条列表互为补充Delivered 是概括accomplishments 是展开。 ### 2.3 Phases completed 与 Key accomplishments Phases completed: [X-Y] ([Z] plans total) 明确记录阶段区间与计划总数例如 5-6 (3 plans total) 表示第 5、6 两个阶段共 3 个计划。 Key accomplishments 建议列 46 条阶段级成就。在 [complete-milestone 工作流](https://link.gitcode.com/i/11c4ad15fc7aed25880be587d70774d3) 的 extract_accomplishments 步骤中这些成就是从各阶段 SUMMARY.md 文件的一行摘要one-liner中提取的工作流给出了具体命令 bash # For each phase in milestone, extract one-liner for summary in .planning/phases/*-*/*-SUMMARY.md; do [ -e $summary ] || continue gsd-sdk query summary-extract $summary --fields one_liner --pick one_liner done2.4 Stats用 git 与文件系统算出来的交付数据模板要求统计四类数据其中前两项的获取命令已在模板guidelines中给出后两项来自 ROADMAP 与 git 时间线统计项命令/来源文件改动数git diff --stat feat(XX-XX)..feat(YY-YY) \| tail -1代码行数find . -name *.swift -o -name *.ts \| xargs wc -l按主语言换扩展名阶段/计划/任务数来自 ROADMAP 与阶段 SUMMARY**Tasks:** N字段时间线从第一个阶段提交到最后一个阶段提交的间隔天数stats 工作流 展示了运行时系统实际使用的数据通道gsd-sdk query stats.json返回milestone_version、phases、phases_completed、total_plans、total_summaries、percent、plan_percent、requirements_total、requirements_complete、git_commits、git_first_commit_date、last_activity等字段——这些正是里程碑条目 Stats 段的自动化数据源。2.5 Git range里程碑的提交区间格式固定为feat(XX-XX)→feat(YY-YY)含义是该里程碑的第一个提交 → 最后一个提交。例如阶段 1-4 对应feat(01-01)→feat(04-01)。feat(XX-XX)的两位编号分别代表阶段号与计划号这与 ROADMAP 中计划的命名约定{phase}-{plan}-PLAN.md如01-02-PLAN.md一致。2.6 Whats next衔接下一个版本一句话描述下一里程碑的目标如果项目已全部完成则写Project complete。这保证了 MILESTONES.md 不仅是回顾文件还天然指向下一步——complete-milestone 命令 在完成归档后会引导用户执行/gsd:new-milestone开启下一轮questioning → research → requirements → roadmap。2.7 分隔线---每条条目以---结尾将多个里程碑条目在视觉与结构上分隔开。三、MILESTONES.md 的文件级结构模板末尾的structure块规定了文件本身的结构若MILESTONES.md尚不存在先创建带标题的文件然后按逆时间序newest first追加条目# Project Milestones: [Project Name] [Entries in reverse chronological order - newest first]逆时间序这一规则并非只存在于文档中milestone.test.cjs 用三个测试用例对其做了硬性验证prepends to existing MILESTONES.md (reverse chronological)新条目必须出现在旧条目之前three sequential completions maintain reverse-chronological order连续完成 v1.0 → v1.1 → v1.2 后文件顺序必须为 v1.2 → v1.1 → v1.0archives roadmap, requirements, creates MILESTONES.mdmilestone complete v1.0 --name ...命令会自动创建/追加MILESTONES.md条目并包含版本名与从 SUMMARY 提取的成就。四、何时创建、何时不创建里程碑模板guidelines给出了明确的判断标准。应该创建里程碑初始 v1.0 MVP 交付重大版本发布v2.0、v3.0显著的功能里程碑v1.1、v1.2归档规划文档之前capture what was shipped。不应该创建里程碑单个阶段的完成属于正常工作流太细粒度进行中的工作等真正交付后再记不构成一次发布的次要 bug 修复。complete-milestone 工作流what_qualifies给出一条经验法则Is this deployed/usable/shipped? 如果是 → 记里程碑如果不是 → 继续开发。这一判断与stats中percent/plan_percent的进度口径一致——只有计划完成率达到 100% 的阶段才具备进入里程碑的条件。五、配套工作流MILESTONES.md 条目是如何被写出来的虽然模板允许手工维护但实际运行时主要由complete-milestone流程自动生成。从 complete-milestone 工作流 可以看到条目写入已委托给 CLIARCHIVE$(gsd-sdk query milestone.complete v[X.Y] --name [Milestone Name])CLI 负责的处理包括创建.planning/milestones/目录将 ROADMAP.md 归档为milestones/v[X.Y]-ROADMAP.md将 REQUIREMENTS.md 归档为milestones/v[X.Y]-REQUIREMENTS.md带归档头移动审计文件若存在创建/追加 MILESTONES.md 条目成就从各阶段 SUMMARY.md 文件提取更新 STATE.md状态、最后活动。返回结果中包含version、date、phases、plans、tasks、accomplishments、archived等字段——这些字段与模板条目一一对应。若需要补充用户自定义的 Delivered 摘要、Git range、LOC 统计工作流允许在 CLI 生成基础条目后手动追加。5.1 版本范围与统计口径milestone.test.cjs 对统计口径做了多处回归验证可直接作为理解模板 Stats 字段行为的依据scopes stats to current milestone phases onlyv1.1 完成时只统计第 3、4 阶段前一个里程碑阶段 1、2的目录不会混入统计counts tasks from **Tasks:** N in summary body任务数来自 SUMMARY 正文中的**Tasks:** N字段extracts one-liner from body when not in frontmatter成就既可以来自 SUMMARY 的 frontmatterone-liner字段也可以来自正文首行加粗句phase 1 in roadmap does NOT match directory 10-something阶段号匹配做了防前缀碰撞处理milestone complete explicit version scope (#3043)显式指定版本时只统计该版本区间内的阶段即使 STATE.md 中的里程碑号不同。5.2 归档与收尾MILESTONES.md 之外的配套动作里程碑条目写好之后complete-milestone 工作流 还会继续完成一系列配套动作理解它们有助于把 MILESTONES.md 放在正确的上下文里PROJECT.md 全面演进把已交付需求移入Validated段格式- ✓ [Requirement] — v[X.Y]更新 Core Value、Context、Key Decisions并在文件尾更新*Last updated: [date] after v[X.Y] milestone*ROADMAP.md 重组已完成的里程碑折叠进details并保留 Backlog 段形成 Milestone-Grouped 结构见 roadmap.md 下半部分阶段编号持续递增、绝不从 01 重启git tag按git.create_tag配置创建注解标签git tag -a v[X.Y] -m [milestone summary]标签信息与 MILESTONES.md 条目呼应Delivered、Key accomplishments、指向.planning/MILESTONES.md的说明RETROSPECTIVE.md追加里程碑复盘段并更新 Cross-Milestone Trends。5.3 深度归档milestone-archive 模板对于需要完整阶段详情的版本milestone-archive.md 提供了比 MILESTONES.md 条目更深的归档模板落盘于.planning/milestones/v{VERSION}-{NAME}.md如v1.0-mvp.md。它包含里程碑头Status、Phases、Total Plans、每个阶段的 Goal/Depends on/Plans 列表、(INSERTED)标记的十进制阶段如 Phase 2.1、以及里程碑摘要Key Decisions、Issues Resolved/Deferred、Technical Debt Incurred。两者分工明确MILESTONES.md 是轻量的版本日志milestones/ 归档是完整的版本快照。六、完整示例WeatherBar 项目的两条里程碑模板example给出了可直接对照填写的完整示例。以下是模板原文示例WeatherBar一个菜单栏天气应用# Project Milestones: WeatherBar ## v1.1 Security Polish (Shipped: 2025-12-10) **Delivered:** Security hardening with Keychain integration and comprehensive error handling **Phases completed:** 5-6 (3 plans total) **Key accomplishments:** - Migrated API key storage from plaintext to macOS Keychain - Implemented comprehensive error handling for network failures - Added Sentry crash reporting integration - Fixed memory leak in auto-refresh timer **Stats:** - 23 files modified - 650 lines of Swift added - 2 phases, 3 plans, 12 tasks - 8 days from v1.0 to v1.1 **Git range:** feat(05-01) → feat(06-02) **Whats next:** v2.0 SwiftUI redesign with widget support --- ## v1.0 MVP (Shipped: 2025-11-25) **Delivered:** Menu bar weather app with current conditions and 3-day forecast **Phases completed:** 1-4 (7 plans total) **Key accomplishments:** - Menu bar app with popover UI (AppKit) - OpenWeather API integration with auto-refresh - Current weather display with conditions icon - 3-day forecast list with high/low temperatures - Code signed and notarized for distribution **Stats:** - 47 files created - 2,450 lines of Swift - 4 phases, 7 plans, 28 tasks - 12 days from start to ship **Git range:** feat(01-01) → feat(04-01) **Whats next:** Security audit and hardening for v1.1【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考