垦荒学园
  • 中文

      • Subagents 子代理

      Subagents 让 Codex 将子任务委派给 上下文更小、工具更专 的代理，避免单一长会话既写代码又做审查、既改前端又查生产日志。

      为什么需要子代理？

      单一 Agent 的长会话问题：

      • 上下文膨胀：探索大仓库后，关键约束被挤掉
      • 角色混淆：实现者与审查者「同人」，易忽略自身 bug
      • 工具过多：测试、日志、浏览器 MCP 全挂主 Agent，增加误用概率

      Subagents 通过 分工 缓解上述问题。

      典型模式

      1. 探索型 Subagent

      • 职责：glob/grep、读目录结构、输出架构摘要
      • 不写 patch 或只读沙箱
      • 产出：文件列表、调用链、建议改动点

      主 Agent 收到摘要后再动手改代码，减少盲目读文件。

      2. 审查型 Subagent（Code Review）

      Codex CLI 支持 独立审查 Agent 审阅本地变更（再 commit / push 前）。

      特点：

      • 不继承主会话「我已经改对了」的假设
      • 聚焦 diff、测试缺口、安全风险

      用法参见官方：Run local code review

      3. 专责 MCP Subagent

      例如：

      • Subagent A：仅连接 测试 MCP（跑特定 pytest 配置）
      • Subagent B：仅连接 日志 MCP（查 staging 错误）

      主 Agent 编排：先 B 定位错误栈 → 再 A 验证修复。

      并行 vs 串行

      策略适用
      并行多模块独立探索（前端路由 + 后端 API 各查各的）
      串行有依赖（先定位根因再改代码）

      CLI 文档中的 subagents 能力强调 parallelize complex tasks——适合 monorepo 多包并行扫描。

      设计原则

      1. 窄工具集：子代理不需要的 MCP 不要挂
      2. 明确输出格式：要求 JSON / Markdown 模板，方便主 Agent 解析
      3. 只读优先：探索、审查类默认 read-only 沙箱
      4. 超时与步数限制：防止子代理无限循环

      与 Cloud @codex 的关系

      GitHub PR 上 @codex review 或 @codex fix 可视为 云端编排的专责任务，与本地 Subagents 类似，但运行在远程环境。团队可把 审查规则 写进 AGENTS.md，Cloud 与 CLI 共享。

      下一步