Files
Genarrative/.codex
k88936 beb3c99240 同步 GPT Image 2.5 契约与工具文档
更新 OpenAPI 与外部编辑器模型说明

补充历史模型兼容解析与参数回退告警约定

将现役 ImageGen 工具脚本切换到 GPT Image 2.5
2026-09-18 23:28:45 +08: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/ 冲突,以代码和最新文档为准,并修正过期工具说明。