1. 项目定位与用途
Claude Code Game Studios 是一个为 Claude Code 会话设计的游戏开发工作室模板,提供完整的代理团队、流程技能和自动化系统,将单次 AI 交互转化为结构化开发环境。它通过模拟真实工作室的导演-主管-专家三层 hierarchy,帮助开发者系统化管理游戏项目,涵盖设计、编程、艺术、音频、叙事、QA 和生产等全领域。用户通过 slash commands 驱动工作流,从初始 brainstorm 到最终发布,每个阶段都有专业代理提供指导、审查和验证,确保项目质量与愿景一致性。模板包含 49 个代理、72 个技能、12 个钩子、11 条规则和 39 个文档模板,开箱即用。
2. 解决的问题
单独使用 Claude Code 开发游戏时,会话缺乏结构,容易导致设计文档缺失、代码质量低下、无测试覆盖、愿景漂移等问题。本模板引入专业代理团队,每个代理有明确职责和质量 gates,例如设计主管审查系统设计,QA Lead 制定测试计划,技术总监 enforce 编码规则。代理遵循协作原则,主动提问、呈现选项、解释权衡,但由用户最终决策,从而在保持用户控制权的同时,引入团队协作的检查与平衡,早期捕获错误,避免硬编码魔法数字、跳过设计文档、编写面条代码等常见陷阱。
3. 适用场景
本模板适用于独立开发者或小型团队使用 Claude Code 进行游戏开发,特别是需要结构化流程和质量保障的项目。也适合希望模拟真实工作室分工、自动化设计评审与代码审查、以及从概念到发布全程有序管理的团队。无论是原型快速迭代还是完整产品开发,代理团队都能提供领域专业支持。但需注意,项目当前以 Godot 引擎参考为主,其他引擎代理集虽存在但文档 pinned 版本可能不完整,使用时应查阅对应引擎参考目录,并警惕 LLM 知识过时风险。
4. 安装与配置
仓库中未明确给出具体的安装命令。通常,对于 Claude Code 项目,需要将模板的 .claude/ 目录(包含 agents、skills、hooks、rules 等子目录)复制或符号链接到项目根目录。用户可能需要根据所选引擎(Godot/Unity/Unreal)选择对应的代理集,并确保引擎参考文档可用。建议参考 README 的 Getting Started 部分获取详细步骤,或直接查看 .claude/ 目录结构进行手动配置。由于 Claude Code 的环境依赖,请先安装 Claude Code 工具并正确设置项目上下文。
5. 使用方式
用户通过 slash commands 与代理团队交互。核心命令包括:/start 初始化工作室;/design-system 创建设计系统文档;/create-epics 将需求拆分为史诗;/create-stories 将史诗拆分为用户故事(自动嵌入 TR-ID);/dev-story 开始开发单个故事;/story-done 标记完成并触发验证(检查控制清单版本);/story-readiness 验证 TR-ID 存在且活跃;/architecture-decision 创建架构决策记录;/architecture-review 运行架构审查并更新 TR 注册表。每个命令触发相应代理执行其领域职责,遵循问题→选项→决策→草稿→批准的协作模式。
6. 实现特点与最佳实践
项目核心是用户驱动协作模型,代理仅作为顾问,用户拥有最终决策权,避免自主生成。技术实现上,采用 ADR 状态生命周期(Proposed→Accepted→Superseded)确保故事引用有效;TR 注册表提供永久稳定需求 ID,防止重编号破坏引用;控制清单定义每层编程规则,故事嵌入版本以自动检测过时;引擎参考文档 pinned 当前版本(如 Godot 4.6)并汇总最佳实践,弥补 LLM 训练数据截止问题。这些机制共同保障开发过程的可追溯性、一致性和质量,同时通过 12 个钩子实现自动化验证(如 commit、push、资产变更、会话生命周期)。