
GDD Requirements Addressed【免費下載鏈接】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-StudiosGDD SystemRequirementHow This ADR Addresses It[system-name].md[specific rule, formula, or performance constraint from that GDD][how this decision satisfies it]--- ## 3. 階段 1–3參數校驗與變更識別 ### 3.1 校驗參數階段 1 GDD 路徑參數是**必需**的缺參直接失敗并提示 Usage: /propagate-design-change design/gdd/[system].md Provide the path to the GDD that was changed. 隨后校驗文件存在性不存在則報 [path] not found. Check the path and try again. ### 3.2 讀取當前版本與歷史版本階段 2–3 先完整讀取變更后的 GDD再通過 git 獲取上一提交版本 bash git show HEAD:design/gdd/[filename].md這里存在兩條重要分支新文件無歷史報告 No previous version in git — this appears to be a new GDD, not a revision. Nothing to propagate.——新 GDD 沒有舊假設可失效直接結束傳播存在歷史版本做概念性差異conceptual diff重點識別新增規則、刪除規則、公式修改、驗收標準變化、調優旋鈕tuning knobs變化同時標記未變化章節。差異結果整理為變更摘要其模板為## Change Summary: [GDD filename] Date of revision: [today] Changed sections: - [Section name]: [what changed — new rule, removed rule, formula modified, etc.] Unchanged sections: - [Section name] Key changes affecting architecture: - [Change 1 — likely to affect ADRs] - [Change 2]倉庫佐證這種舊版對當前版的比對邏輯與 docs/architecture/tr-registry.yaml 的修訂紀律一脈相承——需求被改寫意圖不變時保留 ID 并加revised日期需求被刪除時標記deprecated被拆分/替換時標記superseded-by。變更摘要中公式修改與調優旋鈕變化正是最可能觸發 TR-ID 狀態變更的源頭。4. 階段 4加載架構輸入讀取docs/architecture/下全部 ADR對每個 ADR完整讀取文件提取## GDD Requirements Addressed表格記錄該 ADR 引用了哪些 GDD 文檔及需求 ID。隨后讀取docs/architecture/architecture-traceability.md若存在并報告Loaded [N] ADRs. [M] reference [gdd filename].倉庫佐證可追溯性索引的定位可在 architecture-review SKILL 第 8 階段看到——該技能輸出的索引文件包含 Coverage Summary、Full Matrix、Known Gaps 以及Superseded RequirementsRequirements whose GDD was changed after the ADR was written。換句話說architecture-review負責建索引propagate-design-change負責在 GDD 變更后讓索引中過期條目被識別并處置。此外gate-check SKILL 的 Technical Setup → Pre-Production 門禁把architecture traceability index exists列為必需產物說明該索引是架構可追溯性的正式載體。5. 階段 5影響分析核心方法論對每個引用了被變更 GDD 的 ADR逐條比對GDD Requirements Addressed條目與 GDD 的變更章節定位需求該需求在當前 GDD 中是否仍然存在對比ADR 撰寫時 GDD 的說法 vs. 現在的說法評估該架構決策是否仍然成立。每個受影響 ADR 被歸入三態之一狀態含義?Still ValidGDD 變更不影響該 ADR 的決策內容??Needs ReviewGDD 變更可能影響該 ADR —— 需要人工判斷Likely SupersededGDD 變更與該 ADR 的假設直接矛盾每個受影響 ADR 產出如下影響條目含引語級證據### ADR-NNNN: [title] Status: [Still Valid / Needs Review / Likely Superseded] What the ADR assumed about this GDD: [relevant quote from the ADRs GDD Requirements Addressed section] What the GDD now says: [relevant quote from the current GDD] Assessment: [Explanation of whether the ADR decision is still valid, and why] Recommended action: [Keep as-is | Review and update | Mark Superseded and write new ADR]倉庫佐證三態分類的矛盾檢測語義與 architecture-review SKILL 第 4 階段的 Cross-ADR Conflict Detection 互補——后者檢測ADR 之間的矛盾數據所有權沖突、接口契約沖突、性能預算沖突、依賴環、模式沖突、狀態管理沖突而本技能檢測ADR 與 GDD 之間隨時間推移產生的失配。推薦動作中的 Mark Superseded and write new ADR 對應 architecture-decision SKILL 中的 ADR 狀態枚舉[Proposed | Accepted | Deprecated | Superseded by ADR-XXXX]。6. 階段 6呈現影響報告關鍵紀律在詢問任何行動之前先把完整影響報告呈現給用戶。報告格式## Design Change Impact Report GDD: [filename] Date: [today] Changes detected: [N sections changed] ADRs referencing this GDD: [M] ### Not Affected [ADRs referencing this GDD whose decisions remain valid] ### Needs Review ([count]) [ADRs that may need updating] ### Likely Superseded ([count]) [ADRs whose assumptions are now contradicted]這一先展示全貌、再征求意見的協作模式在 .claude/docs/review-workflow.md 中有制度性背書Architecture changes require sign-off fromtechnical-director——架構變更的最終確認權在技術總監而技術總監代理的協作協議.claude/agents/technical-director.md明確你是最高層的顧問但所有最終戰略決策由用戶做出因此報告必須完整、可讀、證據充分讓用戶能基于事實決策。7. 階段 6b導演門禁 TD-CHANGE-IMPACT在派生子代理之前必須先做審查模式Review Mode檢查。審查模式全局配置存放在production/review-mode.txt單行full、lean或solo由/start初始化可直接編輯文件修改每次技能運行時也可用--review [full|lean|solo]參數覆蓋僅對當次運行生效詳見 .claude/docs/director-gates.md。本技能的門禁檢查邏輯solo→ 跳過記錄 TD-CHANGE-IMPACT skipped — Solo mode.直接進入階段 7lean→ 跳過記錄 TD-CHANGE-IMPACT skipped — Lean mode.直接進入階段 7full→ 正常派生。在full模式下通過Task以門禁TD-CHANGE-IMPACT定義于 .claude/docs/director-gates.md派生technical-director子代理傳入階段 6 的完整影響報告變更摘要、全部受影響 ADR 及其三態分類、推薦動作。技術總監審查三件事影響分類是否正確是否存在被低估分類的 ADR推薦動作在架構上是否成立是否遺漏了對其他 ADR 或系統的級聯影響。裁決處理APPROVE→ 進入階段 7 解決工作流CONCERNS→ 用AskUserQuestion呈現被標記的 ADR/建議選項為Revise the impact assessment/Accept with noted concerns/Discuss furtherREJECT→ 不得進入解決階段需重新分析影響。倉庫佐證門禁的裁決格式約定在 .claude/agents/technical-director.md 的## Gate Verdict Format節當通過導演門禁被調用時如TD-CHANGE-IMPACT響應第一行必須是獨立的裁決 token[GATE-ID]: APPROVE/CONCERNS/REJECT調用方技能讀取第一行獲取裁決 token——本技能第 6b 階段的應用裁決邏輯正是消費這一約定的標準流程。此外.claude/docs/director-gates.md 定義了三種模式的含義full全量門禁適合團隊/學習型用戶、lean僅 PHASE-GATE默認適合獨立開發者、solo完全無門禁適合 Game Jam 與原型沖刺。8. 階段 7解決工作流對每個標記為 Needs Review 或 Likely Superseded 的 ADR逐個征詢用戶意見不批量決策每個 ADR 可能有不同處置ADR-NNNN ([title]) — [status]. What would you like to do? Options:Mark Superseded (Ill write a new ADR) — updates ADR status line toSuperseded by: [pending]Update in place (minor revision) — opens the ADR for editing; note what to reviseKeep as-is (the change doesnt actually affect this decision)Skip for now (revisit later)對標記為Superseded的 ADR更新其 Status 字段為Superseded by ADR-[next number] (pending — see change-impact-[date]-[system].md)詢問用戶May I update the status in [ADR filename]?倉庫佐證Superseded by ADR-[next number]的編號語義與 architecture-decision SKILL 階段 2掃描docs/architecture/確定下一個 ADR 編號一致ADR 模板中## Status節.claude/docs/templates/architecture-decision-record.md的合法值即為[Proposed | Accepted | Deprecated | Superseded by ADR-XXXX]。同時注意非破壞性原則見第 10 節協作協議絕不刪除 ADR 內容只追加 Superseded by 注記這與 TR 注冊表ID 永久、絕不刪除的哲學同源。9. 階段 8更新可追溯性索引若docs/architecture/architecture-traceability.md存在將被變更的 GDD 需求追加到 Superseded Requirements 表## Superseded Requirements | Date | GDD | Requirement | Changed To | ADRs Affected | Resolution | |------|-----|-------------|------------|---------------|------------| | [date] | [gdd] | [old requirement text] | [new requirement text] | ADR-NNNN | [Superseded/Updated/Valid] |隨后詢問May I update the traceability index?倉庫佐證該表與 architecture-review SKILL 階段 8 中索引文件的## Superseded Requirements區塊Requirements whose GDD was changed after the ADR was written完全對應——propagate-design-change負責向該表寫入新條目而architecture-review負責在后續全量審查中消費這些條目其第 5b 階段Design Revision Flags會把 GDD 中與已驗證引擎行為/已接受 ADR 沖突的假設標記為待修訂。兩者一寫一讀構成可追溯性閉環。10. 階段 9–10落盤變更影響文檔與后續行動10.1 輸出變更影響文檔階段 9詢問May I write the change impact report todocs/architecture/change-impact-[date]-[system-slug].md?文檔包含四部分內容階段 3 的變更摘要階段 5 的完整影響分析階段 7 做出的解決決策需要新寫或更新的 ADR 清單。裁決規則用戶批準寫入 → Verdict:COMPLETE— change impact report saved用戶拒絕 → Verdict:BLOCKED— user declined write。10.2 后續行動建議階段 10根據解決決策給出閉環建議被標記 Superseded 的 ADRRun/architecture-decision [title]to write the replacement ADR. Then re-run/propagate-design-changeto verify coverage.先寫替代 ADR再重跑傳播驗證覆蓋需就地更新的 ADR列出每個 ADR 需要更新的具體字段若大量 ADR 受影響Run/architecture-reviewafter all ADRs are updated to verify the full traceability matrix is still coherent.全部更新后跑架構審查驗證完整可追溯矩陣仍然自洽。倉庫佐證此處的先/architecture-decision再/architecture-review順序與 architecture-decision SKILL 階段 6 的固定提示一致——其要求在全新會話中運行/architecture-review以確保審查代理獨立于撰寫上下文避免作者偏見。此外/architecture-review的 Phase 2 會預加載 docs/architecture/tr-registry.yaml 以復用既有 TR-ID、防止跨輪次重編號這保證了后續傳播分析引用的需求 ID 穩定。11. 協作協議協作規范該技能以五條協作紀律收尾它們與倉庫整體Collaborative Design Principle一脈相承Read silently—— 先靜默計算完整影響再呈現任何內容不邊讀邊播報Show the full report first—— 先讓用戶看到影響全貌再詢問行動對應階段 6Ask per-ADR—— 逐個詢問而非批量決策對應階段 7Ask before writing—— 修改任何文件前必須先確認貫穿階段 7/8/9 的多次 May I... 詢問Non-destructive—— 絕不刪除 ADR 內容只追加 Superseded by 注記。對比可見這套協議與 architecture-review SKILL 的協作協議Read silently / Show the matrix / Dont guess / Ask before writing / Non-blocking高度同構是倉庫中審查型技能的通用行為模式。12. 在整體工作流中的位置與實戰建議12.1 技能協同關系圖/architecture-decision → 撰寫 ADR含 GDD Requirements Addressed 表 ↓ /architecture-review → 全量審查建立可追溯矩陣 Superseded Requirements 索引 ↓ GDD 被修訂 ↓ /propagate-design-change本文技能技術總監執行 ├─ 階段 5逐 ADR 三態分類 ├─ 階段 6bTD-CHANGE-IMPACT 導演門禁full 模式 ├─ 階段 7逐 ADR 處置Superseded / 就地更新 / 保留 / 暫緩 ├─ 階段 8追加 Superseded Requirements 條目 └─ 階段 9-10落盤影響文檔 建議重跑 /architecture-decision 與 /architecture-review【免費下載鏈接】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創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考