mirror of
https://github.com/merlinhu1/codex-game-studio.git
synced 2026-08-25 07:54:34 +02:00
78 lines
3.4 KiB
Markdown
78 lines
3.4 KiB
Markdown
# Codex Game Studio
|
|
|
|
**把一次 Codex 会话变成结构化、本地优先的游戏工作室。**
|
|
|
|
[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md)
|
|
|
|
Codex Game Studio 是一个 TypeScript CLI。它为游戏项目创建 Codex 可直接使用的工作区：角色提示词、工作流提示词、项目文件、任务状态和验证信息都保存在普通的、可通过 Git 审查的文件中。
|
|
|
|
它不是游戏引擎，也不是托管式项目管理器。它的目标是给 Codex 更清晰的工作契约，同时让创意决策和最终审查继续由人类掌握。
|
|
|
|
## 快速开始
|
|
|
|
需要 Node.js 24 或更新版本。`run <role>` 需要 Codex CLI。
|
|
|
|
```sh
|
|
git clone git@github.com:merlinhu1/codex-game-studio.git
|
|
cd codex-game-studio
|
|
npm install
|
|
npm run build
|
|
|
|
./codex-game-studio init --name "Signal Cartographer" --engine godot --mode prototype --non-interactive \
|
|
--concept "A compact puzzle game about routing trains through haunted switchyards"
|
|
|
|
./codex-game-studio status --project projects/signal-cartographer
|
|
./codex-game-studio validate --project projects/signal-cartographer
|
|
```
|
|
|
|
在真正运行 Codex 之前，可以先检查角色提示词：
|
|
|
|
```sh
|
|
./codex-game-studio run producer --project projects/signal-cartographer \
|
|
"Create the initial market overview." --print-prompt
|
|
```
|
|
|
|
详细命令说明见英文版 [User Guide](../user-guide.md)。
|
|
|
|
## 为什么需要它
|
|
|
|
空白 AI 编程聊天很灵活，但游戏开发需要更稳定的工作室结构：
|
|
|
|
- 制作人需要里程碑、交接和发布检查。
|
|
- 设计师需要 GDD、系统规格、玩家旅程和调参循环。
|
|
- 工程师需要边界清晰的实现提示词和验证门槛。
|
|
- 美术、QA、音频、本地化和运营也需要各自的上下文。
|
|
- 审查者需要能在 Git 中检查的文件，而不是消失在聊天历史里的决策。
|
|
|
|
Codex Game Studio 把这些结构变成本地项目文件，让 Codex 能读取，也让人类能审查。
|
|
|
|
## 你会得到什么
|
|
|
|
| 能力 | 含义 |
|
|
| --- | --- |
|
|
| 本地项目脚手架 | 在当前仓库根目录创建确定性的游戏工作区。 |
|
|
| Codex 原生工作室角色 | 为制作、设计、工程、美术、QA、本地化和发布生成聚焦的角色提示词。 |
|
|
| 工作流提示词 | 提供市场、数据、规格、交接、发布检查、UI 审查等可复用提示词。 |
|
|
| 引擎覆盖层 | 添加 Godot、Unity 或 Unreal 上下文，但不把本项目变成引擎包装器。 |
|
|
| 文件化任务状态 | 在 `.codex/**` 下保存任务、锁和运行元数据。 |
|
|
| 执行前检查 | 支持 dry-run 和打印提示词，避免直接让 Codex 修改项目。 |
|
|
| 严格验证 | 检测过期生成文件、格式错误元数据、缺失资源和未来功能漂移。 |
|
|
|
|
## 深入阅读
|
|
|
|
| 需要 | 文档 |
|
|
| --- | --- |
|
|
| 安装、命令、工作流和验证 | [User Guide](../user-guide.md) |
|
|
| 使用场景 | [Examples](../examples/README.md) |
|
|
| 完整文档地图 | [Docs Index](../README.md) |
|
|
|
|
## 项目状态
|
|
|
|
Codex Game Studio 当前支持确定性项目脚手架、Codex 角色执行、工作流提示词渲染、文件化任务编排，以及仓库/项目验证。
|
|
|
|
它目前不提供 planner 或 `next` 命令、遥测、托管编排、无限并行、强制输出所有权，或生成 `CODEX.md` / `project_orchestrator.md`。
|
|
|
|
## 许可证
|
|
|
|
Codex Game Studio 使用 MIT License。见 [`LICENSE`](../../LICENSE)。
|