游戏研发工作室 linnn-nb/Codex-DSH-Game-Studios

Codex + DSH Game Studios

English · 简体中文

把你的 Codex 工作区变成游戏研发工作室。

14 个按需角色 · 29 个专业 Skill · 一条完整的功能交付流程

从玩家目标出发，推进设计、实现、集成、评审与 QA。Codex 负责理解、推理和执行，DeepSeek Harness（DSH） 负责工作流编排。项目持续保存决策、依赖和交付历史，换一个会话也能接着做。

面向独立开发者与小团队，流程可以从原型逐步扩展到正式生产。

快速上手 · 工作原理 · 引擎支持 · English

为什么需要它

做游戏需要把设计、代码、美术、动画、音频和测试连起来。功能越多，越需要知道：项目已经有什么，这次修改影响什么，需要哪些专业能力，以及凭什么判断已经完成。

Codex + DSH Game Studios 为这些工作提供持久的工程结构。描述你希望玩家获得的体验，建立 Feature Specification，按需启用专业角色，再用真实项目工具完成实现与验收。

你决定游戏的创作方向，Studio 帮你把实现、依赖与验收标准保持一致。

包含什么

| 能力 | 提供的内容 |
| 14 个角色 | 按功能启用制作、设计、工程、内容、QA 与发布能力 |
| 29 个 Skill | 按需加载游戏研发知识、Checklist 与引擎经验 |
| 功能规划 | 目标、玩家体验、范围、验收条件、依赖、风险与测试计划 |
| 原生 DSH 执行 | 依赖顺序、并行任务、有界重试、取消与工作流日志 |
| 项目记忆 | 持久保存功能、任务、决策、风险、Bug、债务、资产、构建与测试 |
| 质量门禁 | Ready、集成、评审、QA，以及按需启用的运行、画面等检查 |
| 三种项目模式 | PROTOTYPE、PRODUCTION、STUDIO |
| 引擎适配 | ForgeaX、Unreal、Unity、Godot 与自定义引擎 |
| 保留的专业资料 | 49 份上游领域参考、74 份历史工作流和 46 个模板文件 |

工作原理

flowchart LR
I[你的想法或 Bug] --> C[Codex 理解并制定规格]
C --> F[Feature 与 Task 图]
F --> D[DSH 编排必要任务]
K[相关 Skill 与项目记忆] --> C
K --> D
D --> E[Codex 或已注册项目工具]
E --> Q[集成 评审 QA]
Q --> G[必要质量门禁]
G --> R[Done 构建与发布记录]
G --> M[更新项目记忆]

Codex 沿用你配置的模型，Harness 不绑定具体模型系列。

DSH 负责工作流执行和任务生命周期；领域核心负责功能契约、角色选择、项目状态和验收规则；Skill 提供专业游戏研发知识。

Role 表示一个任务的职责。只有工作需要独立上下文时，才启动对应执行任务。

你的研发工作室

| 专业领域 | 角色 |
| 制作 | Producer / Orchestrator |
| 设计 | Game Design；Systems Design |
| 工程 | Gameplay；Engine / Systems；Tools / Pipeline |
| 内容 | Art / Technical Art；Animation / VFX；UI / UX；Audio；Narrative |
| 质量 | QA；Performance / Build / Release |
| 数据 | Analytics / LiveOps |

角色路由跟随功能范围。Boss 第二阶段可能需要战斗设计、玩法、动画、音频、UI 和 QA；设置按钮修复只需要 UI / UX 与 QA。

Skill 覆盖 Gameplay、AI、网络、安全、无障碍、本地化及其他专业领域。可浏览 角色目录 与 Skill 目录。

从原型到正式生产

| 模式 | 适用项目 | 流程 |
| PROTOTYPE | Game Jam、机制验证、实验原型 | 实现与验收 QA 可以只有两个任务 |
| PRODUCTION | 独立游戏、Vertical Slice | 独立的集成、评审与 QA |
| STUDIO | 长期项目与更大范围 | Milestone、Version、Epic、跨专业依赖和构建来源 |

玩家可见修改触发运行与画面检查，性能预算触发性能检查。缺少必需证据，功能不能进入 Done。

需求 → 规格 → Ready → 实现 → 集成 → 评审 → QA → Done 额外门禁按功能需要启用 Done → 已验证构建 → 本地发布记录

快速上手

核心需要 Python 3.9+，没有第三方 Python 依赖。

git clone https://github.com/linnn-nb/Codex-DSH-Game-Studios.git
cd Codex-DSH-Game-Studios
python3 scripts/verify.py --unit-only

用仓库提供的可执行行为样例体验功能规划：

python3 scripts/create_demo.py /tmp/codex-studio-demo --mode PROTOTYPE
python3 scripts/studio.py --project /tmp/codex-studio-demo plan examples/prototype-small-bug.json
python3 scripts/studio.py --project /tmp/codex-studio-demo route prototype-settings

这个样例用于展示路由和行为验收，与 ForgeaX 游戏案例分别交付。

执行工作流前，按 固定 DSH 安装基线 构建 checkout。需要 Node.js ^22.19.0 || >=24.0.0 与 pnpm 11.7.0：

