Current Position【免费下载链接】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-donePhase: Not started (defining requirements) Plan: — Status: Defining requirements Last activity: [today] — Milestone v[X.Y] started工作流文档明确要求**不要手工编辑 STATE.md**必须走 SDK 处理器。 ## Step 6–7清理提交与加载运行时上下文 ### 清理与提交 - 删除已消费的 MILESTONE-CONTEXT.md若存在 - 清空上一里程碑遗留的阶段目录 bash gsd-sdk query phases.clear --confirmphasesClear处理器位于 sdk/src/query/phase-lifecycle.ts#L1678-L1715它会删除除999.x之外的 backlog 阶段目录且必须带--confirm否则抛出校验错误Pass --confirm to proceed——这是一道防误删的安全闸门。提交规划文档gsd-sdk query commit docs: start milestone v[X.Y] [Name] --files .planning/PROJECT.md .planning/STATE.md加载初始化上下文与模型INIT$(gsd-sdk query init.new-milestone) if [[ $INIT file:* ]]; then INIT$(cat ${INIT#file:}); fi AGENT_SKILLS_RESEARCHER$(gsd-sdk query agent-skills gsd-project-researcher) AGENT_SKILLS_SYNTHESIZER$(gsd-sdk query agent-skills gsd-research-synthesizer) AGENT_SKILLS_ROADMAPPER$(gsd-sdk query agent-skills gsd-roadmapper)从 init JSON 中提取的关键字段TS 实现见 sdk/src/query/init.ts#L613-L670CJS 平行实现见 get-shit-done/bin/lib/init.cjs#L563-L607字段含义来源researcher_model/synthesizer_model/roadmapper_model三类子代理的模型别名getModelAlias解析commit_docs是否提交规划文档config.commit_docsresearch_enabled是否默认开启研究config.workflow.researchcurrent_milestone/latest_completed_milestone当前与最近完成版本getMilestoneInfo/getLatestCompletedMilestonephase_dir_count当前里程碑的阶段目录数目录扫描按里程碑过滤见 bug #2445 注释phase_archive_path归档路径milestones/{version}-phases/最近完成里程碑project_exists/roadmap_exists关键文件是否存在文件系统探测agents_installed/missing_agents子代理安装状态安装探测特别值得注意phase_dir_count的语义SDK 与 CJS 两侧都按里程碑过滤阶段目录getMilestonePhaseFilter避免上一里程碑未归档的残留目录虚增计数、进而误判 fresh start注释中明确标注了 bug #2445。如果agents_installed为false工作流会显示警告并列出缺失的代理提示npx get-shit-done-cclatest --global安装然后跳过并行研究、内联生成路线图——这是一个优雅降级路径。Step 7.5--reset-phase-numbers的安全护栏仅当显式传入--reset-phase-numbers时生效将新路线图的起始阶段编号设为1若phase_dir_count 0先把旧阶段目录归档避免新01-*/02-*目录与残留里程碑目录冲突mkdir -p ${phase_archive_path} find .planning/phases -mindepth 1 -maxdepth 1 -type d -exec mv {} ${phase_archive_path}/ \;归档后需验证.planning/phases/不再包含旧目录。若phase_dir_count 0但phase_archive_path缺失即没有已完成的里程碑归档目标工作流会停止并解释重置编号在不具备归档目标时不安全需先完成/归档上一里程碑再重跑/gsd:new-milestone --reset-phase-numbers ${GSD_WS}。Step 8研究决策与四路并行研究决策分支research_enabled来自 init JSON即config.workflow.research。工作流根据默认值调整 AskUserQuestion 的选项顺序默认开启推荐 Research first (Recommended)可 Skip research for this milestone默认关闭推荐 Skip research (current default)可临时 Research first。一个关键约束被文档显式强调不要把本次选择持久化到 config.json。workflow.research是跨项目、控制plan-phase行为的持久用户偏好在这里修改会静默改变未来的/gsd:plan-phase行为要改默认值应走/gsd:settings。四路并行研究选择 Research first 后工作流建立.planning/research/目录并行派生 4 个gsd-project-researcher子代理每个代理使用统一模板含research_type、milestone_context、question、files_to_read、${AGENT_SKILLS_RESEARCHER}、downstream_consumer、quality_gate、output等占位但按维度填充不同字段维度EXISTING_CONTEXTQUESTIONCONSUMER 关注点输出文件Stack已验证能力不再重复研究新特性需要哪些栈增补/变更带版本的库、集成点、不要加什么STACK.mdFeatures已构建特性目标特性通常如何运作、期望行为表内/差异化/反特性、复杂度、依赖FEATURES.mdArchitecture既有架构目标特性如何集成到既有架构集成点、新组件、数据流变化、构建顺序ARCHITECTURE.mdPitfalls—向该领域新增这些特性的常见错误预警信号、预防策略、应由哪个阶段处理PITFALLS.md每个代理以subagent_typegsd-project-researcher、model{researcher_model}派生产物模板位于~/.claude/get-shit-done/templates/research-project/{FILE}。文档在此嵌入两条CODEX 运行时编排规则派生 4 个研究代理后不得自行读取研究文件或独立综合防止重复劳动浪费上下文必须等 4 个代理全部完成后才派生合成器合成器gsd-research-synthesizer读取四份研究文件产出SUMMARY.md并提交随后工作流展示要点摘要Stack additions / Feature table stakes / Watch Out For。Step 9定义带 REQ-ID 的规格化需求进入 DEFINING REQUIREMENTS 阶段后读取PROJECT.md的 core value、当前里程碑目标、已验证需求若$SELECTED_SEEDS非空将种子想法及其 Why This Matters 并入需求定义输入若有研究产物读取FEATURES.md并按类别呈现Table stakes / Differentiators / Research notes若无研究则通过对话收集需求What are the main things users need to do with [new features]?对每个类别用AskUserQuestionmultiSelect: trueheader 不超过 12 字符进行范围圈定选项含 None for this milestone推迟整个类别通过 AskUserQuestion 检查缺口No, research covered it / Yes, let me add some。随后生成REQUIREMENTS.md按类别分组的 v1 需求复选框 REQ-IDFuture Requirements推迟项Out of Scope显式排除及理由Traceability 章节空由路线图填充REQ-ID 格式为[CATEGORY]-[NUMBER]如AUTH-01、NOTIF-02并延续既有编号。文档给出四条需求质量准则具体可测User can reset password via email link 而非 Handle password reset、用户视角User can X 而非 System does Y、原子性一条需求一个能力、独立性需求间依赖最小。完整需求列表须向用户确认yes / adjustadjust 则回到范围圈定循环确认后提交gsd-sdk query commit docs: define milestone v[X.Y] requirements --files .planning/REQUIREMENTS.mdStep 10派生 roadmapper 生成分阶段路线图起始阶段编号--reset-phase-numbers激活 → 从Phase 1开始默认 → 延续上一里程碑的最后阶段编号v1.0 结束于 phase 5则 v1.1 从 phase 6 开始。子代理契约roadmapper 子代理gsd-roadmapper接收planning_context读取PROJECT.md、REQUIREMENTS.md、research/SUMMARY.md若存在、config.json、MILESTONES.md与 7 条明确指令尊重所选编号模式reset 或延续仅从本里程碑的需求推导阶段每条需求精确映射到一个阶段每阶段推导 2–5 条成功标准可观察的用户行为校验 100% 覆盖立即写文件ROADMAP.md、STATE.md更新REQUIREMENTS.md的可追溯性返回ROADMAP CREATED及摘要。文档同样嵌入 CODEX 编排规则派生后立即停止本任务工作等待子代理返回结果。返回处理与审批## ROADMAP BLOCKED展示阻塞点与用户协作后重新派生## ROADMAP CREATED读取并内联展示提案路线图## Proposed Roadmap **[N] phases** | **[X] requirements mapped** | All covered ✓ | # | Phase | Goal | Requirements | Success Criteria | |---|-------|------|--------------|------------------| | [N] | [Name] | [Goal] | [REQ-IDs] | [count] |并通过 AskUserQuestion 提供三选一审批Approve提交并继续、Adjust phases收集修改意见、带修订上下文重派生、循环至批准、Review full file展示原始ROADMAP.md后重新询问。批准后提交gsd-sdk query commit docs: create milestone v[X.Y] roadmap ([N] phases) --files .planning/ROADMAP.md .planning/STATE.md .planning/REQUIREMENTS.mdStep 10.5待办事项与路线图阶段的关联路线图批准后扫描待办事项并打上resolves_phase标签PENDING_TODOS$(ls .planning/todos/pending/*.md 2/dev/null | head -50)无待办则静默跳过。否则将每个待办的title/areafrontmatter 字段及正文Problem 与 Solution与各阶段的 goal、REQ-ID、描述做尽力而为的匹配文档强调不要过度匹配窄范围、具体 scope 的待办是最佳候选模糊或横切待办保持不关联。匹配成功的待办在 YAML frontmatter 中追加resolves_phase: [N]--- created: [existing] title: [existing] area: [existing] resolves_phase: [N] files: [existing] ---只修改有明确自信匹配的待办匹配后提交gsd-sdk query commit docs: tag [count] pending todos with resolves_phase after milestone v[X.Y] roadmap --files .planning/todos/pending/*.md【免费下载链接】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），仅供参考 Current Position
Current Position【免费下载链接】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-donePhase: Not started (defining requirements) Plan: — Status: Defining requirements Last activity: [today] — Milestone v[X.Y] started工作流文档明确要求**不要手工编辑 STATE.md**必须走 SDK 处理器。 ## Step 6–7清理提交与加载运行时上下文 ### 清理与提交 - 删除已消费的 MILESTONE-CONTEXT.md若存在 - 清空上一里程碑遗留的阶段目录 bash gsd-sdk query phases.clear --confirmphasesClear处理器位于 sdk/src/query/phase-lifecycle.ts#L1678-L1715它会删除除999.x之外的 backlog 阶段目录且必须带--confirm否则抛出校验错误Pass --confirm to proceed——这是一道防误删的安全闸门。提交规划文档gsd-sdk query commit docs: start milestone v[X.Y] [Name] --files .planning/PROJECT.md .planning/STATE.md加载初始化上下文与模型INIT$(gsd-sdk query init.new-milestone) if [[ $INIT file:* ]]; then INIT$(cat ${INIT#file:}); fi AGENT_SKILLS_RESEARCHER$(gsd-sdk query agent-skills gsd-project-researcher) AGENT_SKILLS_SYNTHESIZER$(gsd-sdk query agent-skills gsd-research-synthesizer) AGENT_SKILLS_ROADMAPPER$(gsd-sdk query agent-skills gsd-roadmapper)从 init JSON 中提取的关键字段TS 实现见 sdk/src/query/init.ts#L613-L670CJS 平行实现见 get-shit-done/bin/lib/init.cjs#L563-L607字段含义来源researcher_model/synthesizer_model/roadmapper_model三类子代理的模型别名getModelAlias解析commit_docs是否提交规划文档config.commit_docsresearch_enabled是否默认开启研究config.workflow.researchcurrent_milestone/latest_completed_milestone当前与最近完成版本getMilestoneInfo/getLatestCompletedMilestonephase_dir_count当前里程碑的阶段目录数目录扫描按里程碑过滤见 bug #2445 注释phase_archive_path归档路径milestones/{version}-phases/最近完成里程碑project_exists/roadmap_exists关键文件是否存在文件系统探测agents_installed/missing_agents子代理安装状态安装探测特别值得注意phase_dir_count的语义SDK 与 CJS 两侧都按里程碑过滤阶段目录getMilestonePhaseFilter避免上一里程碑未归档的残留目录虚增计数、进而误判 fresh start注释中明确标注了 bug #2445。如果agents_installed为false工作流会显示警告并列出缺失的代理提示npx get-shit-done-cclatest --global安装然后跳过并行研究、内联生成路线图——这是一个优雅降级路径。Step 7.5--reset-phase-numbers的安全护栏仅当显式传入--reset-phase-numbers时生效将新路线图的起始阶段编号设为1若phase_dir_count 0先把旧阶段目录归档避免新01-*/02-*目录与残留里程碑目录冲突mkdir -p ${phase_archive_path} find .planning/phases -mindepth 1 -maxdepth 1 -type d -exec mv {} ${phase_archive_path}/ \;归档后需验证.planning/phases/不再包含旧目录。若phase_dir_count 0但phase_archive_path缺失即没有已完成的里程碑归档目标工作流会停止并解释重置编号在不具备归档目标时不安全需先完成/归档上一里程碑再重跑/gsd:new-milestone --reset-phase-numbers ${GSD_WS}。Step 8研究决策与四路并行研究决策分支research_enabled来自 init JSON即config.workflow.research。工作流根据默认值调整 AskUserQuestion 的选项顺序默认开启推荐 Research first (Recommended)可 Skip research for this milestone默认关闭推荐 Skip research (current default)可临时 Research first。一个关键约束被文档显式强调不要把本次选择持久化到 config.json。workflow.research是跨项目、控制plan-phase行为的持久用户偏好在这里修改会静默改变未来的/gsd:plan-phase行为要改默认值应走/gsd:settings。四路并行研究选择 Research first 后工作流建立.planning/research/目录并行派生 4 个gsd-project-researcher子代理每个代理使用统一模板含research_type、milestone_context、question、files_to_read、${AGENT_SKILLS_RESEARCHER}、downstream_consumer、quality_gate、output等占位但按维度填充不同字段维度EXISTING_CONTEXTQUESTIONCONSUMER 关注点输出文件Stack已验证能力不再重复研究新特性需要哪些栈增补/变更带版本的库、集成点、不要加什么STACK.mdFeatures已构建特性目标特性通常如何运作、期望行为表内/差异化/反特性、复杂度、依赖FEATURES.mdArchitecture既有架构目标特性如何集成到既有架构集成点、新组件、数据流变化、构建顺序ARCHITECTURE.mdPitfalls—向该领域新增这些特性的常见错误预警信号、预防策略、应由哪个阶段处理PITFALLS.md每个代理以subagent_typegsd-project-researcher、model{researcher_model}派生产物模板位于~/.claude/get-shit-done/templates/research-project/{FILE}。文档在此嵌入两条CODEX 运行时编排规则派生 4 个研究代理后不得自行读取研究文件或独立综合防止重复劳动浪费上下文必须等 4 个代理全部完成后才派生合成器合成器gsd-research-synthesizer读取四份研究文件产出SUMMARY.md并提交随后工作流展示要点摘要Stack additions / Feature table stakes / Watch Out For。Step 9定义带 REQ-ID 的规格化需求进入 DEFINING REQUIREMENTS 阶段后读取PROJECT.md的 core value、当前里程碑目标、已验证需求若$SELECTED_SEEDS非空将种子想法及其 Why This Matters 并入需求定义输入若有研究产物读取FEATURES.md并按类别呈现Table stakes / Differentiators / Research notes若无研究则通过对话收集需求What are the main things users need to do with [new features]?对每个类别用AskUserQuestionmultiSelect: trueheader 不超过 12 字符进行范围圈定选项含 None for this milestone推迟整个类别通过 AskUserQuestion 检查缺口No, research covered it / Yes, let me add some。随后生成REQUIREMENTS.md按类别分组的 v1 需求复选框 REQ-IDFuture Requirements推迟项Out of Scope显式排除及理由Traceability 章节空由路线图填充REQ-ID 格式为[CATEGORY]-[NUMBER]如AUTH-01、NOTIF-02并延续既有编号。文档给出四条需求质量准则具体可测User can reset password via email link 而非 Handle password reset、用户视角User can X 而非 System does Y、原子性一条需求一个能力、独立性需求间依赖最小。完整需求列表须向用户确认yes / adjustadjust 则回到范围圈定循环确认后提交gsd-sdk query commit docs: define milestone v[X.Y] requirements --files .planning/REQUIREMENTS.mdStep 10派生 roadmapper 生成分阶段路线图起始阶段编号--reset-phase-numbers激活 → 从Phase 1开始默认 → 延续上一里程碑的最后阶段编号v1.0 结束于 phase 5则 v1.1 从 phase 6 开始。子代理契约roadmapper 子代理gsd-roadmapper接收planning_context读取PROJECT.md、REQUIREMENTS.md、research/SUMMARY.md若存在、config.json、MILESTONES.md与 7 条明确指令尊重所选编号模式reset 或延续仅从本里程碑的需求推导阶段每条需求精确映射到一个阶段每阶段推导 2–5 条成功标准可观察的用户行为校验 100% 覆盖立即写文件ROADMAP.md、STATE.md更新REQUIREMENTS.md的可追溯性返回ROADMAP CREATED及摘要。文档同样嵌入 CODEX 编排规则派生后立即停止本任务工作等待子代理返回结果。返回处理与审批## ROADMAP BLOCKED展示阻塞点与用户协作后重新派生## ROADMAP CREATED读取并内联展示提案路线图## Proposed Roadmap **[N] phases** | **[X] requirements mapped** | All covered ✓ | # | Phase | Goal | Requirements | Success Criteria | |---|-------|------|--------------|------------------| | [N] | [Name] | [Goal] | [REQ-IDs] | [count] |并通过 AskUserQuestion 提供三选一审批Approve提交并继续、Adjust phases收集修改意见、带修订上下文重派生、循环至批准、Review full file展示原始ROADMAP.md后重新询问。批准后提交gsd-sdk query commit docs: create milestone v[X.Y] roadmap ([N] phases) --files .planning/ROADMAP.md .planning/STATE.md .planning/REQUIREMENTS.mdStep 10.5待办事项与路线图阶段的关联路线图批准后扫描待办事项并打上resolves_phase标签PENDING_TODOS$(ls .planning/todos/pending/*.md 2/dev/null | head -50)无待办则静默跳过。否则将每个待办的title/areafrontmatter 字段及正文Problem 与 Solution与各阶段的 goal、REQ-ID、描述做尽力而为的匹配文档强调不要过度匹配窄范围、具体 scope 的待办是最佳候选模糊或横切待办保持不关联。匹配成功的待办在 YAML frontmatter 中追加resolves_phase: [N]--- created: [existing] title: [existing] area: [existing] resolves_phase: [N] files: [existing] ---只修改有明确自信匹配的待办匹配后提交gsd-sdk query commit docs: tag [count] pending todos with resolves_phase after milestone v[X.Y] roadmap --files .planning/todos/pending/*.md【免费下载链接】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），仅供参考