:從 sprint-plan 模板到 /sprint-plan 自動化流水線)
Claude Code Game Studios 沖刺計劃實戰(zhàn)從 sprint-plan 模板到 /sprint-plan 自動化流水線【免費下載鏈接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.項目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios導讀本指南圍繞 Claude Code Game StudiosCCGS倉庫中的沖刺計劃模板 .claude/docs/templates/sprint-plan.md 展開它是整個項目里程碑 → 沖刺 → 故事生產(chǎn)流水線的核心產(chǎn)出物規(guī)范。你將掌握如何逐字段填寫一份可執(zhí)行的沖刺計劃含容量緩沖、三層任務優(yōu)先級、驗收標準、完成定義以及該模板如何被/sprint-plan技能消費——從讀取里程碑與積壓故事、按實現(xiàn)層與優(yōu)先級排序生成沖刺草稿、經(jīng) Producer 可行性門禁PR-SPRINT審查到落地為sprint-status.yaml機器可讀狀態(tài)源的全過程。讀完即可在自己的游戲項目中照搬這套模板 技能 門禁的沖刺管理閉環(huán)。一、模板在 CCGS 生產(chǎn)體系中的定位CCGS 將單個 Claude Code 會話組織成一座完整的游戲開發(fā)工作室49 個 Agent、72 個技能、11 條規(guī)則與 39 份文檔模板。生產(chǎn)節(jié)奏由三層文檔驅(qū)動里程碑Milestone—— 定義階段性目標、成功標準、質(zhì)量門檻見 .claude/docs/templates/milestone-definition.md沖刺Sprint—— 本指南的主角把里程碑切成若干 1~2 周的交付窗口模板見 .claude/docs/templates/sprint-plan.md故事Story—— 由/create-stories從史詩Epic拆解出的最小可交付單元經(jīng)/story-readiness校驗后才允許進入沖刺。沖刺計劃模板的完整表單正是/sprint-plan技能.claude/skills/sprint-plan/SKILL.md的產(chǎn)出格式。技能負責怎么生成模板負責生成什么樣子兩者互為表里。而模板中的 Daily Status Tracking 表格又為只讀的/sprint-status技能.claude/skills/sprint-status/SKILL.md提供了沖刺健康度評估的輸入。二、模板逐節(jié)拆解字段含義與填寫規(guī)范2.1 頭部與 Sprint Goal# Sprint [N] -- [Start Date] to [End Date] ## Sprint Goal [One sentence: what does this sprint achieve toward the current milestone?]標題編號[N]使用連續(xù)遞增的沖刺序號如sprint-003與production/sprints/目錄下已存在文件的下一個序號對齊。/sprint-plan技能通過列出該目錄自動確定下一個編號。Sprint Goal 一句話原則目標必須回答本沖刺對當前里程碑貢獻了什么禁止寫成任務清單。好的例子完成戰(zhàn)斗系統(tǒng)的核心邏輯層使垂直切片可玩壞的例子實現(xiàn) 12 個故事。2.2 Milestone Context把沖刺掛回里程碑字段填寫內(nèi)容Current Milestone當前里程碑名稱對應production/milestones/milestone-0N.mdMilestone Deadline里程碑截止日期取自里程碑定義文件Sprints Remaining距里程碑還有幾個沖刺用于倒推每沖刺必須交付的容量該節(jié)讓沖刺計劃天然具備向上對齊能力任何讀者人或 Agent都能立刻判斷當前沖刺與里程碑總體進度的關系。/sprint-plan技能在 Phase 1 會先讀當前里程碑文件從production/milestones/讀取容量與目標這正是該節(jié)的生成來源。2.3 Capacity20% 緩沖的容量預算表ResourceAvailable DaysAllocatedBuffer (20%)RemainingProgrammingDesignArtAudioQATotal關鍵約束每個資源行都預留 20% 緩沖用于吸收計劃外工作Bug 修復、評審反饋、臨時需求。技能在生成沖刺時會計算Available Allocated ? Buffer(20%)并以此容量為上限挑選故事。若選入的故事點數(shù)超過容量如技能測試規(guī)格 Case 3 中 8 個故事共 16 點 vs 里程碑容量 10 點PR-SPRINT 門禁會返回 CONCERNS/UNREALISTIC要求削減故事。2.4 Tasks三層優(yōu)先級與任務 ID 編碼模板將任務按 MoSCoW 思想分三層每層獨立成表### Must Have (Critical Path) | ID | Task | Agent/Owner | Est. Days | Dependencies | Acceptance Criteria | Status | |----|------|-------------|-----------|-------------|-------------------|--------| | S[N]-001 | | | | None | | Not Started | | S[N]-002 | | | | S[N]-001 | | Not Started | ### Should Have | ID | Task | Agent/Owner | Est. Days | Dependencies | Acceptance Criteria | Status | |----|------|-------------|-----------|-------------|-------------------|--------| | S[N]-010 | | | | | | Not Started | ### Nice to Have (Cut First) | ID | Task | Agent/Owner | Est. Days | Dependencies | Acceptance Criteria | Status | |----|------|-------------|-----------|-------------|-------------------|--------| | S[N]-020 | | | | | | Not Started |三層語義與填寫規(guī)則Must Have (Critical Path)沖刺失敗即里程碑風險的任務編號S[N]-001起。Dependencies 列必須顯式聲明任務間依賴示例中S[N]-002依賴S[N]-001供門禁審查故事是否按依賴正確排序以及是否存在會中途阻塞沖刺的隱藏依賴。Should Have計劃內(nèi)但可切的任務編號S[N]-010起。當 Must Have 提前完成時團隊從此層拉取任務。Nice to Have (Cut First)明確標注首先被砍編號S[N]-020起。它存在的意義是讓削減成為預決策而非危機決策。字段規(guī)范ID 編碼S[N]-XXX三段式——S 沖刺序號 三位流水號區(qū)間段暗示優(yōu)先級0xx/1xx/2xx。Acceptance Criteria每條必須可驗證可測試、可觀察這是 QL-STORY-READY 門禁.claude/docs/director-gates.md審查的重點——過模糊的標準會被要求修訂后才能進沖刺。Status初始均為Not Started沖刺進行中由/story-done、/sprint-status驅(qū)動流轉(zhuǎn)In Progress/Blocked/Done等。2.5 Carryover from Sprint [N-1]Original IDTaskReason for CarryoverNew EstimatePriority Change上一沖刺未完成的故事必須顯式結(jié)轉(zhuǎn)而不是悄悄消失。填寫三要素原任務 ID保持可追溯、結(jié)轉(zhuǎn)原因未完成原因超估、阻塞、范圍膨脹、新估算往往需要上調(diào)。Priority Change 列記錄優(yōu)先級是否因結(jié)轉(zhuǎn)而變化如從 Should Have 提升為 Must Have。這與/sprint-plan技能的測試規(guī)格CCGS Skill Testing Framework/skills/sprint/sprint-plan.md中的 Case 5 完全對應技能會檢查最近一個沖刺文件中仍為In Progress的故事提示 Sprint 002 has 2 open stories — confirm carry-over before planning sprint 003由用戶選擇結(jié)轉(zhuǎn) / 延后 / 取消結(jié)轉(zhuǎn)的故事會以[CARRY]標簽前置到新沖刺草稿中。2.6 Risks to This Sprint 與 External Dependencies## Risks to This Sprint | Risk | Probability | Impact | Mitigation | Owner | |------|------------|--------|-----------|-------| ## External Dependencies | Dependency | Status | Impact if Delayed | Contingency | |-----------|--------|------------------|-------------|風險四要素概率低/中/高、影響低/中/高、緩解措施必須具體到動作、負責人落實到人否則緩解措施形同虛設。外部依賴引擎插件授權、外包資產(chǎn)、第三方服務等非團隊可控項。Impact if Delayed量化延誤后果Contingency預置備選方案換方案 / 降級范圍 / 提前下單。技能在 Phase 1 會同步檢查風險登記冊production/risk-register/把已知風險自動帶入沖刺計劃。2.7 Definition of Done沖刺驗收清單- [ ] All Must Have tasks completed and passing acceptance criteria - [ ] No S1 or S2 bugs in delivered features - [ ] Code reviewed and merged to develop - [ ] Design documents updated for any deviations from spec - [ ] Test cases written and executed for all new features - [ ] Asset naming and format standards met完成定義DoD是每個沖刺都必須滿足的硬門檻而非盡量。技能生成的沖刺計劃在此清單上還會追加項目級條目QA 計劃存在production/qa/qa-plan-sprint-[N].md、Logic/Integration 類故事有通過的單測/集成測試、冒煙測試通過/smoke-check sprint、QA 簽字報告 APPROVED/team-qa sprint等見 .claude/skills/sprint-plan/SKILL.md。DoD 的另一作用它是/sprint-status判定沖刺是否整體完成的依據(jù)——當所有故事 Complete 時技能會輸出 ON TRACK / SPRINT COMPLETE 并建議運行/milestone-review或/sprint-plan。2.8 Daily Status TrackingDayTasks CompletedTasks In ProgressBlockersNotesDay 1Day 2Day 3按沖刺自然日逐行更新。這張表是沖刺進行中的活文檔為兩個下游消費者提供數(shù)據(jù)/sprint-status技能據(jù)此計算時間消耗百分比days elapsed / total sprint days與完成百分比對比得出 burndown 結(jié)論沖刺結(jié)束后的/retrospective.claude/skills/retrospective/SKILL.md需要逐日數(shù)據(jù)來復盤阻塞模式。三、模板如何被 /sprint-plan 技能驅(qū)動端到端流水線模板是靜態(tài)表單真正讓它運轉(zhuǎn)的是/sprint-plan技能.claude/skills/sprint-plan/SKILL.md。技能完整定義了六個階段階段動作關鍵約束Phase 0: Parse Arguments解析new/update/status三種模式解析--review full|lean|solo缺省讀production/review-mode.txt再缺省默認leanreview mode 一次解析、全程生效Phase 1: Gather Context讀里程碑production/milestones/、上一沖刺production/sprints/、設計文檔design/gdd/中標記可實現(xiàn)的特性、風險登記冊production/risk-register/上下文驅(qū)動生成Phase 2: Generate Outputnew模式生成上節(jié)模板格式的沖刺計劃并先展示給用戶status模式生成狀態(tài)報告展示草稿 ≠ 請求寫入門禁在寫入前Phase 3: Write Sprint Status File詢問 May I also writeproduction/sprint-status.yaml? 后將任務表映射為機器可讀 YAML初始化狀態(tài)映射Must Have→ready-for-devShould/Nice→backlogPhase 4: Producer Feasibility Gate按 review mode 決定是否 spawnproducergatePR-SPRINT處理 UNREALISTIC/CONCERNS 后詢問 May I write this sprint plan toproduction/sprints/sprint-[N].md?full模式必跑門禁lean/solo跳過但跳過門禁 ≠ 跳過用戶批準Phase 5: QA Plan Gate用 Glob 查production/qa/qa-plan-sprint-[N].md缺失時通過AskUserQuestion讓用戶選立即運行/qa-plan sprint或跳過并加警告塊無 QA 計劃則 Production→Polish 門禁必堵Phase 6: Next Steps輸出后續(xù)命令建議見下節(jié)兩個最重要的設計先展示、再門禁、后詢問的寫保護鏈。技能 Phase 2 明確要求生成草稿后Do NOT ask to write yet門禁可能要求修訂后才允許寫入Phase 4 又要求無論門禁結(jié)果如何最終都必須顯式詢問 May I write...。這是 CCGS 技能協(xié)議的通用紀律見 CCGS Skill Testing Framework/skills/sprint/sprint-plan.md 的 Protocol Compliance 清單。sprint-status.yaml是狀態(tài)源Phase 3。技能同時產(chǎn)出 Markdown 計劃給人讀與 YAML 狀態(tài)給技能讀格式如下# Auto-generated by /sprint-plan. Updated by /story-done. # DO NOT edit manually — use /story-done to update story status. sprint: [N] goal: [sprint goal] start: [YYYY-MM-DD] end: [YYYY-MM-DD] generated: [YYYY-MM-DD] updated: [YYYY-MM-DD] stories: - id: [epic-story, e.g. 1-1] name: [story name] file: [production/stories/path.md] priority: must-have # must-have | should-have | nice-to-have status: ready-for-dev # backlog | ready-for-dev | in-progress | review | done | blocked owner: estimate_days: 0 blocker: completed: /sprint-status、/story-done、/help均直接讀取該 YAML 而無需解析 Markdown避免了文本解析的脆弱性。四、PR-SPRINT 門禁與三種 Review Mode模板中的容量表、依賴列、風險表之所以必須規(guī)范填寫是因為它們正是PR-SPRINT 門禁Producer Sprint Feasibility Review定義于 .claude/docs/director-gates.md的審查輸入。門禁要求傳入候選故事清單標題、估算、依賴、團隊容量小時/人日、上沖刺遺留債務、里程碑約束。Producer 審查四個問題并返回三檔結(jié)論審查問題對應模板字段故事負載對可用容量是否現(xiàn)實Capacity 表 任務表 Est. Days故事是否按依賴正確排序Dependencies 列是否存在會中途阻塞沖刺的隱藏依賴Dependencies External Dependencies是否有故事因其技術復雜度而被低估Est. Days 風險表結(jié)論含義技能處置REALISTIC計劃可達成繼續(xù)走寫入流程CONCERNS [具體風險]有問題但不阻塞呈現(xiàn)給用戶由用戶決定是否調(diào)整UNREALISTIC必須削減范圍技能主動修訂把故事延后到 Should Have / Nice to Have再請求寫入批準是否觸發(fā)門禁取決于 review mode.claude/docs/director-gates.md模式行為適用場景full所有門禁激活沖刺草稿后必跑 PR-SPRINT團隊 / 學習型用戶 / 需要逐步導演反饋lean僅跑 PHASE-GATE/gate-check技能級門禁跳過輸出 PR-SPRINT skipped — Lean mode默認獨立開發(fā)者與小團隊solo所有門禁跳過輸出 PR-SPRINT skipped — Solo modeGame Jam、原型、追求最大速度模式的優(yōu)先級鏈--review參數(shù) production/review-mode.txt/start時寫入可隨時手改 默認lean。注意 .claude/docs/director-gates.md 中默認值是lean而技能 Phase 0 也以lean兜底兩者一致。五、與 /sprint-status 閉環(huán)模板驅(qū)動的沖刺健康度監(jiān)控沖刺計劃模板寫好之后進行中的監(jiān)控由/sprint-status技能.claude/skills/sprint-status/SKILL.md承擔。它是 Haiku 級只讀技能絕不寫文件、絕不觸發(fā)門禁單次輸出控制在 30 行以內(nèi)。其數(shù)據(jù)來源正是模板定位沖刺從production/sprints/中取最近修改的文件或按參數(shù)指定沖刺號讀取狀態(tài)優(yōu)先讀sprint-status.yaml無則回退掃描 Markdown 中的狀態(tài)標記DONE/COMPLETE/IN PROGRESS/BLOCKED/NOT STARTED并輸出降級提示Burndown 評估.claude/skills/sprint-status/SKILL.md完成百分比與時間消耗百分比對比——On Track完成 % 不落后時間 % 超過 10 個點At Risk落后 10~25 點Behind落后超過 25 點Stale 檢測對In Progress故事檢查Last Updated字段超過 2 天無更新即標記 STALE且強制將 burndown 結(jié)論升級為 At Risk即使完成率正常輸出健康度三檔結(jié)論 ON TRACK / AT RISK / BLOCKED 唯一一條行動建議。模板中的 Daily Status Tracking 表因此不是裝飾它保證了時間消耗可計算也保證了阻斷故事Blockers 列能被/sprint-status具名上報。技能測試規(guī)格中的 Case 1 驗證的正是這條鏈路檢測到 Blocked 故事 臨近截止 → 輸出 AT RISK 并具名 blockerCCGS Skill Testing Framework/skills/sprint/sprint-plan.md。六、技能測試規(guī)格模板與流水線的可驗證性沖刺流水線并非不可驗證的黑盒。倉庫自帶的技能測試框架 CCGS Skill Testing Framework/skills/sprint/sprint-plan.md 用 5 個用例覆蓋了模板使用與門禁行為的全部關鍵路徑用例場景驗證要點Case 1正常路徑有積壓故事生成沖刺按實現(xiàn)層優(yōu)先、優(yōu)先級次之排序草稿先展示full 模式跑 PR-SPRINT寫前必問 May I write寫入路徑為production/sprints/sprint-003.md結(jié)論 COMPLETECase 2阻塞路徑積壓為空輸出 No unstarted stories in backlog建議/create-stories不跑門禁、不寫文件結(jié)論 BLOCKEDCase 3門禁返回 CONCERNS沖刺超載8 故事 16 點 vs 容量 10 點用戶選 3 個延后修訂版而非原稿被寫入結(jié)論 COMPLETECase 4Lean 模式PR-SPRINT 跳過并顯式標注仍需用戶批準才寫文件Case 5上一沖刺仍有未完成故事檢測 sprint-002 的 2 個 In Progress 故事用戶確認后以[CARRY]標簽前置結(jié)轉(zhuǎn)這 5 個用例同時構成模板字段的需求規(guī)格Capacity 決定了 Case 3 的超載判定Dependencies 決定了 Case 1 的排序斷言Carryover 表格驅(qū)動 Case 5 的標簽行為——模板的每一節(jié)都能在測試中找到對應斷言。七、落地建議把模板接入你的項目初始化運行/start完成環(huán)境設置確認production/review-mode.txt寫入你想要的 review mode獨立開發(fā)建議保留默認lean。先有里程碑用 .claude/docs/templates/milestone-definition.md 定義里程碑容量、截止日期、成功標準沖刺計劃才能引用它。生成沖刺執(zhí)行/sprint-plan或/sprint-plan --review full強制本輪全量門禁。技能會自動讀取里程碑與積壓、生成模板格式草稿、走完門禁與 QA 計劃檢查后寫入production/sprints/sprint-NNN.md與production/sprint-status.yaml。逐日維護Daily Status Tracking 表隨/sprint-status對照核驗故事狀態(tài)變更一律走/story-done不要手改 YAML文件頭明確標注 DO NOT edit manually。結(jié)束時跑/sprint-plan update做中程調(diào)整或直接進入/milestone-review與/retrospective收尾。適用前提說明以上目錄production/sprints/、production/milestones/、production/review-mode.txt等是 CCGS 項目約定由技能自動創(chuàng)建并維護的生產(chǎn)文檔路徑當前倉庫僅保留production/session-state/示例骨架實際使用時由/start與各技能按需生成。模板中的 ID 命名S[N]-XXX、狀態(tài)枚舉Not Started等與 YAML 狀態(tài)字面量均為技能協(xié)議的約定值手動改造前請先閱讀 .claude/skills/sprint-plan/SKILL.md 與 .claude/docs/director-gates.md 確認兼容性。【免費下載鏈接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.項目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考