用 /content-audit 构建 GDD 到资产生成内容的完整性审计Claude Code Game Studios 内容差距表实战指南【免费下载链接】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技能测试框架中的 content-audit 技能规范 为骨架完整讲解/content-audit的内容盘点逻辑、三类判定结论COMPLETE / GAPS FOUND / MISSING CRITICAL CONTENT、差距表Gap Table的输出结构以及它如何作为只读分析型技能融入游戏制作管线。读完你可以在自己项目里按规范复现该技能的行为为其编写可自动验证的测试规范并理解它与/asset-audit、/design-system、/scope-check等相邻技能的边界。一、技能定位从 GDD 到资产的内容完整性核对在 CCGS 的体系里游戏设计文档GDD存放在design/gdd/而美术、音频、数据等实际资源存放在assets/。两者之间经常出现文档说要 4 种敌人美术只交了 3 个文件夹这样的脱节。/content-audit就是专门用来发现这类差距的只读分析技能。根据 Skill Summary 的定义该技能做三件事读取design/gdd/下的全部 GDD提取其中指定的内容项敌人、物品、关卡、音频等扫描assets/逐一核对每个内容项是否已有对应资源产出差距表Content Type → Specified Count → Found Count → Missing Items并给出最终判定。它有两个硬性行为约束不触发任何 Director 门禁Gate——它是只读分析不是阶段关卡未经用户批准不写任何文件——差距表只是呈现给人类审阅的输出写审计报告是可选项。这与框架里的资产审计 /asset-audit 形成互补/asset-audit检查资源本身是否符合命名规范、格式与体积预算合规性而/content-audit检查 GDD 声明的资源是否真的存在完整性。asset-audit 的 Coverage Notes 明确承认这种重叠是有意设计的。二、判定体系三个 Verdict 与触发条件技能只输出三种结论之一语义边界必须清晰Verdict含义典型触发场景COMPLETE所有 GDD 指定内容项均已找到无缺失、无格式问题Case 1 全量命中GAPS FOUND存在缺失内容、格式不符合要求或无法确认完整性Case 2 / Case 3 / Case 4 / Case 5MISSING CRITICAL CONTENT缺失项在 GDD 中被标记为critical等级覆盖说明中描述的扩展路径值得注意的细节是GAPS FOUND并不只对应资源缺失。在 Case 4资源格式错误 中即使文件按名字找到了Found Count 2只要格式不符合 GDD 或technical-preferences.md的要求例如需要 OGG 却给了 WAV同样判定为GAPS FOUND——因为格式合规本身就是内容完整性的一部分。差距表中格式问题与缺失内容必须分开展示例如jump.wav会被标记为FORMAT ISSUE并注明期望格式OGG。关于MISSING CRITICAL CONTENTCoverage Notes 说明当缺失项在 GDD 中被标记为 critical 时触发且复用与GAPS FOUND相同的检测路径即同一个扫描流程只是最终判定升级。另外还有一个未被测试覆盖的边界如果assets/目录本身不存在技能应对所有指定内容项输出MISSING CRITICAL CONTENT。三、差距表Gap Table输出规范差距表是/content-audit的核心交付物。协议的列结构固定为四列Content TypeSpecified CountFound CountMissing ItemsEnemies43BossItems33无Audio (OGG)22无但 jump.wav 为 FORMAT ISSUEProtocol Compliance 对差距表提出三点硬性要求必须覆盖 GDD 中找到的所有内容类型不能漏行每一行必须同时展示 Specified Count 和 Found Count当计数相等无缺失时不得虚构缺失项该行显示无缺失即可。从源码结构看这个表格由 Agent 在执行扫描后即时生成并呈现给用户不落盘。框架的技能测试规范模板 要求每个技能以呈现发现 → 请求批准 → 推荐下一步的顺序收尾/content-audit正是按这个模板落地的先给出差距表再询问是否需要写入审计报告。四、五个测试用例行为规格即验收标准技能规范用五个测试用例把行为钉死它们同时就是技能的验收标准。每个用例都包含 Fixture假定项目状态、Expected behavior预期行为和 Assertions断言清单三部分符合 skill-test-spec 模板 的写法。Case 1Happy Path —— 全部内容就位Fixturedesign/gdd/enemies.md指定 4 种敌人Grunt / Sniper / Tank / Bossassets/art/characters/下 4 个文件夹齐全design/gdd/items.md指定 3 种物品且全部在assets/data/items/中找到。预期读取所有 GDD → 扫描assets/→ 差距表所有行 Found Count Specified Count → 判定COMPLETE且不写任何文件。Case 2Gaps Found —— 敌人类型缺失FixtureGDD 声明 Grunt / Sniper / Boss 三种敌人但assets/art/characters/只有grunt/和sniper/。预期差距表敌人行显示 Specified 3 / Found 2 / Missing: Boss判定GAPS FOUND。关键断言技能不会假设资源稍后会被补上而是当下立即标记缺失——这是它作为早期预警工具的核心原则。Case 3无内容规格 —— 给出手引导Fixturedesign/gdd/只有core-loop.md且不含内容清单content inventory章节。预期技能输出固定提示No content specifications found in GDDs — run /design-system first to define content lists不产出差距表判定仍为GAPS FOUND因为缺少规格就意味着无法确认完整性。这展示了技能的优雅降级没有规格时不硬造表格而是给出明确的下一步行动建议。Case 4格式边界 —— 资产格式不符Fixturedesign/gdd/audio.md指定 OGGtechnical-preferences.md同样指定 OGGassets/audio/sfx/下jump.wavWAV与land.oggOGG并存。预期技能同时读取 GDD 音频规格与technical-preferences.md的格式要求jump.wav被标记FORMAT ISSUE期望 OGG差距表仍显示 Specified 2 / Found 2按名字计数但格式问题单独列出判定GAPS FOUND。Case 5门禁合规 —— 只读不写FixtureGDD 指定 10 个内容项找到 9 个缺失 1 个review-mode.txt内容为full。预期无论处于何种 review mode都不触发 Director 门禁差距表以只读形式呈现可选地请求写入审计报告May I write...但绝不自动写文件、绝不修改任何资产文件。五、静态断言与 /skill-test static 的配合技能规范第一段就是 Static Assertions (Structural)这些断言由/skill-test static自动验证无需任何 fixture具备必需的 frontmatter 字段name、description、argument-hint、user-invocable、allowed-tools至少有 2 个阶段标题phase headings包含三个判定关键字COMPLETE、GAPS FOUND、MISSING CRITICAL CONTENT不要求 May I write 语言因为是只读输出写报告是可选项结尾有下一步交接next-step handoff即差距表审阅后的建议动作。这组断言与框架通用模板templates/skill-test-spec.md中写权限技能必须有 May I write 语言、只读技能跳过的规则完全一致说明/content-audit在目录结构、frontmatter 和协议层面都遵循统一的技能工程化规范。六、在项目管线中的实际用法工作流指南 Step 5.3Content Tracking 把/content-audit放在了 Production 阶段的内容追踪环节/content-audit其作用被概括为Compares GDD-specified content against what has been implemented. Catches content gaps early——即在开发早期发现设计说要有、实际没做的内容缺口。技能流程图 进一步展示了它在 Production 迭代循环中的位置与/code-review代码评审报告、/scope-check范围蔓延检测、/bug-report、/bug-triage并列为开发实现期间按需调用的分析型技能输出为 GDD content gaps identifiedGDD 内容差距识别。也就是说它服务于设计文档 ↔ 实际交付物的闭环校验而不是阶段之间的门禁控制。与它相邻的技能边界如下/content-audit完整性GDD 声明了哪些内容、资产里有没有/asset-audit合规性已有资产是否满足命名、格式、体积预算/design-system规格来源当 GDD 缺少内容清单时先运行它来定义内容列表见 Case 3/scope-check范围控制核对当前范围是否超出原始计划。七、总结内容完整性的可测试保障/content-audit的价值在于把文档与资源是否对齐这个模糊的质量问题转化为一张可读、可判定的差距表并用三个 verdict 给出明确结论。它的设计原则可以提炼为只读优先审计结果先给人看写报告必须征求同意无门禁不参与阶段控制专注信息供给规格缺席也要有输出没有内容清单时给引导运行/design-system而不是沉默或造假格式合规算完整性文件在但格式不对同样算差距。同时框架把该技能的验收标准显式写成测试用例content-audit.md 的全部五个 Case可配合/skill-test自动验证使得技能本身是否达标也成为可回归检查的工程问题。任何希望在 AI 游戏开发管线中做设计到资产自动对账的团队都可以直接照搬这套规范来落地自己的内容审计技能。【免费下载链接】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），仅供参考