尧图网站建设 
Technical Debt Register【免费下载链接】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-StudiosLast updated: [Date] Total items: [N] | Estimated total effort: [T-shirt sizes summed]IDCategoryDescriptionFilesEffortImpactPriorityAddedSprintTD-001[Cat][Description][files][S/M/L/XL][Low/Med/High/Critical][Score][Date][Sprint to fix or Backlog]字段语义 - **ID** —— 形如 TD-001 的自增编号保证每条债务可被唯一引用例如冲刺计划、验收报告里直接引用 TD-003 - **Effort** —— T-shirt 尺寸 **S/M/L/XL**用于汇总总工作量 - **Impact** —— 影响等级 **Low / Med / High / Critical**其中 Critical 条目在 scan 展示时必须置顶见第三节 - **Priority** —— 由第五节公式算出的分数 - **Sprint** —— 计划修复的冲刺编号或 Backlog积压。 ### 四条维护规则 原技能文档在末尾给出了四条不可违背的规则这是整套治理哲学的核心 1. **技术债务本身并不坏——它是一种工具。** 登记表跟踪的是「有意识的决策」conscious decisions而不是对团队失误的追责。债务被接受是因为在 deadline、prototype 或信息缺失面前它是当时理性的选择 2. **每条债务条目都必须解释 WHY 被接受** —— 是 deadline 压力、原型阶段、还是缺失信息导致。没有理由的债务无法被审阅和辩护 3. **scan 至少每冲刺运行一次** —— 及时捕获新增债务防止债务在无人知晓的情况下悄悄累积 4. **超过 3 个 sprint 未处理的条目**要么修复要么**有记录地主动接受**consciously accepted with a documented reason。这与 report 模式的 3-sprint 标记规则互为表里。 ### 已解决条目的处理保留审计历史 测试规范 Case 3 规定了一个容易被忽略的细节当登记表中的某条目引用的源文件已不存在例如 src/gameplay/legacy_input.gd 被重构删除时技能会将该条目标记为 **RESOLVED**且 - 必须**先向用户确认**再写入 - RESOLVED 条目**保留在登记表中而不是删除**以保留完整的审计历史audit history。 这意味着登记表既是待办清单也是债务的完整生命周期档案。 ## 八、在研发管线中的集成位置 /tech-debt 不是孤立工具它在 CCGS 工作流中有三个明确的挂载点见 [WORKFLOW-GUIDE.md](https://link.gitcode.com/i/d7442bc425a6af861722caf1852fa362) ### 1. 故事验收时自动登记Phase 5 /story-done 的 8 阶段完成评审中第 4 步检查 GDD/ADR 偏差、第 6 步生成完成报告COMPLETE / COMPLETE WITH NOTES / BLOCKED。工作流指南明确写道**评审中发现的技术债务记录到 docs/tech-debt-register.md**[WORKFLOW-GUIDE.md](https://link.gitcode.com/i/d7442bc425a6af861722caf1852fa362#L801)。也就是说债务登记是与故事验收天然耦合的——每完成一个故事顺带把新欠的债记上账。 ### 2. 打磨阶段的管线一环Phase 6 Phase 6打磨阶段的管线包含/perf-profile -- /balance-check -- /asset-audit -- /playtest-report (x3) ... ... /tech-debt -- /team-polish【免费下载链接】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），仅供参考 Technical Debt Register
Technical Debt Register【免费下载链接】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-StudiosLast updated: [Date] Total items: [N] | Estimated total effort: [T-shirt sizes summed]IDCategoryDescriptionFilesEffortImpactPriorityAddedSprintTD-001[Cat][Description][files][S/M/L/XL][Low/Med/High/Critical][Score][Date][Sprint to fix or Backlog]字段语义 - **ID** —— 形如 TD-001 的自增编号保证每条债务可被唯一引用例如冲刺计划、验收报告里直接引用 TD-003 - **Effort** —— T-shirt 尺寸 **S/M/L/XL**用于汇总总工作量 - **Impact** —— 影响等级 **Low / Med / High / Critical**其中 Critical 条目在 scan 展示时必须置顶见第三节 - **Priority** —— 由第五节公式算出的分数 - **Sprint** —— 计划修复的冲刺编号或 Backlog积压。 ### 四条维护规则 原技能文档在末尾给出了四条不可违背的规则这是整套治理哲学的核心 1. **技术债务本身并不坏——它是一种工具。** 登记表跟踪的是「有意识的决策」conscious decisions而不是对团队失误的追责。债务被接受是因为在 deadline、prototype 或信息缺失面前它是当时理性的选择 2. **每条债务条目都必须解释 WHY 被接受** —— 是 deadline 压力、原型阶段、还是缺失信息导致。没有理由的债务无法被审阅和辩护 3. **scan 至少每冲刺运行一次** —— 及时捕获新增债务防止债务在无人知晓的情况下悄悄累积 4. **超过 3 个 sprint 未处理的条目**要么修复要么**有记录地主动接受**consciously accepted with a documented reason。这与 report 模式的 3-sprint 标记规则互为表里。 ### 已解决条目的处理保留审计历史 测试规范 Case 3 规定了一个容易被忽略的细节当登记表中的某条目引用的源文件已不存在例如 src/gameplay/legacy_input.gd 被重构删除时技能会将该条目标记为 **RESOLVED**且 - 必须**先向用户确认**再写入 - RESOLVED 条目**保留在登记表中而不是删除**以保留完整的审计历史audit history。 这意味着登记表既是待办清单也是债务的完整生命周期档案。 ## 八、在研发管线中的集成位置 /tech-debt 不是孤立工具它在 CCGS 工作流中有三个明确的挂载点见 [WORKFLOW-GUIDE.md](https://link.gitcode.com/i/d7442bc425a6af861722caf1852fa362) ### 1. 故事验收时自动登记Phase 5 /story-done 的 8 阶段完成评审中第 4 步检查 GDD/ADR 偏差、第 6 步生成完成报告COMPLETE / COMPLETE WITH NOTES / BLOCKED。工作流指南明确写道**评审中发现的技术债务记录到 docs/tech-debt-register.md**[WORKFLOW-GUIDE.md](https://link.gitcode.com/i/d7442bc425a6af861722caf1852fa362#L801)。也就是说债务登记是与故事验收天然耦合的——每完成一个故事顺带把新欠的债记上账。 ### 2. 打磨阶段的管线一环Phase 6 Phase 6打磨阶段的管线包含/perf-profile -- /balance-check -- /asset-audit -- /playtest-report (x3) ... ... /tech-debt -- /team-polish【免费下载链接】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），仅供参考