Files
Genarrative/.codex
lhk229 571cb00fe4
Project CI / Frontend tests (pull_request) Has been cancelled
Project CI / Repository checks (pull_request) Has been cancelled
Project CI / AI game creator shell web tests (pull_request) Has been cancelled
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Has been cancelled
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Has been cancelled
Project CI / Backend tests (pull_request) Has been cancelled
Project CI / Native shell tests (pull_request) Has been cancelled
Project CI / AI game creator shell Rust smoke (pull_request) Has been cancelled
Project CI / AI game creator shell Rust crates (pull_request) Has been cancelled
新增 external v1 游戏场景生成路由并迁移 AGC 美术包背景阶段
- api-server 新增 POST /api/external/v1/editor/scenes/generations,复用 editor:image-generate scope、幂等键和站内场景生图队列
- editor_project.rs 抽取站内与外部共用的场景生图 payload 构造函数,站内 handler 改为调用共享函数
- 同步更新 external v1 OpenAPI 契约与 MCP 派生排除标记,登记 docs/README.md 索引
- AGC 客户端美术包背景阶段改走新场景路由,stylePreset 固定 custom + customStyle 保留现有风格文案
- external_generation_state 快照与 recovery_scan 账本白名单支持新场景路由
- direct_runtime 背景资源识别同时兼容新场景路由与旧通用路由,新增旧路由回放测试
- 更新 genarrative-external-editor-api skill 参考文档
- 新增主规范、里程碑规范与实施计划三份 SDD 文档
2026-09-24 15:40:30 +00:00
..
2026-05-21 20:21:32 +08:00

Genarrative Codex 项目工具

.codex/ 是仓库级 Codex 工具目录,保存项目共享的 skills、插件资源、hooks 和相关配置模板。它只描述如何协作和加载工具,不承载项目业务知识。

目录约定

  • .codex/skills/ 是项目专属 skill 根目录。每个 skill 以目录中的 SKILL.md 为入口,配套的参考资料和脚本放在同一目录下。
  • spec-driven-development 负责跨模块、公开契约、SpacetimeDB、AGC/Runtime 和复杂 UI 任务的规范先行与逐里程碑验收;具体规则以 docs/ 下的 SDD 工作流和模板为准。
  • .codex/plugins/ 保存随仓库分发的项目插件资源及其参考资料。当前的 game-studio 插件提供浏览器游戏设计、原型、2D/3D 技术栈、素材管线和 playtest 工作流;是否启用遵循当前 Codex 的插件加载机制,不依赖旧工具的环境变量或个人配置脚本。
  • .codex/hooks/、.codex/environments/ 等目录保存项目工具链所需的 hooks 和环境模板;它们不替代项目代码中的运行时配置。
  • 长期有效的产品、架构、接口、排障和协作知识统一放在 docs/ 与 docs/project-memory/,不复制到本目录。

使用边界

进入仓库后先读根目录 AGENTS.md,再按任务路由读取对应 skill。SpacetimeDB 的通用概念、Rust 服务端、CLI、TypeScript 客户端和 MCP 用法由已安装的官方插件提供;项目约束和入口由 .codex/skills/genarrative-spacetimedb/SKILL.md 统一编排。

个人 ~/.codex 配置、凭据、会话、环境变量和本地路径不得复制到仓库。若本目录内容与当前代码或最新 docs/ 冲突,以代码和最新文档为准,并修正过期工具说明。