必须为每个仓库初始化 git 并在 codex 中单独创建项目空间，通过 agents.md 明确职责、以资料中枢为协作锚点，严格按后端→文档→pc后台→app 的顺序执行跨仓库任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Codex 里真正管理多个代码仓库，不能只靠把文件夹拖进去就完事——Codex 不会自动识别哪些是独立仓库、哪些该联动修改、哪些必须隔离操作。如果没提前配置好项目结构和权限边界，它可能把 frontend 的组件误当成 backend 的路由去重构，或者在 docs 里改了接口描述却漏掉 sdk 类型同步。
第一步：确认每个仓库都是独立 Git 项目
打开终端，依次进入你打算纳入 Codex 的每个代码目录，运行 git status。如果返回 “fatal: not a git repository”，说明该目录尚未初始化为 Git 仓库。【必须每个仓库都已执行过 git init 或 clone】。Codex 的多仓库能力依赖 Git 工作树机制，非 Git 目录会被忽略或降级为普通文件夹处理。
这一步操作起来很简单，直接在每个仓库根目录下执行 git init 即可，但跳过会导致后续无法启用分支隔离、提交、PR 创建等关键能力。
第二步：在 Codex App 中创建多项目空间
启动 Codex 桌面客户端 → 左侧边栏点击「项目」→ 点击「+ 新建项目」→ 在弹出窗口中选择第一个仓库的根目录（如 D:\b\）→ 命名该项目为「APP」→ 点击「创建」。
重复上述流程，分别为 D:\node\aaaaa-webui\（命名为「PC 后台」）、D:\IDEA\aaaaa-webapi\（命名为「后端 API」）、D:\videCodeing\aaaaa\（命名为「资料中枢」）单独创建项目空间。注意：不要一次性选中四个文件夹创建一个“总项目”，Codex 不支持嵌套式多仓库聚合视图。
每个项目空间对应一个 Git 工作树实例，彼此进程隔离、状态独立。这是避免任务混淆的物理前提。
第三步：设置资料中枢作为协作锚点
方法一：用 AGENTS.md 统一声明仓库职责
在「资料中枢」项目空间中，打开或新建 AGENTS.md 文件，写明：
- APP：负责移动端页面、离线缓存、设备指纹采集；
- PC 后台：复用 SDK 接口，禁止直接调用后端 HTTP 地址；
- 后端 API：所有字段命名以 snake_case 为准，错误码统一定义在 errors.go；
- 资料中枢：接口变更必须先更新 docs/api/README.md，再通知其他三方同步。
方法二：在 Codex 对话中强制引用该文档
每次发起跨仓库任务时，在提示词开头加一句：“请严格参照 D:\videCodeing\aaaaa\AGENTS.md 中定义的职责分工执行”。Codex 会将其作为上下文约束，而不是仅靠文件路径猜测意图。
不设资料中枢，Codex 就像没有交通规则的十字路口——车都在跑，但没人知道谁该让行。
第四步：执行跨仓库任务时明确依赖顺序
第一步：先让 Codex 进入「后端 API」项目空间，生成新接口并提交到 feat/device-check 分支；
第二步：切换到「资料中枢」项目空间，更新 docs/api/README.md 和 接口版本变更记录.md；
第三步：再进入「PC 后台」项目空间，基于新文档生成 SDK 调用代码；
第四步：最后进入「APP」项目空间，完成相同逻辑的移动端适配。
这个顺序不可颠倒。如果先改前端，Codex 可能基于旧契约生成字段访问代码，而此时后端尚未提供该字段，导致运行时报错。Codex 不会主动检查跨项目 API 兼容性，它只按你指定的路径和顺序执行。
每步完成后，务必在对应项目空间内点击「查看变更」确认 Diff 内容，再手动点击「Commit & Push」——Codex 不会自动推送未审核的修改。
