合并 master 最新变更

.codex/README.md

@@ -0,0 +1,16 @@
+# 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/` 冲突，以代码和最新文档为准，并修正过期工具说明。

.codex/plugins/game-studio/__init__.py

@@ -1,8 +1,8 @@
-"""Hermes wrapper for the OpenAI Codex Game Studio plugin.
+"""Metadata bridge for the bundled Codex Game Studio project plugin.
 
-This plugin was imported from a Codex curated plugin cache. It exposes the
-plugin's bundled SKILL.md files as Hermes plugin skills using qualified names
-like `game-studio:phaser-2d-game`.
+The manifest and bundled ``SKILL.md`` files are the source of truth. This
+module only exposes their descriptions to a compatible plugin host and keeps
+the project resource bundle free of runtime-specific behavior.
 """
 
 from __future__ import annotations