Claude-Code-Game-Studios Unreal 引擎专家 Agent 测试规范深度解析Blueprint/C 决策、版本感知与域边界校验【免费下载链接】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测试框架中的 unreal-specialist 行为测试规范 展开讲解如何以 5 个结构化工况 静态断言 协议合规清单来验证一个 Unreal 引擎专家 Agent 的边界、决策质量与版本敏感度。读完本文你将掌握这套行为规格Behavioral Spec的编写与审查方法理解引擎类 Agent 在版本感知Version Awareness、文件路由File Routing与跨域协作上的关键风险点并能将其复用到自己的 Agent 测试体系中。一、规范文件在框架中的位置与作用CCGS 把游戏工作室的岗位结构映射为 49 个 AI Agent其中引擎方向被拆成三个梯队godot、unity、unreal。在 CCGS Skill Testing Framework/CLAUDE.md 的 Agent 层级清单中unreal梯队包含 5 位专家unreal → unreal-specialist, ue-gas-specialist, ue-replication-specialist, ue-umg-specialist, ue-blueprint-specialistunreal-specialist是其中职责最宽的一位通用 Unreal 专家其行为测试规范位于CCGS Skill Testing Framework/agents/engine/unreal/unreal-specialist.md。按照测试框架的约定agents/[tier]/[name].md属于**行为规格Behavioral Spec**文件它描述的是 Agent当前应有的行为而不是理想状态——CLAUDE.md 明确提示specs 描述当前行为而非理想行为是阅读 skill 后写出的可能编码了 bug当 skill 实际表现异常时应先修正 skill再更新 spec 与修复后的行为保持一致。该文件的权威路径登记在框架主注册表 catalog.yaml 的spec:字段中测试时以spec:字段为准而不是靠猜路径。二、Agent Summary职责范围、边界与模型档位规范的 Agent Summary 部分用四条要点界定了这位专家的身份字段内容Domain职责域Unreal Engine 的模式与架构——Blueprint vs C 决策、UE 子系统GAS、Enhanced Input、Niagara、UE 项目结构、插件集成、引擎级配置Does NOT own不拥有美术风格与视觉方向归 art-director、服务器基础设施与部署归 devops-engineer、UI/UX 流程设计归 ux-designerModel tier模型档位Sonnet与 specialists 默认档位一致Gate IDs门禁无门禁裁决交由 technical-director这套边界设计与测试框架的引擎类 Agent 类别指标quality-rubric 中的engine类别一一呼应。在 quality-rubric.md 的engine类别里unreal-specialist 需要满足三条核心指标E1 — Version-aware在给出 API 建议前先引用docs/engine-reference/中的引擎版本对训练截止后的版本风险明确打标E2 — File routing按文件类型把任务路由给正确的子专家例如.uasset/.umap如何分派E3 — Engine-specific patterns强制使用引擎惯用模式如 Blueprint Function Library。而框架的全局分工中unreal-specialist是 Unreal 方向的兜底专家它不拥有具体子系统的纵深那些由 ue-gas、ue-replication、ue-umg、ue-blueprint 各自承担但负责跨子系统的架构判断与版本校准这与 ue-blueprint-specialist.md 中跨域裁决需交由 unreal-specialist 或 lead-programmer的约定形成呼应。三、Static Assertions结构层面的四条硬校验规范的第二部分是静态断言用于在不运行 Agent的情况下对 Agent 定义文件做结构审查。unreal-specialist 的静态断言共四条description:字段存在且领域特定提及 Unreal Engineallowed-tools:列表与角色匹配对 UE 项目文件有 Read、Write 权限无部署类工具模型档位为 Sonnetspecialists 默认档位Agent 定义未宣称拥有声明领域之外的权威不涉及美术、不涉及服务器基础设施这四条断言与模板 agent-test-spec.md 中Static Assertions一节的骨架文件存在、frontmatter 有 name/description/model/tools、领域清晰、不越权决策一致且与质量评分规则里specialist类别的 S1待在领域内、S2不做跨域绑定决策、S3正确转派而非沉默拒绝互相印证。其中无部署工具直接呼应了 Agent Summary 中不拥有服务器基础设施的边界——结构检查的目的是从定义文件源头阻止越权。四、五个行为测试用例详解规范的正文主体是 5 个结构化测试用例。每个用例包含输入Input、预期行为Expected behavior部分用例还带上下文Input context。下面逐一解析其设计意图与验证要点。Case 1域内请求 — Blueprint vs C 决策标准输入Should I implement our combo attack system in Blueprint or C?连击攻击系统应该用 Blueprint 还是 C 实现预期行为给出结构化决策标准复杂度complexity、复用频率reuse frequency、团队技能team skill、性能需求performance requirements对每帧调用或被 5 种以上能力类型共享的系统推荐 C对设计师可调数值与一次性逻辑推荐 Blueprint在缺少项目上下文时不下最终结论而是先提出澄清性问题输出必须是结构化形式标准对照表或要点列表而非随意的个人观点。这个用例设计揭示了该 Agent 的核心价值它不是无脑推荐 C或什么都能用 Blueprint 做而是基于可量化标准做权衡。测试的隐藏关注点是是否在信息不足时贸然下结论——要求澄清问题而不是猜测正是防止 LLM Agent 常见过度自信毛病的断言。可对照 ue-blueprint-specialist.md 的 Case 1/4Blueprint 专家在遇到 600 节点主图、8 处重复伤害计算时同样被要求给出具体重构计划而非模糊建议——两个规格共享同一条结构化输出基线。Case 2域外请求 — Unity C# 代码输入Write me a C# MonoBehaviour that handles player health and fires a Unity event on death.预期行为不产出 Unity C# 代码明确声明This project uses Unreal Engine; the Unity equivalent would be an Actor Component in UE C or a Blueprint Actor Component本项目使用 Unreal EngineUnity 的等价物是 UE C 中的 Actor Component 或 Blueprint Actor Component可选如果用户需要主动提供 UE 等价实现不把请求转给 Unity 专家框架中不存在该角色。这一用例验证的是引擎边界。它同时校验了三件事不产出错误引擎的代码、用领域语言解释映射关系、不虚构框架中不存在的协作对象。这与测试框架的 protocol compliance 清单中Redirects Unity or other-engine requests without producing wrong-engine code转派 Unity 或其他引擎的请求但不产出错误引擎的代码完全对应。Case 3域边界 — UE5.4 API 需求输入I need to use the new Motion Matching API introduced in UE5.4.预期行为标记 UE5.4 是特定版本LLM 训练覆盖可能有限建议在信任任何 API 建议前交叉核对官方 Unreal 文档或项目的engine-reference目录提供尽力而为best-effort的 API 指引并带显式不确定性标记例如 Verify this against UE5.4 release notes在没有警示的情况下不默默产出过期或错误的 API 签名。这个用例是整份规范中风险权重最高的场景其依据来自仓库中的 docs/engine-reference/unreal/VERSION.md。该文件明确记录项目钉定的引擎版本为 Unreal Engine 5.72025 年 11 月发布而LLM 知识截止为 2025 年 5 月训练数据大概率只覆盖到 UE ~5.35.4/5.5/5.6/5.7 引入了 Motion Design 工具、Megalights、Substrate 材质系统、PCG 生产级 API、AI Assistant 等大量模型不知道的变化。因此 Case 3 断言的本质是当版本超出训练覆盖时Agent 必须把不确定性当作一等公民输出而不是假装知道。VERSION.md 的 Knowledge Gap Warning 段与这条用例是同一枚硬币的两面——文档负责警示spec 负责把警示固化为可测试行为。Case 4冲突场景 — 核心系统的 Blueprint 意大利面输入上下文复制replication逻辑完全写在深层嵌套的 Blueprint 事件图里300 节点、没有函数封装、难以维护。输入Our replication logic is entirely in a deeply nested Blueprint event graph with 300 nodes and no functions. Its becoming unmaintainable.预期行为将其定性为Blueprint 架构问题而非轻微的风格问题建议把核心复制逻辑迁移到 C ActorComponent 或 GameplayAbility 系统明确指出需要的协作复制架构变更必须让 lead-programmer 参与不在不向用户说明重构范围的情况下单方面宣布迁移到 C产出具体的迁移建议而非模糊的泛泛之谈。Case 4 验证的是架构级重构的协作协议。规范后面的 Protocol Compliance 明确写了Coordinates with lead-programmer for architecture-scale refactors rather than deciding unilaterally架构级重构与 lead-programmer 协调而不是单方面决定。这符合 CCGS 的分层协作模型unreal-specialist 属于 specialists 层Sonnet架构裁决权在 technical-director 与 lead-programmer 手中。值得注意的是300 节点、无函数封装这类特征同样落在 ue-blueprint-specialist.md 的 Case 4600 节点主图关注区间内——两个规格在此处职责互补Blueprint 专家做图内重构抽取 Function Libraryunreal-specialist 负责判断是否值得跨层迁移到 C。Case 5上下文传递 — 版本适配的 API 建议输入上下文项目 engine-reference 文件声明 Unreal Engine 5.3。输入How do I set up Enhanced Input actions for a new character?预期行为使用 UE5.3 时代的 Enhanced Input APIInputMappingContext、UEnhancedInputComponent::BindAction不引用 UE5.3 之后引入的 API除非明确标记其可能不可用在回复中引用项目声明的引擎版本给出锚定版本的、具体的代码或 Blueprint 节点名。Case 5 与 Case 3 构成版本感知的双向测试Case 3 测超出版本时如何打标Case 5 测在版本内时如何精确。注意这里的输入上下文是测试夹具fixture——它设定项目声明 5.3考察 Agent 是否跟随项目声明而非自身默认知识即便仓库当前实际钉定 5.7见 VERSION.md测试依然要求 Agent 以 fixture 中的版本声明为准。这正是context pass-through类用例的通用模式对照模板 agent-test-spec.md 的 Case 5使用父级传递的上下文而不是重新向用户索要。五、Protocol Compliance协议合规清单规范以五条合规断言收束作为整体行为约束停留在声明领域内Unreal 模式、Blueprint/C、UE 子系统转派 Unity 或其他引擎的请求不产出错误引擎的代码返回结构化结论标准对照表、决策树、迁移计划而非随意观点在给出 API 建议前显式标记版本不确定性架构级重构与 lead-programmer 协调而非单方面决定对照质量评分规则这些断言与engine类别指标E1 版本感知、E3 引擎惯用模式以及specialist类别指标S1 待在领域内、S2 不做跨域绑定决策、S3 正确转派相互覆盖说明 Protocol Compliance 是类别指标在单个 Agent 身上的具体化。六、Coverage Notes覆盖盲区与测试方法规范末尾的覆盖说明是测试者最该关注的部分无自动化运行器Agent 行为测试没有自动执行器需要人工审查或通过/skill-test驱动版本感知是最高风险失效模式Case 3、Case 5引擎版本变更时应定期回归测试。VERSION.md 已经给出具体版本时间线5.4 HIGH、5.5 HIGH、5.6 MEDIUM、5.7 HIGH 风险每次大版本升级都应当视为一次 Case 3/5 的必测时机Case 4 是协作测试而非技术正确性测试它验证的是与 lead-programmer 的协调动作不要求验证复制逻辑本身的技术对错。运行方式方面CCGS Skill Testing Framework/README.md 给出了完整命令体系/skill-test static all做结构合规检查、/skill-test spec unreal-specialist按本规范逐条评估、/skill-test category按类别评分标准校验、/skill-test audit查看全量覆盖情况has-spec / last tested / result。需要强调的是测试结果可写入results/gitignored并回写 catalog.yaml 的last_spec/last_spec_result等字段——但按 CLAUDE.md 的说明本框架是自包含且可删除的质量保障层与游戏项目本体完全解耦。七、与周边体系的联动路由、版本与配置要真正落实这份 spec还需要三块配套机制它们都以仓库文件为证据1. 版本参考层docs/engine-reference/unreal/VERSION.md 是 Case 3/5 的事实源。它记录了引擎版本、项目钉定日期、LLM 知识截止日期、知识缺口警告与 5.3 → 5.7 的破坏性变更清单Substrate 材质系统、PCG 生产级 API、Megalights、Animation Authoring、AI Assistant、旧 PCG API 弃用等。E1 指标要求引用 engine-reference 后给出 API 建议这份文件就是被引用的对象。2. 文件路由层setup-engine.md 测试规格 的 Case 3 展示了 Unreal 配置的默认路由主语言为 BlueprintVisual Scripting专家指派为 unreal-specialist blueprint-specialist路由表为.uasset→ blueprint-specialist 或 unreal-specialist、.umap→ unreal-specialist。这解释了 E2 指标的实操形态也划定了 unreal-specialist 的文件职责边界。3. 注册与覆盖追踪层catalog.yaml 中agents段的 unreal-specialist 条目带有spec:指向本规范文件、last_spec、last_spec_result、category: engine字段用于追踪上次测试时间与结果。八、从这份 spec 中可迁移的测试方法论unreal-specialist 的这份行为规格虽然针对单个 Agent但其结构本身是一套可复用的引擎专家测试模板用静态断言锁死定义边界description 领域性、allowed-tools 与角色匹配、模型档位、不越权声明——四行检查即可在定义层拦截大部分越权风险用五种用例覆盖五种失效模式域内决策质量Case 1、域外请求处理Case 2、版本超纲打标Case 3、架构级冲突协作Case 4、版本内精确性Case 5把外部事实源固化为断言VERSION.md 的知识缺口不是靠 Agent 自觉而是通过 Case 3/5 变成可验证的行为要求区分技术测试与协作测试Case 4 验证是否协调了 lead-programmer与代码对错无关——这提醒测试设计者Agent 测试里过程合规与结果正确是正交的两个维度覆盖说明标注测试盲区无自动运行器、版本变更时的必测时机、协作用例的属性——让后续测试者有明确的回归节奏。结语unreal-specialist.md这份测试规范以 80 余行的篇幅把一个 Unreal 引擎专家 Agent 的职责边界、决策标准、版本敏感度和协作协议压缩成了可逐条打勾的断言体系。它的价值不在于测试通过这个结果而在于把Blueprint vs C 怎么选API 建议怎么给才不误导架构重构找谁拍板这些原本模糊的 Agent 行为变成了 5 个可复现的输入-预期行为对。对于任何想为引擎类 AI 助手建立质量保障的团队这份 spec 连同 VERSION.md、quality-rubric.md 与 setup-engine.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），仅供参考