mirror of https://github.com/merlinhu1/codex-game-studio.git synced 2026-08-25 07:54:34 +02:00

Files

T

e06453bcab feat: prune template authoring artifacts and expand localized guides (#15 )

* docs: remove stale research design note

* feat: prune maintainer artifacts during init

* docs: expand localized README guides

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>

2026-07-10 23:14:20 +10:00

3.8 KiB

Raw Permalink Blame History

Codex Game Studio

把一次 Codex 会话变成结构化、本地优先的游戏工作室。

Codex Game Studio 是一个 TypeScript CLI。它为游戏项目创建 Codex 可直接使用的工作区：角色提示词、工作流提示词、项目文件、任务状态和验证信息都保存在普通的、可通过 Git 审查的文件中。

它不是游戏引擎，也不是托管式项目管理器。它的目标是给 Codex 更清晰的工作契约，同时让创意决策和最终审查继续由人类掌握。

快速开始

需要 Node.js 24 或更新版本。run <role> 需要 Codex CLI。

git clone git@github.com:merlinhu1/codex-game-studio.git signal-cartographer
cd signal-cartographer
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
./codex-game-studio validate

在真正运行 Codex 之前，可以先检查角色提示词：

./codex-game-studio run producer \
  "Create the initial market overview." --print-prompt

详细命令说明见英文版 User Guide。

为什么需要它

空白 AI 编程聊天很灵活，但游戏开发需要更稳定的工作室结构：

制作人需要里程碑、交接和发布检查。
设计师需要 GDD、系统规格、玩家旅程和调参循环。
工程师需要边界清晰的实现提示词和验证门槛。
美术、QA、音频、本地化和运营也需要各自的上下文。
审查者需要能在 Git 中检查的文件，而不是消失在聊天历史里的决策。

Codex Game Studio 把这些结构变成本地项目文件，让 Codex 能读取，也让人类能审查。

你会得到什么

能力	含义
本地项目脚手架	在当前仓库根目录创建确定性的游戏工作区。
Codex 原生工作室角色	为制作、设计、工程、美术、QA、本地化和发布提供聚焦的角色提示词。
工作流提示词	提供市场、数据、规格、交接、发布检查、UI 审查等可复用提示词。
引擎覆盖层	添加 Godot、Unity 或 Unreal 上下文，但不把本项目变成引擎包装器。
文件化任务状态	在 `.codex/**` 下保存任务、锁和运行元数据。
执行前检查	支持 dry-run 和打印提示词，避免直接让 Codex 修改项目。
严格验证	检测过期生成文件、格式错误元数据、缺失资源和未来功能漂移。

深入阅读

需要	文档
安装、命令、工作流和验证	User Guide
使用场景	Examples
完整文档地图	Docs Index

项目状态

Codex Game Studio 当前支持确定性项目脚手架、Codex 角色执行、工作流提示词渲染、文件化任务编排，以及仓库/项目验证。

它目前不提供 planner 或 next 命令、遥测、托管编排、无限并行、强制输出所有权，或生成 CODEX.md / project_orchestrator.md。

许可证

Codex Game Studio 使用 MIT License。见 LICENSE。

3.8 KiB Raw Permalink Blame History