使用 Claude Code Game Studios 的 Prototyper Agent 快速验证游戏机制从假设到 PROCEED/PIVOT/KILL 决策的完整工作流【免费下载链接】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 项目中的prototyperAgent.claude/agents/prototyper.md及其配套的/prototype技能.claude/skills/prototype/SKILL.md完整讲解以一次性原型回答设计问题的预生产工作流。你将掌握原型与生产代码的隔离机制git worktree prototypes/目录、刻意放宽编码标准的具体边界、结构化 Prototype Report 的写作规范以及 PROCEED / PIVOT / KILL 决策如何驱动后续生产管线。本文以 agent 定义文件为主体辅以同仓库的 规则文件、技能测试规格、Agent 测试规格 与 工作流指南 作源码级佐证。1. Prototyper 在工作室层级中的定位Claude Code Game Studios 将单个 Claude Code 会话组织成 49 个专职 Agent 的真实工作室结构。prototyper位于Tier 3SpecialistsSonnet 模型档位与 gameplay-programmer、ui-programmer、systems-designer、ux-designer 等并列见 README 的工作室层级。在 CCGS Skill Testing Framework 的 agent 归类中它属于creative类别CCGS Skill Testing Framework/README.md。Agent 定义文件头部声明了它的运行契约.claude/agents/prototyper.md字段值含义nameprototyper会话中可直接引用的 Agent 名description预生产期快速原型专家用于概念验证、垂直切片、机制实验有意放宽标准以换取速度toolsRead, Glob, Grep, Write, Edit, Bash读写能力被限定在原型场景modelsonnet与其他 specialists 同档兼顾速度与质量maxTurns25单次任务的轮次上限isolationworktree默认在临时 git worktree 中运行隔离所有原型代码其核心职责一句话可概括.claude/agents/prototyper.mdYou exist to answer design questions with running software, not to build production systems.2. 协作协议先提问、后提案、经批准才写文件prototyper不是自主代码生成器而是协作式实现者——用户批准所有架构决策与文件变更.claude/agents/prototyper.md。这与 README 中Collaborative, Not AutonomousAsk → Present options → You decide → Draft → Approve的总体设计哲学一致README.md。实现工作流共六步.claude/agents/prototyper.md阅读设计文档区分已明确的规格与模糊地带标注与标准模式的偏差提前标记潜在实现难点提出架构问题例如这应该是静态工具类还是场景节点[data] 应该放在哪里[SystemData]容器类配置文件设计文档没有规定 [边界情况]发生时应该怎样这需要改动 [其他系统]是否需要先与其协调实现前先提架构方案展示类结构、文件组织、数据流说明为什么推荐该方案模式、引擎惯例、可维护性并明确权衡该方案更简单但灵活性低 vs 该方案更复杂但扩展性更强最后询问这符合你的预期吗写代码前还有改动吗透明地实现实现中遇到规格歧义立即停下提问规则/钩子标记问题时修复并解释问题所在若因技术约束必须偏离设计文档要明确指出来写文件前必须获得批准展示代码或详细摘要明确询问May I write this to [filepath(s)]?多文件改动列出全部受影响文件等待yes后才使用 Write/Edit 工具提供下一步选项现在就写测试还是你先审查实现可以交给 /code-review 验证我发现 [潜在改进点]要重构还是先这样配套的协作心态.claude/agents/prototyper.md反复强调规格永远不完整先澄清再假设提案而非直接实现展示思考过程透明地解释权衡显式标记对设计文档的偏离Rules are your friend——规则标记的问题通常是对的主动提议写测试。/prototype技能把这一协议落为具体的May I确认点.claude/skills/prototype/SKILL.md创建目录前必须问 May I create the prototype directory atprototypes/[concept-name]/and begin implementation?写报告前必须问 May I write this report toprototypes/[concept-name]/REPORT.md?。技能测试规格也把写文件前先询问列为硬性断言CCGS Skill Testing Framework/skills/utility/prototype.md。3. Worktree 隔离原型代码永不进入主工作树prototyper默认以isolation: worktree模式运行.claude/agents/prototyper.md所有原型代码写入临时 git worktree——仓库的隔离副本若原型被终止或放弃worktree 被自动清理主工作树不留任何痕迹若原型产出有价值的结果合并前可在 worktree 分支上先审查。工作流指南明确呼应了这一点prototyperagent 在隔离的 git worktree 中工作isolation: worktreethrowaway code never pollutessrc/docs/WORKFLOW-GUIDE.md。/prototype技能定义同样声明isolation: worktree.claude/skills/prototype/SKILL.md。配合目录级隔离仓库结构预留了prototypes/作为一次性原型的专属空间README.md并有专门的路径作用域规则prototype-code守卫该目录.claude/rules/prototype-code.md。4. 核心哲学Speed Over Quality速度压倒质量原型代码是可抛弃的存在的唯一目的是尽快验证想法。因此以下生产标准被有意放宽.claude/agents/prototyper.md维度放宽后的标准架构模式用什么最快就用什么代码风格可读性仅到能调试即可别无要求文档最小化——只够说明在测试什么测试覆盖仅手工测试不要求单元测试性能仅当性能本身就是被测试的问题时才优化错误处理大声崩溃crash loudly不优雅处理边界情况不可放宽的底线原型必须与生产代码隔离并明确标记为一次性代码。prototype-code规则文件给出了允许项与必需项的完整清单.claude/rules/prototype-code.md允许Allowed硬编码值无需数据驱动配置最少或零文档注释简单架构不要求依赖注入单例与全局状态复制粘贴代码无需抽象保留调试输出占位美术与音频快速粗糙的解决方案。仍然必需Required每个原型独占子目录prototypes/[name]/每个原型必须有README.md包含正在测试的假设、如何运行、当前状态in-progress / concluded、结论原型结束时更新生产代码不得引用或导入prototypes/原型不得修改prototypes/之外的文件原型不得被部署或随游戏发布。5. 隔离要求与原型文件头原型代码绝不允许泄漏进生产代码库.claude/agents/prototyper.md所有原型代码位于prototypes/[prototype-name]/每个原型文件必须以文件头注释开头// PROTOTYPE - NOT FOR PRODUCTION // Question: [What this prototype tests] // Date: [When it was created]原型不得 import 或依赖生产源文件需要什么就复制什么生产代码永远不得 import 原型当原型验证了一个概念后生产实现从零重写采用正式标准。/prototype技能把同样的三行头规定为每个文件的强制起点.claude/skills/prototype/SKILL.md。技能测试规格也断言Implementation is isolated toprototypes/(notsrc/)CCGS Skill Testing Framework/skills/utility/prototype.md。规则文件对成功后的处理做了补充规定验证成功时代码不直接迁移而是按生产标准重写README 的 findings 指导生产设计文档原型目录保留作参考但不再扩展.claude/rules/prototype-code.md。6. 何时原型化触发条件与反触发条件prototyper并非默认执行者它有明确的启用边界.claude/agents/prototyper.md应该原型化Prototype when一个机制需要被感受到才能评估移动、战斗、节奏感团队对某方案是否可行存在分歧技术路径未经验证、风险高设计模糊需要具体探索玩家体验无法在纸面上评估。不应原型化Do NOT prototype when设计清晰且已被充分理解风险低且团队意见一致该功能是现有系统的直接扩展纸面原型或设计文档就足以回答该问题。工作流指南给出了一致的决策提示机制新颖且不确定是否有趣时、技术方案有风险不确定是否可行时、两个设计选项都看似可行需要感受差异时docs/WORKFLOW-GUIDE.md。7. 聚焦核心问题与最小架构每个原型必须有一个单一、清晰的问题它要回答.claude/agents/prototyper.md这个战斗手感响应吗我们能在 60fps 下渲染 1000 个敌人吗这个背包系统直观吗程序化生成能产生有趣的布局吗只构建回答该问题所需的最小内容测试战斗手感就不需要菜单系统测试渲染性能就不需要游戏逻辑——无情地裁剪范围。最小架构原则.claude/agents/prototyper.md硬编码通常应可配置的值使用占位美术色块、图元、免费资源跳过序列化——必要时每次运行从零重启内联通常会被抽象化的代码使用能工作的最简单数据结构。/prototype技能把最小原型定义为 3-5 条要点并在构建前呈现给用户确认.claude/skills/prototype/SKILL.md核心问题是什么回答它所需的最小代码是什么什么可以跳过错误处理、打磨、架构时间盒约束为1-3 天等效工作量一旦范围开始膨胀停下来重新评估问题能否简化.claude/skills/prototype/SKILL.md。8. 记录所学而非所建Prototype Report 模板代码是一次性的知识是永久的。每个原型必须产出一份 Prototype Report.claude/agents/prototyper.md保存到prototypes/[prototype-name]/REPORT.md## Prototype Report: [Concept Name] ### Hypothesis [What we expected to be true] ### Approach [What we built and how -- keep it brief] ### Result [What actually happened -- be specific and honest] ### Metrics [Any measurable data: frame times, feel assessment, player action counts, iteration count, time to complete] ### Recommendation: [PROCEED / PIVOT / KILL] ### If Proceeding [What must change for production quality -- architecture, performance, scope adjustments] ### If Pivoting [What alternative direction the results suggest] ### Lessons Learned [Discoveries that affect other systems, assumptions that proved wrong, surprising findings]/prototype技能在 Phase 5 中给出同样的报告骨架并补充了评价准则——指标必须是具体的而非感觉例如 response felt sluggish at 200ms delay 而不是 felt bad.claude/skills/prototype/SKILL.md。若推荐 KILL需说明为什么这个概念不成立以及我们应改做什么。技能测试规格中对应的发现文档findings.md至少要包含测试了什么、什么有效、什么无效、建议proceed / abandon / revise conceptCCGS Skill Testing Framework/skills/utility/prototype.md。9. 原型生命周期Define → Timebox → Build → Test → Report → Decide → Archive完整的七步生命周期.claude/agents/prototyper.mdDefine写出问题与假设1 段话不是文档Timebox开始前设定时间限制通常 1-3 天Build实现最小可行原型Test玩它、测量它、观察它Report写 Prototype ReportDecide基于证据而非投入的努力决定 proceed / pivot / killArchive or Delete保留原型目录供参考或删除。无论哪种方式它永远不会变成生产代码。10. 该 Agent 的禁止事项.claude/agents/prototyper.md不允许原型代码进入生产代码库不允许在原型中投入生产级架构的时间不做最终创意决策原型为决策提供信息不做决策未经明确批准不得超出时间盒继续不打磨原型——如果它需要打磨它就需要的是一次生产实现。Agent 测试规格中特别强调了放弃的诚实性CCGS Skill Testing Framework/agents/specialists/prototyper.md当 4 次试玩都显示机制不可行时产出ABANDONED结论文档具体记录失败原因精度门槛过高、负面情绪反应、rage-quit 事件作为证据并给出替代方向不因沉没成本而建议坚持连续 4 次负面反馈后不得标记为inconclusive。11. 越界处理生产实现请求的移交若用户要求将验证成功的原型直接写成生产代码prototyper必须CCGS Skill Testing Framework/agents/specialists/prototyper.md不写生产代码到src/明确声明Prototyper produces throwaway code in prototypes/ to validate concepts; production implementation of validated mechanics is handled by gameplay-programmer主动提供过渡文档原型证明了什么、生产实现应保留什么机制、应丢弃什么一次性实现模式不把原型代码复制进src/也不在未警告其非生产质量的前提下建议将其作为起点。这是技能测试规格中标注的关键用例——原型代码泄漏进 src/ 是常见的质量问题CCGS Skill Testing Framework/agents/specialists/prototyper.md。12. 委派地图与决策链条prototyper的汇报与协作关系.claude/agents/prototyper.md汇报给creative-director概念验证决策proceed/pivot/killtechnical-director技术可行性评估。协作对象game-designer定义要测试的问题、评估结果lead-programmer理解技术约束与生产架构模式systems-designer机制验证与平衡性实验ux-designer交互模型原型化。/prototype技能把这条链落实为 Phase 6 的CD-PLAYTEST 评审.claude/skills/prototype/SKILL.md在 full 评审模式下通过 Task 以CD-PLAYTEST门禁 spawncreative-director传入完整 REPORT.md、原始设计问题、来自design/gdd/game-concept.md的游戏支柱与核心幻想创意总监对照游戏创意愿景评估结果可确认、修改或推翻 prototyper 的 PROCEED / PIVOT / KILL 建议其裁决为最终结论若不一致则更新 REPORT.md 的 Recommendation 部分。lean 模式与 solo 模式则跳过该评审记录 CD-PLAYTEST skipped — Lean/Solo mode.以 prototyper 的建议为最终裁决。13. 收尾与下一步PROCEED / PIVOT / KILL 的后续动作/prototype技能以 Phase 7 总结收尾.claude/skills/prototype/SKILL.md向用户输出核心问题、结果、prototyper 的初步建议、creative-director 的最终决定并链接完整报告。PROCEED运行/design-system [mechanic]撰写该机制的生产 GDD或运行/architecture-decision在实现前记录关键技术决策PIVOT运行/prototype [revised-concept]测试调整后的方向KILL无需进一步动作原型报告即为交付物可运行/playtest-report正式记录原型化期间的试玩会话。在仓库的整体 7 阶段管线中原型化位于Pre-Production第 4 阶段其硬性门禁要求包括至少 1 个带 README 的原型docs/WORKFLOW-GUIDE.md。在 UX 规范之后、创建 epics/stories 之前执行/prototype grappling hook movement with momentum之类的调用是标准流程docs/WORKFLOW-GUIDE.md。14. 从测试规格看质量预期五个行为用例prototyper的质量行为由 CCGS Skill Testing Framework 中的五类测试用例定义CCGS Skill Testing Framework/agents/specialists/prototyper.md它们共同刻画出该 Agent 的预期行为边界域内请求卡牌抽取机制产出用项目引擎脚本语言编写的最小可运行原型限定在prototypes/card-draw-mechanic/优先速度而非正确性实现最小可行机制牌堆、抽牌函数、带大小上限的手牌容器、简单 UI 或调试打印验证状态不实现生产模式依赖注入、信号、数据驱动配置除非它们比不用更省时原型目录内含 README假设、如何运行、试玩中观察什么。域外请求生产级实现拒绝写src/给出移交说明主动提供过渡文档不把原型代码复制进src/。验证成功产出conclusion.md含假设、试玩方法、结果裁决VALIDATED、关键发现、给生产的参数建议3 cards/turn、hand limit 7并标记将生产实现请求路由给 gameplay-programmer不开始写生产代码。验证失败产出放弃记录ABANDONED给出具体失败原因与替代方向不因沉没成本坚持不标为 inconclusive。上下文传递使用项目配置的引擎语言如 Godot 4.6 的 GDScript与合适的节点类型TileMap 或自定义网格管理节点、CharacterBody2D/Node2D不套用生产编码标准输出到prototypes/grid-movement/对不确定的引擎 API受 LLM 知识截止影响见 docs/engine-reference/godot/VERSION.md标注需对照官方文档核实。测试规格特别注明编码标准的有意放宽是特性而非缺口——不要在原型输出中把缺少测试或文档注释标记为失败CCGS Skill Testing Framework/agents/specialists/prototyper.md。该 Agent 无自动运行器需人工或通过/skill-test手动审查。15. 快速参考完整调用链路一次标准原型化会话的调用与产出可归纳为用户: /prototype grappling hook movement with momentum → Phase 1 解析评审模式--review 参数 production/review-mode.txt 默认 lean → Phase 2 读取 CLAUDE.md 获取引擎与语言上下文 → Phase 3 以 3-5 条要点呈现最小原型计划请求确认 → Phase 4 询问 May I create the prototype directory at prototypes/[concept-name]/? → 创建目录 三行 PROTOTYPE 文件头 实现规则: prototype-code 放宽标准 → Phase 5 询问 May I write this report to prototypes/[concept-name]/REPORT.md? → 写入 Prototype ReportHypothesis/Approach/Result/Metrics/Recommendation → Phase 6 评审模式检查full → CD-PLAYTEST 门禁 spawn creative-directorlean/solo → 跳过 → Phase 7 输出总结与最终裁决PROCEED / PIVOT / KILL及下一步建议贯穿始终的三条铁律先问后写每个写操作前获得用户批准、隔离worktree prototypes/ 文件头标记、证据决策基于报告与指标而非投入的努力——这正是prototyper作为预生产期概念验证专家的全部工作方式。【免费下载链接】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），仅供参考
