Files
kdletters 9476ff7648
Project CI / Frontend tests (push) Successful in 4m5s
Project CI / Repository checks (push) Successful in 4m23s
Project CI / Backend tests (push) Successful in 5m1s
Project CI / Native shell tests (push) Failing after 10m54s
迁移仓库工具资源到 Codex 并固化执行边界
将 .hermes 工具资源迁移至 .codex

同步代码、文档与 RAG 路径引用

补充任务范围、验收与时间盒执行规则
2026-08-27 13:55:25 +08:00

1.5 KiB

Genarrative Codex 项目工具

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

目录约定

  • .codex/skills/ 是项目专属 skill 根目录。每个 skill 以目录中的 SKILL.md 为入口,配套的参考资料和脚本放在同一目录下。
  • .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/ 冲突,以代码和最新文档为准,并修正过期工具说明。