ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

用 Claude Code 编排战斗开发团队:CCGS team-combat 技能六阶段管线实战指南

用 Claude Code 编排战斗开发团队:CCGS team-combat 技能六阶段管线实战指南 用 Claude Code 编排战斗开发团队CCGS team-combat 技能六阶段管线实战指南【免费下载链接】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导读team-combat是 Claude-Code-Game-StudiosCCGS项目中负责战斗玩法端到端交付的团队编排技能slash command。它把游戏设计、玩法编程、AI 编程、技术美术、声音设计和 QA 测试六个专业 Agent 串成一条从设计到验收的流水线并内置了决策点、错误恢复与文件写入协议。读完本文你将掌握如何正确调用该技能、每个阶段应该委派给哪个 Agent、各角色的职责边界与可验证产出物以及遇到阻塞时如何按协议恢复——从而让 Claude Code 真正像一家小型游戏工作室那样并行协作。技能定位与调用方式技能本体位于 .claude/skills/team-combat/SKILL.md是一个user-invocable: true的 slash command。其 frontmatter 定义了关键元数据字段值说明nameteam-combat技能唯一标识argument-hint[combat feature description]需要传入战斗玩法描述user-invocabletrue允许用户直接调用allowed-toolsRead, Glob, Grep, Write, Edit, Bash, Task, AskUserQuestion, TodoWrite编排器允许使用的工具集其中Task用于派生子 AgentAskUserQuestion用于决策点交互调用语法为/team-combat [combat feature description]例如/team-combat melee parry system /team-combat ranged weapon spread技能内置了参数检查Argument check如果调用时没有提供战斗玩法描述编排器不会启动任何子 Agent也不会读取任何文件而是直接输出用法提示并停止Usage:/team-combat [combat feature description]— Provide a description of the combat feature to design and implement (e.g.,melee parry system,ranged weapon spread).这是一个值得借鉴的fail-fast设计编排类技能在入参不完整时立即退出避免浪费 token 和无意义的文件扫描。团队构成七个角色的职责边界技能将战斗功能拆解为七个可并行/串行的专业角色每个角色都对应仓库中的一个 Agent 定义文件角色负责内容Agent 定义game-designer设计机制、定义公式与边界情况.claude/agents/game-designer.mdgameplay-programmer实现核心玩法代码.claude/agents/gameplay-programmer.mdai-programmer实现 NPC/敌方 AI 行为.claude/agents/ai-programmer.mdtechnical-artist制作 VFX、Shader 特效与视觉反馈.claude/agents/technical-artist.mdsound-designer定义音频事件、打击音效与战斗环境音.claude/agents/sound-designer.mdengine specialist主引擎专家校验架构与实现是否符合引擎惯用法由.claude/docs/technical-preferences.md的 Engine Specialists 一节动态路由qa-tester编写测试用例并验证实现.claude/agents/qa-tester.md从 Agent 定义文件可以进一步看到各角色的不得为清单职责隔离设计game-designer不写实现代码、不做架构决策、不直接产出最终叙事内容而是产出可被程序员直接实现的规格gameplay-programmer不改设计发现偏差需上报 game-designer、不硬编码可配置数值、不写网络代码、不跳过单元测试ai-programmer不设计敌人类型只实现 game-designer 的规格、不改引擎核心系统technical-artist不做美学决策归 art-director、不改玩法代码sound-designer不写音频引擎代码、不创建音频文件本体只产出规格文档qa-tester不修 Bug只报告、不越权判定 S2 以上严重度上报 qa-lead。这种报告链 规格来源的职责网格例如 gameplay-programmer 向 lead-programmer 汇报、从 game-designer 接收规格、与 ai-programmer/ui-programmer 平级协作正是 CCGS 把真实工作室层级映射到 Agent 系统的体现。委派机制用 Task 工具派生子 Agent编排器本身不直接干活而是通过Task工具把每个成员作为子 Agent 启动subagent_type与角色一一对应subagent_type: game-designer # 设计机制、公式与边界情况 subagent_type: gameplay-programmer # 实现核心玩法代码 subagent_type: ai-programmer # 实现 NPC/敌方 AI 行为 subagent_type: technical-artist # VFX、Shader、视觉反馈 subagent_type: sound-designer # 音频事件、打击音效、环境音 subagent_type: [primary engine specialist] # 引擎惯用法校验 subagent_type: qa-tester # 测试用例与实现验证技能明确规定了两条委派准则每个 Agent 的 prompt 都必须携带完整上下文——设计文档路径、相关代码文件、约束条件避免子 Agent 在信息真空中工作在管线允许时并行启动独立 Agent——例如 Phase 3 的实现类 Agent 可以同时运行这是整个编排体系提升吞吐的关键。六阶段交付管线这是技能的核心骨架每个阶段都有明确的输入、输出与责任 AgentPhase 1设计Design委派给game-designer产出或更新design/gdd/下的设计文档。文档必须覆盖机制总览mechanic overview、玩家幻想player fantasy、详细规则、带变量定义的公式、边界情况edge cases、依赖关系、带安全范围的调参旋钮tuning knobs with safe ranges以及验收标准acceptance criteria。game-designer 的 Agent 定义进一步把这套标准固化为GDD 八段式模板.claude/agents/game-designer.md 的 Design Document Standard 一节Overview、Player Fantasy、Detailed Rules、Formulas含变量定义、输入范围、示例计算、Edge Cases、Dependencies数据流方向与集成契约、Tuning Knobs类别feel/curve/gate含默认值理由、Acceptance Criteria功能性与体验性双维度。也就是说Phase 1 的产出不是大概想法而是程序员可以仅凭文档独立实现、QA 可以据此写用例的完整规格。Phase 2架构Architecture委派给gameplay-programmer若涉及 AI 则同时带上ai-programmer评审设计文档设计代码架构类结构、接口、数据流识别与既有系统的集成点输出带文件清单和接口定义的架构草图。随后启动主引擎专家primary engine specialist校验架构校验清单聚焦三个问题类/节点/组件结构对 pinned 引擎是否惯用例如 Godot 的节点层级、Unity 的 MonoBehaviour vs DOTS、Unreal 的 Actor/Component 设计是否存在应优先使用的引擎原生系统而不该自造轮子提议的 API 在 pinned 引擎版本中是否已废弃或有变更引擎专家的路由信息读取自 .claude/docs/technical-preferences.md 的Engine Specialists一节。需要说明的是在当前仓库中该节仍为[TO BE CONFIGURED — run /setup-engine]占位状态文件扩展名路由表游戏代码 / Shader / UI / 场景 / 原生插件也尚未填充——这意味着该技能依赖先执行/setup-engine完成引擎配置才能精确路由到对应专家未配置时按文档约定回退到 Primary 专家。Phase 3实现Implementation可并行并行委派四个角色gameplay-programmer实现核心战斗机制代码ai-programmer实现 AI 行为如果功能涉及 NPC 反应technical-artist制作 VFX 与 Shader 特效sound-designer定义音频事件清单与混音说明。从实现原则看gameplay-programmer 的 Agent 定义要求所有数值来自外部配置文件data-driven、状态机必须有显式迁移表、UI 通过事件/信号解耦、所有逻辑基于 delta time 保证帧率无关、并在代码注释中标注所实现的 GDD。Phase 4集成Integration将玩法代码、AI、VFX、音频接线打通确保所有调参旋钮都被暴露且数据驱动验证功能与既有战斗系统协同工作。Phase 5验证Validation委派给qa-tester依据验收标准编写测试用例覆盖设计文档记录的所有边界情况验证性能影响在预算之内为发现的问题提交 Bug 报告。qa-tester 的 Agent 定义提供了可直接套用的工程细节.claude/agents/qa-tester.md测试命名约定文件[system]_[feature]_test.[ext]函数test_[scenario]_[expected]。三种引擎的测试骨架示例# Godot (GdUnit4) extends GdUnitTestSuite func test_[scenario]_[expected]() - void: # Arrange var subject [ClassName].new() # Act var result subject.method # Assert assert_that(result).is_equal([expected])// Unity (NUnit) [TestFixture] public class [SystemName]Tests { [Test] public void [Scenario]_[Expected]() { var subject new [ClassName](); var result subject.Method; Assert.AreEqual([expected], result, delta: 0.001f); } }// Unreal (C) IMPLEMENT_SIMPLE_AUTOMATION_TEST( F[SystemName]Test, MyGame.[System].[Scenario], EAutomationTestFlags::GameFilter ) bool F[SystemName]Test::RunTest(const FString Parameters) { [ClassName] Subject; float Result Subject.Method; TestEqual([description], Result, [expected]); return true; }每个公式必须覆盖的五类用例正常输入、零/空输入不得崩溃、最大值不得溢出或产生无穷、负修正如适用、GDD 中提到的特定边界情况。测试用例四字段格式Precondition前置条件/ Steps步骤/ Expected Result预期结果/ Pass Criteria可衡量的二值判定标准。Bug 报告格式ID、标题、严重度S1-S4、频率、构建版本、平台、复现步骤、预期/实际行为、附加上下文。qa-tester 还按故事类型路由测试证据Logic 故事必须有自动化单元测试BLOCKING 级门槛输出到tests/unit/[system]/Integration 故事需集成测试或文档化试玩tests/integration/[system]/Visual/Feel、UI、Config 类故事则走截图/文档/冒烟证据ADVISORY 级。Phase 6签收Sign-off收集所有成员的结果报告功能状态COMPLETE / NEEDS WORK / BLOCKED列出未决问题及其责任归属。决策点机制AskUserQuestion 驱动的人工闸门技能在每个阶段转换处强制设置决策点Decision Points编排器先用AskUserQuestion把子 Agent 的方案呈现为可选项并在对话中输出完整分析然后用简洁标签捕捉决策——用户必须批准后才能进入下一阶段。这与 game-designer Agent 中的 Explain - Capture 模式一脉相承先充分论证pros/cons、理论依据再让用户以结构化 UI 做选择。这意味着 team-combat 不是一键生成而是每阶段一个可干预的人工闸门从根本上避免失控的自动化产出。错误恢复协议阻塞不阻塞交付任何通过 Task 派生的 Agent 返回 BLOCKED、报错或无法完成时按四步协议处理立即上报在进入依赖阶段前向用户报告[AgentName]: BLOCKED — [reason]评估依赖判断被阻塞 Agent 的产出是否为后续阶段必需——若是在没有用户输入前不得越过该依赖点提供选项用 AskUserQuestion 给出三条路——跳过该 Agent 并在最终报告中标注缺口 / 缩小范围重试 / 停下先解决阻塞始终产出部分报告已完成的工作绝不丢弃。技能还预置了四个常见阻塞场景及处置路由阻塞原因处置方式输入文件缺失story 找不到、GDD 不存在转去创建它的技能ADR 状态为 Proposed不实现先运行/architecture-decision范围过大通过/create-stories拆成两个 storyADR 与 story 指令冲突上报冲突不做猜测这条协议的价值在于把某个子任务失败从灾难性事件降级为一次可决策、可恢复的流程事件同时通过部分报告保证任何阻塞都不会让已有工作白费。文件写入协议编排器不直接写文件技能明确要求所有文件写入设计文档、实现文件、测试用例都委派给通过 Task 派生的子 Agent每个子 Agent 都执行May I write to [path]?征得许可再写入协议编排器本身不直接写文件。这是 CCGS 全局协作规范的一部分——文件权限永远下放到具体执行者编排层只负责调度、汇总与决策呈现避免编排器越权覆盖子 Agent 的产出。输出报告与判定最终交付是一份汇总报告覆盖设计完成状态、各成员实现状态、测试结果与未决问题。终结判定二选一COMPLETE—— 战斗功能已完成设计、实现与验证BLOCKED—— 一个或多个阶段无法完成已产出带未解决事项清单的部分报告。后续衔接交付不是终点技能内置了三个明确的下一步动作Next Steps指向仓库中对应技能在关闭 story 前对已实现的战斗代码运行/code-review对应 .claude/skills/code-review/SKILL.md做架构级代码审查运行/balance-check.claude/skills/balance-check/SKILL.md验证战斗公式与调参数值若需要 VFX、音频或性能打磨运行/team-polish.claude/skills/team-polish/SKILL.md——该技能是平行设计的打磨团队编排器管线Assessment → Optimization → Visual/Audio Polish → Hardening → Sign-off与 team-combat 同构二者衔接形成开发→打磨的完整闭环。适用前提与限制从源码结构看本技能的正常运行依赖以下前提读者需知悉引擎配置先行引擎专家路由依赖.claude/docs/technical-preferences.md的 Engine Specialists 一节当前仓库该节为待配置占位需先运行/setup-engine设计文档目录约定技能约定 GDD 存放于design/gdd/而当前仓库design/目录仅包含 design/registry/entities.yaml 与 design/CLAUDE.mdgdd/由 game-designer 按需创建引擎版本安全gameplay-programmer 与 technical-artist 的 Agent 定义都要求实现前核对docs/engine-reference/[engine]/VERSION.md的 pinned 版本训练数据与版本参考冲突时以仓库参考文档为准并遵守docs/architecture/中既有 ADR 的 Implementation Guidelines。总而言之team-combat 的工程价值在于它把多人多角色协作开发一个战斗功能这一天然复杂的流程压缩为一条受控的六阶段管线设计产出可实现的规格、架构先经引擎专家把关、实现并行推进、QA 按证据路由表兜底、每个阶段由人工闸门把关、任何阻塞都有恢复路径。这套模式完全可以迁移到其他类型的功能开发关卡、UI、剧情等仓库中team-level、team-ui、team-narrative等平行技能即是同一编排范式的复刻。【免费下载链接】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),仅供参考
返回列表