codex 通过多 agent 并行协作实现半天全栈开发：manager 依 agents.md 拆解任务并 spawn 子 agent，各 agent 在 git worktree 隔离环境、skill 注入变量、sandbox 路径限制下并发执行，最终由 manager 校验、测试、合并完成闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 Codex 在半天内一个人完成 Spring Boot + React + DeepSeek 全栈 AI 批改平台的开发，必须依赖其多 Agent 并行调度机制——不是靠单个大模型硬扛，而是把 63 个 Java 文件、21 个 TSX 组件、9 张数据库表、30+ 接口全部拆解为可隔离、可并发、可验证的原子任务，由不同子 Agent 同时推进，且彼此不抢上下文、不混状态、不丢进度。
主从架构：Manager 如何拆解并分发全栈任务
第一步：在项目根目录创建 【AGENTS.md】，明确声明 Manager 的全局约束（如“后端代码仅写入 /backend/src/main/java”，“前端组件只生成到 /frontend/src/components”）。这一步不可跳过，否则子 Agent 会越界写文件或覆盖已有模块。
第二步：运行 codex plan --task "搭建AI作业批改平台"。Manager 自动输出结构化任务树，例如：[Backend]→建表迁移→API路由→Service逻辑；[Frontend]→登录页→作业列表→批改面板；[AI]→选择题策略→主观题评分→反馈生成。每个叶子节点带唯一 task_id 和依赖标记。
第三步：执行 codex spawn_agent --from-plan，Manager 立即 fork 出 5 个子 Agent 实例，分别绑定不同 Skill（如 PostgreSQLMigrator、ReactComponentGen、DeepSeekPromptEngineer），并为每个实例分配独立 git worktree 目录。这一步实际耗时不到 2 秒，但若省略 worktree 隔离，多个子 Agent 同时写 /backend/src 会导致文件冲突和 Git 状态混乱。
子 Agent 执行层：为什么必须物理隔离上下文
方法一：用 git worktree 创建独立分支空间
每个子 Agent 启动时自动执行 git worktree add ../worktrees/backend-api api-v1 → 进入该目录后所有读写操作与主分支完全隔离。这是 Codex 默认启用的硬隔离机制，【一旦关闭，多个子 Agent 修改同一文件将触发不可逆的 Git 合并冲突】。
方法二：通过 Skill 封装环境变量注入
比如 DatabaseAgent 的 Skill 定义中强制设置 DB_URL=postgresql://localhost:5432/aigrader_api，而 FrontendAgent 的 Skill 则注入 REACT_APP_API_BASE=https://localhost:8080。这种注入在 spawn 时完成，避免手动配置遗漏。
方法三：限制文件系统访问范围
在 AGENTS.md 中为每个子 Agent 指定 sandbox_path，例如 frontend-agent: { sandbox_path: "/frontend" }。Codex 内核会在运行时拦截任何超出该路径的 fs.open() 调用并报错——这是防止误删 public/index.html 的最后一道闸。
结果汇入与冲突仲裁：Manager 怎么收尾
① 所有子 Agent 完成后，自动向 Manager 发送
② Manager 扫描各 worktree 的 git status，比对是否所有 task_id 对应的文件都已 commit。若有未提交项，立即中止汇入流程并打印缺失路径。
③ 执行 codex merge-worktrees，Manager 启动三阶段合并：先校验 schema 兼容性（对比 /backend/src/main/resources/schema.sql 与 /frontend/public/schema.json）→ 再运行预设的 cross-layer test（如检查 API 返回字段是否被前端组件引用）→ 最后调用 git merge --no-ff 将各 worktree 分支合入 main。
这一步完成后，/backend 和 /frontend 目录已同步更新，PostgreSQL 表结构就绪，React 组件能正确调用新接口，DeepSeek 提示词已注入 service 层——整个全栈骨架自动就位。