python3 scripts/studio.py --project /tmp/codex-studio-demo run prototype-settings --dsh-root /path/to/deepseek-harness
python3 scripts/studio.py --project /tmp/codex-studio-demo status prototype-settings

自然语言规划和 AI 编码任务还需要安装并登录 Codex CLI。使用 model: "inherit" 沿用你的 Codex 模型配置。完整流程见 中文使用指南 或 English setup。

接入自己的游戏

从 examples/project.json 开始，配置实际引擎、代码根目录，以及真实构建、测试和观察命令。

python3 scripts/studio.py --project /path/to/game init /path/to/project.json
python3 scripts/studio.py --project /path/to/game attach
python3 scripts/studio.py --project /path/to/game doctor
python3 scripts/studio.py --project /path/to/game intake "给现有 Boss 增加第二阶段"

Intake 返回通过校验的 Feature ID。查看路由后，再通过 DSH 执行。接入时保留游戏已有的项目指令。

| 命令 | 用途 |
| intake / plan | 从自然语言或结构化规格建立功能 |
| route / schedule | 查看角色、依赖与可安全并行的任务 |
| run / status | 通过 DSH 执行并追踪进度 |
| entity / export | 维护项目记录与可读快照 |
| backup / restore / recover | 保存状态并在确认停止后恢复 |
| build / release | 验证产物并记录本地发布 |

完整命令可查看 python3 scripts/studio.py --help。

引擎支持

| 引擎 | 已提供能力 | 已记录验证范围 |
| ForgeaX | 原生项目及版本检查、专用 Skill、CLI 证据桥接 | 0.2.1、0.3.3、0.3.4 环境与 binding 检查；原生 DSH 预检 |
| Unreal Engine | 专业 Skill、项目识别、可配置工具 | 编辑器、目标设备与完整打包需要具体项目验证 |
| Unity | 专业 Skill、项目识别、可配置工具 | 编辑器、目标设备与完整打包需要具体项目验证 |
| Godot | 专业 Skill、项目识别、可配置工具 | 编辑器、目标设备与完整打包需要具体项目验证 |
| Custom | 项目自行声明契约与工具 | A/B/C 中的可执行行为样例 |

ForgeaX 工作流也用于本机 《余烬回收》 案例：第三人称探索、法术战斗、Boss 第二阶段、检查点与插件生成音频。最终 Web ZIP 通过原生输入自动验收。该游戏是独立本机工程，源码与资产没有打包进本仓库；普通桌面 Chrome 的场景加载问题仍需排查。

已验证内容

| 场景 | 已记录结果 | 范围 |
| 新角色功能 | Done；启用 3 个角色 | 移动、跳跃与攻击行为 |
| 现有 Boss 修改 | Done；启用 6 个角色 | 依赖识别、跨专业工作与回归 |
| 小型 UI Bug | Done；启用 2 个角色 | 设置点击与返回导航 |
| 故障恢复 | 通过 | 有界重试、失败传播、续跑与子进程取消 |
| 核心测试 | 已记录基线 58 项通过 | 契约、状态、路由、门禁、产物与适配器 |

A/B/C 的实现任务使用真实 Codex 与原生 DSH。设计和资产事件等辅助步骤使用明确声明的 fixture 工具；集成与 QA 执行真实行为断言。这些结果证明工程行为，画面质量和玩家偏好需要另行验证。

重现真实集成检查：

python3 scripts/verify.py --dsh-root /path/to/deepseek-harness --with-codex --with-intake

真实集成检查使用你的 Codex 账号与模型配置。阅读 测试范围 与 发布范围，了解历史报告的实际含义。

项目结构

AGENTS.md Codex 项目指令 studio/ 功能契约、路由、状态与验收规则 integrations/dsh/ 原生 DSH 工作流适配 roles/ 14 个任务职责 skills/ 29 个专业与引擎 Skill rules/ 共享与按路径适用的工程约束 quality-gates/ 动态验收条件 adapters/ 引擎识别与工具接入 schemas/ Feature、Task、Project、Evidence 契约 examples/ 结构化场景与可执行样例 tests/ 核心及适配器测试 docs/ 架构、上手、迁移与验证范围 upstream/ 固定来源清单与完整上游 Git bundle

每个游戏分别持有权威状态 .project/state.db。公开发行不包含开发机器的活动项目数据库、备份或原始会话归档。

定制与贡献

注册项目的真实工具，补充相关 Skill，调整功能范围，并选取当前游戏需要的流程模式。让改动对应可观察的玩家收益或工程收益。

欢迎贡献引擎适配、专业工作流、可重现测试与文档。参见 CONTRIBUTING.md。

原生 DSH 适配固定在预览版 0.1.6-alpha.1。同一 checkout 同时运行一个 Feature，Feature 内支持无冲突并行。发布命令记录已验证本地产物；商店上传和远程分发需要分别注册实际工具。

致谢与许可

衍生自 Donchitos 的 Claude Code Game Studios，采用 MIT 许可。迁移保留专业游戏研发知识，并围绕 Codex 与 DSH 重构执行方式。

参考来源固定为 b21fa0f7f289fc3e726cf36fb12b9bc1e7a51e4d。详见 架构审计、来源清单、原始仓库恢复说明 与 NOTICE。

MIT 许可。 见 LICENSE。这是独立社区项目。