Claude-Code-Game-Studios 回归覆盖审计技能 /regression-suiteAC 到测试的映射协议、三态判定与规格化测试全解【免费下载链接】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本指南围绕 CCGSClaude-Code-Game-StudiosQA 工具链中的/regression-suite技能及其行为规格展开它把当前 Sprint 故事文件里的验收标准Acceptance CriteriaAC逐一映射到tests/下的测试断言产出覆盖报告并给出 FULL COVERAGE / GAPS FOUND / CRITICAL GAPS 三态判定。读完本文你将掌握该技能读 AC → 扫测试 → 匹配断言 → 出报告的完整工作流、孤儿测试与关键缺口Critical Gap的处理约定、May I write协作写盘协议以及它如何通过 CCGS Skill Testing Framework 的规格测试用例被自动化验证。1. 技能定位把需求覆盖变成可审计的量化结论在 CCGS 的 QA 技能家族/qa-plan、/smoke-check、/soak-test、/regression-suite、/test-setup、/test-helpers、/test-evidence-review、/test-flakiness中/regression-suite承担的是测试覆盖审计职责。根据仓库 UPGRADING.md 的发布记录该技能与其余 11 个 QA 技能一同引入其描述为maps test coverage to GDD critical paths, identifies fixed bugs lacking regression tests——即把测试覆盖映射到 GDD 关键路径并识别缺少回归测试的已修复缺陷。它的核心输入输出可以概括为一句话原文 Skill Summary/regression-suite读取当前 Sprint或指定 epic故事文件中的验收标准然后扫描tests/查找对应的测试文件检查每个 AC 是否拥有匹配的断言最终产出一份覆盖报告标出完全覆盖、部分覆盖、未测试的 AC以及没有任何匹配 AC 的测试文件孤儿测试。与常规跑测试看红绿的思路不同该技能本身不执行任何测试——测试执行由 CI 流水线负责它只做AC 文本 ↔ 测试断言的静态映射审计。这一边界在文档 Coverage Notes 中被明确写明是理解该技能一切行为的前提。2. 核心工作流AC 提取 → 测试扫描 → 匹配 → 覆盖报告/regression-suite的执行可以拆解为四个阶段其调用形式为/regression-suite [epic名]不传参数时默认审计当前 Sprint2.1 阶段一读取故事与验收标准技能首先读取 Sprint 故事文件如production/sprints/sprint-004.md从中提取每个故事的 AC 列表。若以 epic 名为参数调用则改为从指定 epic 的故事中提取。提取时需要记录故事的系统名system name、场景描述scenario description与优先级——优先级信息是后续 CRITICAL GAPS 判定的关键输入。2.2 阶段二扫描测试文件随后扫描tests/目录下的测试文件覆盖tests/unit/与tests/integration/文档 Coverage Notes 明确指出集成测试与单元测试以同样的方式映射判定时不区分二者。2.3 阶段三按系统名 场景关键词匹配将每个 AC 与测试断言进行匹配。协议合规要求中最重要的一条是按系统名和场景匹配 AC 与测试而非仅凭文件名匹配。也就是说tests/unit/save_system_test.gd不能因为名字里带 save_system 就被认定覆盖了存档系统的 AC必须进一步验证其断言内容是否与 AC 的场景描述对应。文档同时承认这是一个启发式heuristic匹配精确匹配逻辑定义在技能正文SKILL.md中规格层面只约束必须这样做不锁定具体实现。2.4 阶段四产出覆盖报告报告需要分类列出完全覆盖covered有匹配测试断言并引用对应的测试文件部分覆盖partially covered存在对应测试但断言未完全覆盖 AC 场景未测试untested没有任何匹配测试孤儿测试orphan tests存在于tests/但匹配不到任何当前 AC 的测试文件。报告写入位置为production/qa/默认命名形如production/qa/regression-sprint-004.md指定 sprint 时或production/qa/regression-[sprint]-[date].md未指定时按当前 sprint 与日期命名。3. 三态判定协议FULL COVERAGE / GAPS FOUND / CRITICAL GAPS覆盖报告最终必须落在一个明确的判定上这是规格文档反复强调的协议要求判定触发条件语义FULL COVERAGE所有 AC 都有对应测试当前 Sprint 需求全部具备回归测试保障可放心推进GAPS FOUND存在若干 AC 未测试有需求缺口需要在报告中按故事与 AC 文本逐一列出CRITICAL GAPS存在Critical 优先级的 AC 没有测试关键路径失守必须显著标记并建议阻塞故事完成三个判定的区别至关重要普通缺口只是建议补齐级别的提示而关键缺口是建议阻塞故事完成block story completion级别的告警。Case 3 中明确要求报告以突出方式标记CRITICAL GAP: [AC文本] — no test found (Critical priority story)并且协议合规条目要求以高于普通缺口的显著性标记关键优先级 AC 的未测试项同时在报告中一并列出非关键缺口若存在。孤儿测试不影响判定——判定只反映 AC 覆盖情况。即便存在大量孤儿测试只要所有 AC 都有测试判定依然是 FULL COVERAGE。孤儿标记仅作为建议性提示advisory。4. 孤儿测试Orphan Test的识别与建议Case 4 给出了孤儿测试的典型场景tests/unit/save_system_test.gd中存在断言但其覆盖的场景在当前任何故事 AC 中都不存在当前 Sprint 故事完全不引用存档系统。此时该测试文件会在覆盖报告中被标记为ORPHAN TEST并附带说明Orphan tests may belong to a past or future sprint, or AC was renamed孤儿测试可能属于过去或将来的 Sprint或 AC 已被重命名。这一设计非常务实孤儿测试既可能是过期产物需求被砍或重构后测试未同步清理也可能是超前储备为未来 Sprint 写的测试还可能是命名漂移AC 文本被修改导致关键词不再匹配。规格只要求标记 提示原因方向不要求删除或强制配对体现了审计类工具报告而非裁决的边界。5. May I write协作协议与写盘边界/regression-suite不是只读技能——它允许向production/qa/写入覆盖报告但必须先征得用户同意。文档在多个位置固化这一约束Static Assertions 要求规格中包含 May I write 语言每个测试用例的 Expected Behavior 都包含技能询问 May I write 后文件在批准后才写入的步骤Protocol Compliance 明确要求在持久化覆盖报告前询问 May I write。实际交互流程为技能生成覆盖报告内容 → 询问May I write to production/qa/regression-sprint-004.md?或按 sprint/日期拼接的路径→ 用户批准后才写入文件。这一模式与 CCGS 的 skill-test-spec 模板 中使用 May I write 再写文件或只读则跳过不未经批准自动创建文件的通用协议一脉相承也是 utility 类技能通过静态检查的必要条件。6. 为什么不需要 Director 关卡QA 审计工具的边界设计与门禁类技能如/gate-check在 full 模式下会拉起 creative-director / technical-director / producer 等导演关卡不同/regression-suite的 Director Gate Checks 章节明确写的是None./regression-suiteis a QA analysis utility. No director gates apply.Case 5 专门验证了这一行为技能产出覆盖报告并写盘时不生成任何导演 Agent输出中不出现任何 gate ID判定只有 FULL COVERAGE / GAPS FOUND / CRITICAL GAPS 三种不存在 gate 判定。这一设计的合理性在于职责分离导演关卡用于决策审批阶段推进、设计放行而回归覆盖审计是事实收集哪些 AC 有测试、哪些没有。审计结果作为输入提供给决策流程本身不需要决策者介入。同类 QA/分析类技能如code-review、test-evidence-review也遵循只读报告、不加 gate的模式与 quality-rubric.md 中 utility 类指标 U2若技能触发任何导演关卡才需要验证 full/lean/solo 模式逻辑的条件性描述互相印证。7. 规格化测试5 个行为用例逐项拆解/regression-suite的行为规格由 CCGS Skill Testing Framework 维护。该框架是独立的 QA 层用catalog.yaml本技能条目见 catalog.yamlcategory 为utility登记全部技能与 Agent并为每个技能编写行为规格文件。规格遵循 skill-test-spec.md 模板Skill Summary Static Assertions Director Gate Checks 5 个 Test Cases Protocol Compliance Coverage Notes。/regression-suite的 5 个用例覆盖了其全部关键行为分支Case 1全覆盖Happy PathFixtureproduction/sprints/sprint-004.md含 3 个故事、每故事 2 个 AC共 6 个tests/unit/与tests/integration/中存在按系统名与场景描述匹配全部 6 个 AC 的测试。输入/regression-suite sprint-004预期读取全部 6 个 AC → 扫描测试逐一匹配 → 报告 6/6 ACs covered → 询问写入production/qa/regression-sprint-004.md→ 批准后写盘判定FULL COVERAGE。关键断言6 个 AC 全部出现在报告中、每个 AC 标注 covered 并引用匹配测试文件、判定为 FULL COVERAGE、写盘前先询问。Case 2发现缺口FixtureSprint 含 5 个故事共 8 个 AC其中 5 个有测试3 个无任何对应测试文件或断言。输入/regression-suite默认当前 Sprint预期读取全部 8 个 AC → 5 匹配、3 未匹配 → 报告按故事与 AC 文本列出 3 个未测试 AC同时展示已匹配 AC不能只列缺口→ 询问写入production/qa/regression-[sprint]-[date].md→ 判定GAPS FOUND。关键断言3 个未测试 AC 按名称列出、已匹配 AC 同样展示、判定为 GAPS FOUND 而非 FULL COVERAGE、报告在 May I write 批准后写入。Case 3关键 AC 未测试FixtureSprint 含 4 个故事其中一个为 Priority: Critical 且带 2 个 AC其中一个关键 AC 无测试。输入/regression-suite预期读取故事时标注 Critical 优先级 → 关键 AC 匹配失败 → 报告显著标记CRITICAL GAP→ 建议阻塞故事完成直至补测试 → 判定CRITICAL GAPS。关键断言判定为 CRITICAL GAPS而非 GAPS FOUND、关键 AC 标记显著性高于普通缺口、包含阻塞建议、非关键缺口若有也一并列出。Case 4孤儿测试Fixturetests/unit/save_system_test.gd存在但断言场景不在任何当前故事 AC 中当前 Sprint 不涉及存档系统。输入/regression-suite预期交叉比对后该文件无匹配 → 标记为 ORPHAN TEST → 附带可能属于过去/未来 Sprint 或 AC 被重命名的说明 → 判定仍只看 AC 覆盖情况。关键断言孤儿测试被标记且包含文件名与建议、孤儿测试单独不触发 GAPS FOUND、最终判定仅反映 AC 覆盖。Case 5无 Director 关卡Fixture含故事与测试文件的普通 Sprint。输入/regression-suite预期产出报告并写盘全程不生成导演 Agent、无 gate ID。关键断言不调用任何导演关卡、无 gate 跳过消息、判定仅限三种覆盖判定之一。此外规格还要求该技能具备**下一步交接next-step handoff**能力——例如测试框架缺失时引导/test-setup测试计划缺失时引导/qa-plan对应 test-setup 规格 负责按引擎搭建tests/unit|integration|performance|playtest骨架并生成 GdUnit4 / Unity asmdef / Unreal headless runner 配置help.md 的技能索引中也将/regression-suite列为 QA 工具链成员。8. 静态断言与协议合规自动化验证的双层约束/regression-suite的规格通过两层机制保证可验证性第一层Static Assertions结构断言。由/skill-test static自动验证无需任何 fixturefrontmatter 包含name、description、argument-hint、user-invocable、allowed-tools字段至少 2 个阶段标题phase headings包含三态判定关键词FULL COVERAGE、GAPS FOUND、CRITICAL GAPS包含 May I write 语言允许写覆盖报告包含下一步交接框架缺失时/test-setup计划缺失时/qa-plan。这与 quality-rubric.md 中 utility 类指标U1通过全部 7 项静态检查/skill-test static [name]返回 COMPLIANT 且 0 FAIL一一对应。第二层Protocol Compliance协议合规。由行为用例覆盖验证扫描测试前先从 Sprint 文件读取故事 AC按系统名与场景匹配 AC 与测试非仅文件名关键优先级未测试 AC 标记为 CRITICAL GAPS孤儿测试存在于tests/但无 AC 匹配被标记持久化覆盖报告前询问 May I write判定限于 FULL COVERAGE / GAPS FOUND / CRITICAL GAPS。值得强调的是框架 CLAUDE.md 中的一条重要注记规格描述的是当前行为而非理想行为规格由阅读技能正文写成可能固化了 bug当技能在实际使用中出现异常时应先修正技能再更新规格把规格失败视为需要调查的信号而非技能必然有错的结论。9. 覆盖范围与已知边界规格的 Coverage Notes 部分诚实声明了本规格的边界引用时需注意匹配是启发式近似AC 到测试的匹配按系统名 场景关键词是近似逻辑精确匹配逻辑以技能正文SKILL.md路径为.claude/skills/regression-suite/SKILL.md见 UPGRADING.md 的文件清单为准规格不锁定实现集成测试与单元测试等价映射两者在判定中不作区分统一计入覆盖技能不执行测试它只把 AC 文本映射到测试断言测试执行由 CI 流水线负责。在 CCGS 的 QA 闭环中/regression-suite与相邻技能形成完整链条/test-setup搭建测试骨架 →/test-helpers生成辅助工具 → 测试由 CI 执行 →/test-evidence-review审查测试证据 →/test-flakiness排查不稳定用例 →/regression-suite在 Sprint 层面审计需求覆盖把回归测试缺失这类最容易在迭代后期爆发的风险提前量化为可执行的缺口清单。10. 如何在测试框架中验证本技能/regression-suite的规格验证由 CCGS Skill Testing Framework 驱动流程如下详见 README.md/skill-test static regression-suite # 结构断言7 项静态检查0 FAIL 为 COMPLIANT /skill-test spec regression-suite # 按上述 5 个行为用例逐一评估 /skill-test category regression-suite # 对照 utility 类 rubricU1/U2 指标按照 CLAUDE.md 定义的工作流先读catalog.yaml获取spec:路径CCGS Skill Testing Framework/skills/utility/regression-suite.md与 categoryutility再读技能正文.claude/skills/regression-suite/SKILL.md与规格文件逐用例评估断言最后可提议将结果写入results/并更新catalog.yaml的last_spec/last_spec_result等字段。若用例失败可用/skill-improve regression-suite走完测试 → 诊断 → 提议修复 → 重写 → 重测 → 保留或回退的闭环。结语/regression-suite的规格文档展示了 CCGS 对 QA 工具的一种严谨建模方式一个审计类技能如何通过三态判定、孤儿测试建议、May I write 写盘协议、无导演关卡边界以及 5 个覆盖全部行为分支的规格用例被定义成可自动化验证、可交接、可回归的工程资产。对于希望在自己的 AI 协作框架中建立需求 → 测试覆盖审计机制的团队这份规格本身就是一份可直接参考的行为契约蓝本。关联文件速查技能行为规格本文主体技能目录登记category: utility测试框架说明工作流与命令框架指令验证流程与规格有效性注记规格模板撰写新技能规格的骨架utility 类 rubricU1/U2 指标技能交接对象/test-setup 规格QA 技能家族发布记录与 SKILL.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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考