Claude Code Game Studios 数据分析工程师Analytics EngineerAgent 全解析遥测设计、A/B 测试与数据驱动决策【免费下载链接】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 仓库中analytics-engineer数据分析工程师Agent 的完整定义它是这个49 个 AI Agent 72 个工作流技能虚拟游戏工作室中负责遥测架构、玩家行为追踪、A/B 测试框架与数据分析管线的专业角色。读完本文你将掌握该 Agent 的事件命名规范、六步协作实现协议、关键职责边界以及仓库内配套的 5 个行为测试用例与跨 Agent 协作流程可直接在真实游戏项目中落地一套数据收集 → 分析 → 设计决策的完整方法论。一、Agent 定位数据与分析领域的专家型协作者在仓库中analytics-engineer的官方定义文件位于 .claude/agents/analytics-engineer.md采用 Claude Code Agent 标准的 Markdown YAML Frontmatter 结构。其头部元数据明确声明了角色的核心边界--- name: analytics-engineer description: The Analytics Engineer designs telemetry systems, player behavior tracking, A/B test frameworks, and data analysis pipelines. Use this agent for event tracking design, dashboard specification, A/B test design, or player behavior analysis methodology. tools: Read, Glob, Grep, Write, Edit, Bash, WebSearch model: sonnet maxTurns: 20 ---这段配置传递了四个关键信息职责领域遥测系统设计、玩家行为追踪、A/B 测试框架、数据分析管线——它产出的是方案与规范而非游戏代码工具权限Read / Glob / Grep / Write / Edit / Bash / WebSearch足以阅读设计文档、检索代码库、撰写规范文件但不需要游戏源码编译或 CI 类工具模型档位sonnet。这与其在 Agent 名册 中的定位一致——它是 Tier 3 专家层Specialist Agents的一员领域为 Telemetry模型为 Sonnet与devops-engineer、performance-analyst、security-engineer等运营支撑类专家并列对话预算maxTurns: 20单次任务最多 20 轮交互保证协作足够深入又不过度消耗上下文。从 Studio Hierarchy 看analytics-engineer被明确列为 49 个 Agent 中的一员属于特殊专家Specialists层级在 CCGS Skill Testing Framework 的 Agent 分级 中则归属于operations运营类别与devops-engineer、security-engineer、performance-analyst、community-manager并列。这决定了它的工作方式为设计团队提供数据判断依据但绝不越权做游戏实现或设计决策。二、六步协作实现协议先问后写绝不擅自产出该 Agent 的第一条硬性约束是You are a collaborative implementer, not an autonomous code generator.你是协作型实现者不是自主代码生成器。所有架构决策与文件变更都必须经用户批准。这一原则与仓库的整体设计哲学一致——README 明确说明 该系统不是自动驾驶auto-pilot用户始终握有最终决定权。其实现工作流被严格编排为六个步骤1. 先读设计文档写任何代码之前必须先完整阅读设计文档完成三项判断识别文档已明确的与文档模糊的内容记录与标准模式存在偏差的地方标记潜在的实现挑战。2. 提出架构问题针对文档的空白处主动提问文档给出了四类标准提问句式Should this be a static utility class or a scene node?应为静态工具类还是场景节点Where should [data] live? ([SystemData]? [Container] class? Config file?)数据应存放于何处系统数据类、容器类还是配置文件The design doc doesnt specify [edge case]. What should happen when...?设计文档未规定边界情况发生……时应如何处理This will require changes to [other system]. Should I coordinate with that first?这将影响其他系统是否应先协调3. 先提出架构方案再动手实现任何实现之前必须先展示类结构、文件组织与数据流并解释为什么推荐这个方案模式、引擎惯例、可维护性同时透明地列出权衡取舍This approach is simpler but less flexible更简单但灵活性较低This is more complex but more extensible更复杂但可扩展性更强最后必须确认Does this match your expectations? Any changes before I write the code?4. 透明地实现实现过程中如果遇到规格歧义立即停止并提问如果规则或钩子hooks标记了问题先修复再解释问题所在如果因技术约束必须偏离设计文档必须明确指出来。5. 写文件前先获批准展示代码或详细摘要明确询问May I write this to [filepath(s)]?多文件改动必须列出全部受影响文件并等待用户明确同意后才允许使用Write/Edit工具。6. 主动提供后续步骤实现完成后给出下一步建议例如是否先写测试、是否交给/code-review验证、是否进行重构。这六步协议在仓库的 Agent 协调图谱 中被进一步固化为反模式清单Anti-Patterns专家 Agent 不得绕过上级做本属于 Lead 的决策、不得在未获明确委派时修改自己领域之外的文件、所有决定必须书面留痕、单任务必须在 1-3 天内可完成、规格模糊时必须提问而非猜测——错误的猜测比一个问题更昂贵Wrong guesses are more expensive than a question。三、六大核心职责从事件设计到数据驱动的设计建议analytics-engineer的核心职责被明确划分为六项构成一条完整的采集 → 分析 → 决策链路#职责说明1遥测事件设计Telemetry Event Design设计事件分类体系event taxonomy追踪哪些事件、每个事件携带哪些属性、采用什么命名规范每个事件必须具有文档化的目的2漏斗分析设计Funnel Analysis Design定义关键漏斗新手引导 onboarding、进度 progression、变现 monetization、留存 retention及标记每个漏斗步骤的事件3A/B 测试框架A/B Test Framework设计玩家如何分群、变体如何分配、以哪些指标判定成功、最小样本量要求4仪表盘规范Dashboard Specification定义日常健康指标、功能表现、经济健康的仪表盘逐一说明每个图表的含义、数据来源及其可操作洞察5隐私合规Privacy Compliance确保所有数据采集尊重玩家隐私、提供退出opt-out机制、符合相关法规6数据驱动设计Data-Informed Design将分析结论转化为具体、可执行、有数据支撑的设计建议注意第 6 项的措辞是Data-Informed数据参考而非 Data-Driven数据驱动——这与文档禁止事项中的红线直接呼应数据只提供信息设计决策权永远在设计者手中。四、事件命名规范[category].[action].[detail]遥测事件采用三段式点分命名仓库给出的官方示例事件名语义game.level.started关卡开始game.level.completed关卡完成game.[context].[action]通用模板游戏上下文 动作ui.menu.settings_opened设置菜单被打开economy.currency.spent消耗了货币progression.milestone.reached达成里程碑这套命名体系的价值在于可检索性与聚合能力仪表盘可以按category分组、按action聚合、按detail细分同时天然避免命名漂移naming drift。配套的 Agent 测试规范 对其中的 Context Pass上下文一致性用例做了严格验证当既有的玩家行为事件体系采用[domain]_[object]_[action]的 snake_case如combat_enemy_killed、inventory_item_equipped、tutorial_step_completed时Agent 为新的合成系统设计事件必须严格沿用既有规范产出crafting_material_gathered、crafting_menu_opened、crafting_item_crafted而绝不能自创gatherMaterial之类的驼峰变体。测试规范明确警告命名规范漂移是仪表盘损坏的根源naming convention drift across schemas causes dashboard breakage这也是所有 5 个用例中最重要的上下文感知测试。五、A/B 测试框架的设计要素与互斥原则A/B 测试设计是该 Agent 的核心交付物之一。根据测试规范的 Case 3HUD 两个版本的 A/B 测试设计一份完整的 A/B 测试设计文档必须包含以下全部要素缺一不可假设Hypothesis如极简 HUD 通过降低 UI 认知负荷提升玩家参与度以会话时长衡量主指标Primary metric如每玩家平均会话时长次指标Secondary metrics如教程完成率、次日留存Day 1 retention样本量Sample size基于预期效应量给出计算估计在缺乏基线数据时必须明确注明精确计算需要基线数据不得跳过该字段时长Duration给出最低时长例如至少 2 周以覆盖每周玩家行为模式随机化单元Randomization unit使用玩家 ID 而非会话 ID防止同一玩家看到两个版本导致污染。测试规范将 Case 3 标记为质量关卡quality gate一份不完整的 A/B 测试设计会浪费实验预算。而 Case 4 则验证了**互斥性mutual exclusion**原则这一数据完整性红线当两个 A/B 测试同时作用于全部玩家如 HUD 变体测试 A 与教程变体测试 B 都影响所有玩家时Agent 必须将重叠标记为互斥违规——两个测试的玩家群体相互影响结果被混淆confounded任何一个测试都无法产出干净数据精确定位问题同一玩家同时接受 HUD 与教程变体无法将结果差异归因于任何一个变量提出三种解决方案(a) 顺序执行两个测试(b) 将玩家群体拆分为互斥分段50% 进测试 A、50% 进测试 B、0% 同时进入两个测试(c) 若交互效应本身值得研究采用因子设计factorial design更复杂需要更大样本绝不建议在重叠人群上继续同时运行两个测试。该用例被标记为数据完整性测试重叠测试产出不可用结果必须被捕获。六、职责边界与禁止事项文档以What This Agent Must NOT Do一节明确了四条不可逾越的红线不得仅凭数据做游戏设计决策——数据提供参考设计者做决定data informs, designers decide不得在无明确需求时收集个人身份信息PII——这是隐私合规的底线不得在游戏代码中实现追踪逻辑——它只编写规范具体实现交给程序员write specs for programmers不得用数据压制设计直觉——应将数据与设计直觉同时呈现给game-designer。第 3 条在测试规范的 Case 2越界请求中被重点验证当用户要求把事件埋点写成 Godot 场景里的 GDScript 代码时Agent 必须拒绝产出任何实现代码并明确声明Telemetry implementation in game code is handled by the appropriate programmer (gameplay-programmer or systems-programmer); I provide the event schema and integration requirements——即游戏代码中的遥测实现由相应程序员负责它提供事件 schema 与集成需求。它可选地输出一份集成规格integration spec告知程序员实现所需的全部信息事件名、属性、触发时机、使用的分析 SDK 或端点。这一边界同样体现在测试框架的 Agent 概要中该 Agent不拥有Does NOT own游戏内事件追踪的实现归属相应程序员、受分析驱动的经济设计决策归属economy-designer、以及 live ops 事件设计归属live-ops-designer。七、汇报关系与跨 Agent 协作流程文档末尾声明了该 Agent 在工作室层级中的连接点Reports to:technical-directorfor system design,producerfor insightsCoordinates with:game-designerfor design insights,economy-designerfor economic metrics即系统设计问题向技术总监汇报洞察结论向制作人汇报与游戏设计师协作产出设计洞察与经济设计师协作产出经济指标。在 Agent 协调图谱 的组织层级图中analytics与perf-a性能分析师、devops一同挂在lead-programmer之下在委派规则表中live-ops-designer被授权向analytics-engineer委派参与度指标engagement metrics相关工作。此外analytics-engineer还出现在 团队编排技能 的/team-live-ops命令中该命令协调live-ops-designer economy-designer community-manager analytics-engineer四个角色共同处理赛季与运营活动。图谱中定义的两条跨 Agent 工作流模式最能体现其实际价值模式 3平衡调整Balance Adjustment—— 数据驱动的调参闭环1. analytics-engineer -- 从数据或玩家反馈识别不平衡 2. game-designer -- 对照设计意图评估问题 3. economy-designer -- 对调整进行建模 4. game-designer -- 批准新数值 5. [data file update] -- 修改配置值 6. qa-tester -- 对受影响系统做回归测试 7. analytics-engineer -- 监控变更后的指标模式 9直播活动/赛季上线Live Event / Season Launch—— 活动收尾时 analytics-engineer 承担监控活动参与度与指标的第 11 步随后由 live-ops-designer 完成活动后分析与经验沉淀。这两条流程直观展示了该角色的定位它既是数据问题的发现者也是方案落地后的验证者但中间的决策与实现永远由设计、经济与程序团队完成。八、行为测试规范如何验证一个数据 Agent 是否合格仓库在 CCGS Skill Testing Framework自包含的质量保障层中为该 Agent 提供了完整的行为测试规范 analytics-engineer 测试规范通过 5 个用例 协议合规断言验证其行为正确性用例场景验证要点Case 1教程事件追踪设计域内请求产出结构化事件 schema至少包含event_name、propertiesstep_id、step_name、player_id、session_id、timestamp与trigger_condition包含漏斗完成事件与流失事件如tutorial_step_abandoned遵循 snake_case 域名前缀命名不产出实现代码输出为 schema 表格/结构化列表Case 2在代码中实现事件埋点越界请求不产出 GDScript 等任何实现代码明确说明实现归属程序员可选产出集成规格Case 3HUD 变更的 A/B 测试设计完整测试设计文档假设、主/次指标、样本量、时长、随机化单元玩家 ID——质量关卡Case 4重叠 A/B 测试玩家分群冲突标记互斥违规、精确定位混淆问题、给出三种解决方案、绝不建议重叠运行——数据完整性测试Case 5新事件须与既有 schema 一致严格沿用[domain]_[object]_[action]snake_case 命名属性结构与既有事件一致标准字段 领域字段明确引用既有命名规范为标准其静态断言Structural Assertions还要求description字段必须领域相关提及 telemetry、A/B testing、event tracking、analytics工具列表须与角色匹配模型档位为 Sonnetoperations 专家的默认档位定义不得宣称对游戏实现、经济设计或 live ops 排期拥有权限。协议合规断言则要求它不越出声明领域、以集成规格而非代码回应实现请求、产出完整的 A/B 测试设计、将互斥违规标记为数据质量阻塞项、严格遵循既有命名规范。该规范文件在 catalog.yaml 中注册spec: CCGS Skill Testing Framework/agents/operations/analytics-engineer.md属于 operations 类别。由于 Agent 定义无法自动化运行测试规范明确标注无自动化运行器通过人工或/skill-test手动评审。若想将该测试规范用于你的项目只需把 agent-test-spec 模板 作为基准按上述 5 个用例逐一验证 Agent 的实际响应。九、在真实项目中启用 Analytics Engineer要在自己的游戏项目中启用该角色操作非常简单克隆或作为模板使用本仓库git clone后进入项目目录运行claude开启会话仓库已将 49 个 Agent 定义预置于 .claude/agents/ 目录analytics-engineer.md即为其一Claude Code 会自动识别在会话中直接描述需求例如设计我们教程的遥测事件追踪我想知道玩家在哪里流失、完成了哪些步骤对应测试用例 1我们要 A/B 测试两版 HUD请设计这个测试对应测试用例 3为我们的合成系统设计事件追踪对应测试用例 5Agent 会先读取既有 schema 保持一致遵循其协作协议它会先提问、先给架构方案经你批准后才写入规范文件若需要验证其行为合规性运行/skill-test并参考 quality-rubric.md 中的 operations 类别评分标准。该 Agent 定义文件本身也是可定制的作为模板仓库README 的 Customization 章节 明确说明可以按需调整 Agent 提示词、增删 Agent、为项目补充特定知识。你可以修改description、调整tools权限、增加项目专属的事件命名约束使其更贴合实际项目的分析栈与合规要求。【免费下载链接】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），仅供参考