用 /content-audit 构建 GDD 到资产生成内容的完整性审计：Claude Code Game Studios 内容差距表实战指南-二趣网

用 /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 Studios（CCGS）技能测试框架中的 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 5
`MISSING 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 CONTENT，Coverage Notes 说明：当缺失项在 GDD 中被标记为 critical 时触发，且复用与GAPS FOUND相同的检测路径（即同一个扫描流程，只是最终判定升级）。另外还有一个未被测试覆盖的边界：如果assets/目录本身不存在，技能应对所有指定内容项输出MISSING CRITICAL CONTENT。

三、差距表（Gap Table）输出规范

差距表是/content-audit的核心交付物。协议的列结构固定为四列：

Content Type	Specified Count	Found Count	Missing Items
Enemies	4	3	Boss
Items	3	3	（无）
Audio (OGG)	2	2	（无，但 jump.wav 为 FORMAT ISSUE）

Protocol Compliance 对差距表提出三点硬性要求：

必须覆盖 GDD 中找到的所有内容类型，不能漏行；
每一行必须同时展示 Specified Count 和 Found Count；
当计数相等（无缺失）时，不得虚构"缺失项"，该行显示无缺失即可。

从源码结构看，这个表格由 Agent 在执行扫描后即时生成并呈现给用户，不落盘。框架的技能测试规范模板要求每个技能以"呈现发现 → 请求批准 → 推荐下一步"的顺序收尾，/content-audit正是按这个模板落地的：先给出差距表，再询问是否需要写入审计报告。

四、五个测试用例：行为规格即验收标准

技能规范用五个测试用例把行为钉死，它们同时就是技能的验收标准。每个用例都包含 Fixture（假定项目状态）、Expected behavior（预期行为）和 Assertions（断言清单）三部分，符合 skill-test-spec 模板的写法。

Case 1：Happy Path —— 全部内容就位

Fixture：design/gdd/enemies.md指定 4 种敌人（Grunt / Sniper / Tank / Boss），assets/art/characters/下 4 个文件夹齐全；design/gdd/items.md指定 3 种物品且全部在assets/data/items/中找到。
预期：读取所有 GDD → 扫描assets/→ 差距表所有行 Found Count = Specified Count → 判定COMPLETE，且不写任何文件。

Case 2：Gaps Found —— 敌人类型缺失

Fixture：GDD 声明 Grunt / Sniper / Boss 三种敌人，但assets/art/characters/只有grunt/和sniper/。
预期：差距表敌人行显示 Specified 3 / Found 2 / Missing: Boss；判定GAPS FOUND。
关键断言：技能不会假设资源"稍后会被补上"，而是当下立即标记缺失——这是它作为"早期预警"工具的核心原则。

Case 3：无内容规格 —— 给出手引导

Fixture：design/gdd/只有core-loop.md，且不含内容清单（content inventory）章节。
预期：技能输出固定提示："No content specifications found in GDDs — run /design-system first to define content lists"；不产出差距表；判定仍为GAPS FOUND（因为缺少规格就意味着无法确认完整性）。
这展示了技能的优雅降级：没有规格时不硬造表格，而是给出明确的下一步行动建议。

Case 4：格式边界 —— 资产格式不符

Fixture：design/gdd/audio.md指定 OGG，technical-preferences.md同样指定 OGG；assets/audio/sfx/下jump.wav（WAV）与land.ogg（OGG）并存。
预期：技能同时读取 GDD 音频规格与technical-preferences.md的格式要求；jump.wav被标记FORMAT ISSUE（期望 OGG）；差距表仍显示 Specified 2 / Found 2（按名字计数），但格式问题单独列出；判定GAPS FOUND。

Case 5：门禁合规 —— 只读不写

Fixture：GDD 指定 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.3：Content 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 identified"（GDD 内容差距识别）。也就是说，它服务于"设计文档 ↔ 实际交付物"的闭环校验，而不是阶段之间的门禁控制。

与它相邻的技能边界如下：

/content-audit（完整性）：GDD 声明了哪些内容、资产里有没有；
/asset-audit（合规性）：已有资产是否满足命名、格式、体积预算；
/design-system（规格来源）：当 GDD 缺少内容清单时，先运行它来定义内容列表（见 Case 3）；
/scope-check（范围控制）：核对当前范围是否超出原始计划。

七、总结：内容完整性的可测试保障

/content-audit的价值在于把"文档与资源是否对齐"这个模糊的质量问题，转化为一张可读、可判定的差距表，并用三个 verdict 给出明确结论。它的设计原则可以提炼为：

只读优先：审计结果先给人看，写报告必须征求同意；
无门禁：不参与阶段控制，专注信息供给；
规格缺席也要有输出：没有内容清单时给引导（运行/design-system），而不是沉默或造假；
格式合规算完整性：文件在但格式不对，同样算差距。

同时，框架把该技能的验收标准显式写成测试用例（content-audit.md 的全部五个 Case），可配合/skill-test自动验证，使得"技能本身是否达标"也成为可回归检查的工程问题。任何希望在 AI 游戏开发管线中做"设计到资产"自动对账的团队，都可以直接照搬这套规范来落地自己的内容审计技能。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析