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），僅供參考