# Open-Code-Game-Studios **Repository Path**: ooooinfo/Open-Code-Game-Studios ## Basic Information - **Project Name**: Open-Code-Game-Studios - **Description**: 项目更名为 Open Code Game Studios，明确声明原名 Claude Code Game Studios，原作者 Donchitos - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2026-04-24 - **Last Updated**: 2026-05-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: OPENCODE, Godot ## README

Open Code Game Studios

将单个 AI 编程会话变成完整的游戏开发工作室。
49 个智能代理 · 72 个技能命令 · 一支协调的 AI 团队

MIT License 49 Agents 72 Skills GitHub 原始仓库 Adapted for OpenCode

> **项目来源与说明**：本项目原名 **Claude Code Game Studios**，由 [Donchitos](https://github.com/Donchitos) 在 GitHub 创建（[原始仓库](https://github.com/Donchitos/Claude-Code-Game-Studios)），MIT 开源协议。原始项目面向 Anthropic Claude Code 框架设计，使用 Opus/Sonnet/Haiku 等模型。 > > **为什么做这个适配版？** Claude Code 依赖 Anthropic 付费 API，Opus 模型每百万 token 输入 $15、输出 $75，对于独立开发者和小团队来说**费用负担很重**。OpenCode 是一个开源的 AI 编程助手框架，支持多种模型提供商，可以使用更经济的模型来运行相同的工作流。本项目将原始框架迁移到 OpenCode 格式，让你能自由选择模型、控制成本。 > > ⚠️ **重要**：本适配版仅完成了配置文件的格式迁移，**尚未在实际 OpenCode 环境中完整测试**。可能存在 agent 行为偏差、skill 触发异常、权限配置不当等问题。**如果你有 OpenCode 实际使用经验，非常欢迎帮助完善！** --- ## 目录 - [核心数据](#核心数据) - [工作室层级](#工作室层级) - [快速开始](#快速开始) - [模型选择指南](#模型选择指南) - [使用方式](#使用方式) - [技能命令一览](#技能命令一览) - [迁移内容明细](#迁移内容明细) - [已知限制与需要帮助的地方](#已知限制与需要帮助的地方) - [原始项目信息](#原始项目信息) - [支持原作者](#支持原作者) - [License](#license) --- ## 核心数据 | 组件 | 数量 | 说明 | |------|------|------| | **智能代理 (Agents)** | 49 | 覆盖设计、程序、美术、音频、叙事、QA、制作等全领域 | | **技能命令 (Skills)** | 72 | 斜杠命令覆盖每个工作流阶段（`/start`、`/brainstorm`、`/dev-story` 等） | | **编码规则 (Rules)** | 11 | 按文件路径的编码标准（游戏逻辑、引擎、AI、UI、网络等），整合在 `AGENTS.md` 中 | | **文档模板 (Templates)** | 39 | 游戏设计文档 (GDD)、UX 规范、架构决策记录 (ADR)、Sprint 计划等 | ### 为什么需要这个项目？ 一个人用 AI 做游戏很强——但单个聊天会话缺乏结构。没有人阻止你硬编码魔法数字、跳过设计文档、或者写出意大利面条式代码。没有 QA 流程，没有设计评审，没有人问"这真的符合游戏的愿景吗？" **Open Code Game Studios** 通过给你的 AI 会话提供真实工作室的结构来解决这个问题。你不再只有一个通用助手，而是获得 49 个按工作室层级组织的专业代理——守护愿景的总监、负责各自领域的部门主管、以及做实际工作的专家。每个代理都有明确的职责、升级路径和质量门控。 结果：你仍然做每个决定，但现在有一个团队会问正确的问题、及早发现错误、并让你的项目从头脑风暴到发布都保持有序。 ### 支持的游戏引擎 | 引擎 | 主管代理 | 子专家 | |------|---------|--------| | **Godot 4** | `godot-specialist` | GDScript、Shader、GDExtension | | **Unity** | `unity-specialist` | DOTS/ECS、Shader/VFX、Addressables、UI Toolkit | | **Unreal Engine 5** | `unreal-specialist` | GAS、Blueprints、Replication、UMG/CommonUI | --- ## 工作室层级 代理按三层结构组织，模拟真实工作室的运作方式： ``` 第一层 — 总监 (Tier 1 - Directors) creative-director（创意总监） technical-director（技术总监） producer（制作人） 第二层 — 部门主管 (Tier 2 - Department Leads) game-designer（游戏设计师） lead-programmer（主程序员） art-director（美术总监） audio-director（音频总监） narrative-director（叙事总监） qa-lead（QA 主管） release-manager（发布经理） localization-lead（本地化主管） 第三层 — 专家 (Tier 3 - Specialists) gameplay-programmer（玩法程序员） engine-programmer（引擎程序员） ai-programmer（AI 程序员） network-programmer（网络程序员） tools-programmer（工具程序员） ui-programmer（UI 程序员） systems-designer（系统设计师） level-designer（关卡设计师） economy-designer（经济设计师） technical-artist（技术美术） sound-designer（音效设计师） writer（编剧） world-builder（世界构建师） ux-designer（UX 设计师） prototyper（原型师） performance-analyst（性能分析师） devops-engineer（DevOps 工程师） analytics-engineer（数据工程师） security-engineer（安全工程师） qa-tester（QA 测试员） accessibility-specialist（无障碍专家） live-ops-designer（运营设计师） community-manager（社区经理） 引擎专家 (Engine Specialists) godot-specialist → gdscript / shader / gdextension 专家 unity-specialist → dots / shader / addressables / ui 专家 unreal-specialist → blueprint / gas / replication / umg 专家 ``` --- ## 快速开始 ### 前置条件 - [OpenCode](https://opencode.ai) CLI — 安装参考 [opencode.ai](https://opencode.ai) - [Git](https://git-scm.com/) - 至少一个 LLM API 密钥（见下方模型选择指南） ### 安装步骤 1. **克隆项目**： ```bash git clone https://gitee.com/ooooinfo/Claude-Code-Game-Studios.git my-game cd my-game ``` 2. **安装并启动 OpenCode**： ```bash # 安装 opencode（请参考官方文档选择适合的安装方式） opencode ``` 3. **配置模型**：首次启动 OpenCode 会引导你选择模型提供商。参考下方 [模型选择指南](#模型选择指南) 进行配置。 4. **开始使用**：在 OpenCode 中输入 `/start` 开始引导流程，系统会根据你的项目阶段（无概念、模糊想法、已有设计、已有代码）推荐对应的工作流。 或者直接跳到特定技能： - `/brainstorm` — 从零开始探索游戏创意 - `/setup-engine godot 4.6` — 配置游戏引擎 - `/project-stage-detect` — 分析现有项目状态 --- ## 模型选择指南 ### 为什么模型选择很重要？ 原始 Claude Code 版本使用了三个不同级别的 Anthropic 模型： | 原始模型 | 用于角色 | 特点 | Anthropic 价格 (每百万 token) | |---------|---------|------|------------------------------| | **Opus** | creative-director、technical-director、producer | 最强推理，用于战略决策和冲突仲裁 | 输入 $15 / 输出 $75 | | **Sonnet** | 大部分部门主管和专家 | 平衡性能与成本，用于日常设计和编码 | 输入 $3 / 输出 $15 | | **Haiku** | sound-designer、community-manager、devops-engineer | 快速轻量，用于格式化/重复性任务 | 输入 $0.25 / 输出 $1.25 | **费用问题**：如果你用 Claude Code 框架让 3 个 Opus 级别的总监代理持续工作，一天的 API 费用可能就超过几十美元。这就是本项目适配 OpenCode 的主要原因——**让你能用更便宜的模型跑同样的工作流**。 ### OpenCode 模型配置 OpenCode 支持多种模型提供商。在 `opencode.json` 的 agent 配置中，可以通过 `model` 字段指定每个代理使用的模型。 #### 方案一：使用经济型模型（推荐新手） 所有代理统一使用一个经济型模型，最低成本运行： ```json { "agent": { "creative-director": { "description": "...", "mode": "subagent", "model": "gpt-4o-mini" } } } ``` | 模型 | 提供商 | 大致价格 (每百万 token) | 适合场景 | |------|--------|------------------------|---------| | **gpt-4o-mini** | OpenAI | ~$0.15 / $0.60 | 日常开发、低预算 | | **gemini-2.0-flash** | Google | ~$0.10 / $0.40 | 快速迭代 | | **deepseek-chat** | DeepSeek | ~$0.14 / $0.28 | 性价比高 | | **glm-4-flash** | 智谱 | 免费/极低 | 国内用户首选 | #### 方案二：分层模型配置（推荐进阶） 模拟原始项目的 Opus/Sonnet/Haiku 分层策略，用不同能力的模型匹配不同角色的需求： ``` 总监层 (Tier 1) — 需要最强推理能力 → 用强模型处理战略决策、冲突仲裁 推荐: gpt-4o / gemini-2.5-pro / deepseek-reasoner 部门主管 (Tier 2) — 需要平衡能力和成本 → 用中等模型处理日常设计和架构决策 推荐: gpt-4o-mini / gemini-2.0-flash / claude-sonnet 专家层 (Tier 3) — 大量重复性工作 → 用经济模型处理编码、测试、文档 推荐: gpt-4o-mini / gemini-2.0-flash / deepseek-chat ``` 具体配置方式——编辑 `opencode.json`，为每个代理添加 `model` 字段： ```json { "agent": { "creative-director": { "description": "创意总监...", "mode": "subagent", "model": "gemini-2.5-pro" }, "technical-director": { "description": "技术总监...", "mode": "subagent", "model": "gemini-2.5-pro" }, "producer": { "description": "制作人...", "mode": "subagent", "model": "gemini-2.5-pro" }, "game-designer": { "description": "游戏设计师...", "mode": "subagent", "model": "gpt-4o-mini" }, "sound-designer": { "description": "音效设计师...", "mode": "subagent", "model": "deepseek-chat" } } } ``` #### 方案三：原始 Anthropic 模型（如果你有预算） OpenCode 也支持 Anthropic 模型。如果你想完全还原原始体验： | 角色 | 原始模型 | model 字段值 | |------|---------|-------------| | creative-director | Opus | `claude-opus-4-0` | | technical-director | Opus | `claude-opus-4-0` | | producer | Opus | `claude-opus-4-0` | | game-designer, lead-programmer 等主管 | Sonnet | `claude-sonnet-4-0` | | 大部分专家 | Sonnet | `claude-sonnet-4-0` | | sound-designer, community-manager, devops-engineer | Haiku | `claude-haiku-3-5` | ### 模型配置建议 1. **国内用户**：推荐使用智谱 GLM 或 DeepSeek，访问速度快，价格低 2. **学生/个人开发者**：从方案一开始，所有代理用最便宜的模型，验证工作流后再考虑升级 3. **小团队**：用方案二，总监用强模型、其他人用经济模型 4. **测试模型兼容性**：先用 `/start` 跑一遍引导流程，观察 agent 的响应质量和格式是否正确 --- ## 使用方式 ### 日常开发流程 ``` 1. 启动项目 $ opencode > /start # 首次使用，配置项目 2. 日常开发 > /dev-story # 开始开发一个用户故事 > /code-review # 代码审查 > /story-done # 完成用户故事 3. 里程碑 > /milestone-review # 里程碑审查 > /release-checklist # 发布前检查 ``` ### 典型工作流示例 #### 从零开始做一个新游戏 ``` /start → 选择"我没有明确想法" /brainstorm → 探索游戏创意，确定方向 /design-system → 设计核心系统 /create-epics → 拆分为史诗 /create-stories → 进一步拆为用户故事 /dev-story → 逐个开发 ``` #### 给现有项目加入 AI 工作流 ``` /project-stage-detect → 分析项目当前阶段 /adopt → 选择性导入需要的工作流组件 /code-review → 审查现有代码 /tech-debt → 评估技术债务 ``` ### 协作模式 每个代理遵循严格的协作协议： 1. **询问** — 代理先提问理解需求 2. **展示选项** — 给出 2-4 个方案及利弊分析 3. **用户决策** — 你来做最终选择 4. **草稿** — 代理先展示工作成果草稿 5. **审批** — 没有你的批准，不会写入任何文件 ### 文件结构 ``` AGENTS.md # OpenCode 项目主配置（含编码规则） opencode.json # 代理定义、权限规则 .opencode/ agents/ # 49 个代理定义 (markdown + YAML frontmatter) skills/ # 72 个技能命令 (子目录/SKILL.md) .claude/ # 原始 Claude Code 配置（保留，不影响 OpenCode） agents/ skills/ rules/ hooks/ src/ # 游戏源代码 assets/ # 游戏资产 design/ # 游戏设计文档 docs/ # 技术文档 tests/ # 测试套件 prototypes/ # 原型（与 src/ 隔离） production/ # 制作管理（Sprint、里程碑） ``` --- ## 技能命令一览 在 OpenCode 中输入 `/` 查看 72 个可用技能： **引导与导航** `/start` `/help` `/project-stage-detect` `/setup-engine` `/adopt` **游戏设计** `/brainstorm` `/map-systems` `/design-system` `/quick-design` `/review-all-gdds` `/propagate-design-change` **美术与资产** `/art-bible` `/asset-spec` `/asset-audit` **UX 与界面设计** `/ux-design` `/ux-review` **架构** `/create-architecture` `/architecture-decision` `/architecture-review` `/create-control-manifest` **故事与冲刺** `/create-epics` `/create-stories` `/dev-story` `/sprint-plan` `/sprint-status` `/story-readiness` `/story-done` `/estimate` **审查与分析** `/design-review` `/code-review` `/balance-check` `/content-audit` `/scope-check` `/perf-profile` `/tech-debt` `/gate-check` `/consistency-check` **QA 与测试** `/qa-plan` `/smoke-check` `/soak-test` `/regression-suite` `/test-setup` `/test-helpers` `/test-evidence-review` `/test-flakiness` `/skill-test` `/skill-improve` **制作管理** `/milestone-review` `/retrospective` `/bug-report` `/bug-triage` `/reverse-document` `/playtest-report` **发布** `/release-checklist` `/launch-checklist` `/changelog` `/patch-notes` `/hotfix` **创意与内容** `/prototype` `/onboard` `/localize` **团队协作**（多代理协调单个功能） `/team-combat` `/team-narrative` `/team-ui` `/team-release` `/team-polish` `/team-audio` `/team-level` `/team-live-ops` `/team-qa` --- ## 迁移内容明细 | 组件 | 原始格式 (Claude Code) | 适配格式 (OpenCode) | 关键变更 | |------|----------------------|--------------------|---------| | **Agents (49)** | `.claude/agents/*.md` | `.opencode/agents/*.md` | frontmatter 重构：`mode: subagent`，移除 `memory`/`disallowedTools`/`skills` 字段 | | **Skills (72)** | `.claude/skills/*/SKILL.md` | `.opencode/skills/*/SKILL.md` | 添加 `compatibility: opencode`，移除 `allowed-tools`/`user-invocable` 字段 | | **Rules (11)** | `.claude/rules/*.md` (路径自动触发) | `AGENTS.md` (内联整合) | 路径规则整合为文档指引，由 agent 自行遵守 | | **Hooks (12)** | `.claude/settings.json` + bash 脚本 | `opencode.json` (permissions) | 仅迁移权限规则，bash 钩子暂未适配 | | **项目配置** | `CLAUDE.md` | `AGENTS.md` + `opencode.json` | 项目说明和编码标准合并到 AGENTS.md | ### 工具引用替换 | Claude Code 工具 | OpenCode 替换 | 说明 | |-----------------|--------------|------| | `Task` (子代理) | `spawn_agent` | 启动子代理执行任务 | | `AskUserQuestion` | 文本选项提示（编号列表） | 向用户展示选项，等待回复 | | `WebSearch` | `websearch` | 网页搜索 | | `Read` / `Write` / `Edit` | `read` / `write` / `edit` | 文件操作（小写） | | `Glob` / `Grep` | `glob` / `grep` | 文件搜索和内容搜索 | --- ## 已知限制与需要帮助的地方 > 🙏 **如果你有 OpenCode 实际使用经验，请帮助完善！** ### 已知限制 1. **Hooks 未适配**：原始项目的 12 个 bash 钩子（提交验证、资产校验、会话管理、审计追踪）暂未迁移到 OpenCode 的 hook 系统 2. **Rules 无自动触发**：Claude Code 的路径规则会按文件路径自动触发，OpenCode 版整合到 `AGENTS.md` 中作为文档指引，需要 agent 自行遵守 3. **Skill 参数传递**：部分 skill 使用了 Claude Code 的 `argument-hint` 机制，OpenCode 中可能需要手动传参 4. **Agent 权限隔离**：Claude Code 的 `disallowedTools` 字段在 OpenCode 中无直接对应，权限控制依赖 `opencode.json` 中的全局规则 5. **模型行为差异**：非 Anthropic 模型对 prompt 的理解可能不同，部分 agent 的行为可能需要调整 prompt 内容 ### 最需要帮助的方向 | 优先级 | 方向 | 说明 | |--------|------|------| | 🔴 高 | **实际测试** | 在真实项目中运行全部 skill 和 agent，报告异常 | | 🔴 高 | **模型兼容性测试** | 测试不同模型下 agent 的响应质量，推荐最佳模型搭配 | | 🟡 中 | **Hooks 适配** | 将 `.claude/hooks/` 下的 12 个 bash 脚本适配为 OpenCode hook 格式 | | 🟡 中 | **Prompt 调优** | 根据模型差异调整 agent prompt，确保输出格式一致 | | 🟢 低 | **权限调优** | 验证 `opencode.json` 中的权限规则合理性 | | 🟢 低 | **文档补充** | 补充更多使用示例和常见问题解答 | ### 如何贡献 - **提交 Issue**：[Gitee Issue](https://gitee.com/ooooinfo/Claude-Code-Game-Studios/issues) 或 [GitHub Issue](https://github.com/Donchitos/Claude-Code-Game-Studios/issues) - **提交 PR**：Fork 项目 → 修改 → 提交 Pull Request - **分享经验**：在任何平台分享你使用本项目的经验，帮助其他人避坑 --- ## 原始项目信息 本项目适配自 **Claude Code Game Studios**，以下是原始项目的核心信息： - **原始仓库**：[Donchitos/Claude-Code-Game-Studios](https://github.com/Donchitos/Claude-Code-Game-Studios) - **原作者**：Donchitos - **协议**：MIT License - **框架**：Anthropic Claude Code - **设计理念**：MDA Framework、Self-Determination Theory、Flow State Design、Bartle Player Types、Verification-Driven Development 原始项目的设计理念： - **MDA Framework** — Mechanics, Dynamics, Aesthetics 分析游戏设计 - **Self-Determination Theory** — Autonomy, Competence, Relatedness 驱动玩家动机 - **Flow State Design** — 挑战-技能平衡维持玩家沉浸 - **Bartle Player Types** — 受众定位与验证 - **Verification-Driven Development** — 测试先行，然后实现 --- ## 支持原作者 如果你觉得这个项目有价值，请支持原始作者 Donchitos：

Buy Me a Coffee   GitHub Sponsors

- **[Buy Me a Coffee](https://www.buymeacoffee.com/donchitos3)** — 一次性支持 - **[GitHub Sponsors](https://github.com/sponsors/Donchitos)** — 持续赞助 --- ## License MIT License. See [LICENSE](LICENSE) for details.