agent-teamSkill agent-team

为复杂Codex编码任务提供子代理编排策略,通过并行只读探索和独立审查提高代码质量,适用于PR审查、迁移规划、失败测试排查等场景。关键词: Codex, 子代理, 团队协作, 只读代理, PR审查, 代码探索, 测试排查, 委托策略

AI智能体 0 次安装 15 次浏览 更新于 7/15/2026

名称: agent-team 描述: 用于涉及多个文件、PR审查、迁移规划、失败测试排查、不熟悉代码库探索的复杂Codex编码任务,或者并行只读探索和独立审查能提高质量的情况。不要用于简单的单文件编辑或明显的小修复。

Agent Team 编排

使用此技能决定Codex何时应该为复杂编码任务使用子代理。

目标是有控制的委托,而非最大限度的委托。

任务分类

在采取行动之前,将任务分类为以下之一:

简单(SIMPLE)

单文件更改,明显的错误修复,小重构,格式化更改,或具有清晰本地上下文的任务。

不要使用子代理。直接解决。

复杂-读(COMPLEX-READ)

调查、审查、探索或验证。

例如:

  • PR审查
  • 不熟悉代码库探索
  • 失败或不稳定的测试排查
  • 迁移规划
  • 事件或日志分析
  • 依赖/API验证
  • 多模块影响分析

当工作可以干净分离时,使用专注的只读子代理。

复杂-写(COMPLEX-WRITE)

跨多个文件、模块、包或服务的实现。

首先使用只读探索。然后创建计划。默认最多使用一个写入者。编辑后,使用审查式的子代理检查差异、测试和剩余风险。

委托策略

对于简单任务:

  • 不要生成子代理。
  • 直接解决。

对于复杂-读任务:

  • 在有用时使用只读子代理。
  • 倾向于专注的角色:
    • 探索者:映射文件、流程、依赖关系和可能的更改点。
    • 审查者:检查正确性、安全性、回归风险、边缘情况和缺失的测试。
    • 文档研究者:验证外部API、框架行为、依赖行为或特定版本的假设。
  • 等待子代理结果。
  • 在建议行动之前综合发现。

对于复杂-写任务:

  1. 首先使用只读探索。
  2. 让主代理创建实现计划。
  3. 默认只使用一个写入者/工作者。
  4. 在编辑后审查结果。
  5. 让主代理做出最终决定。

安全和预算规则

  • 不要为琐碎任务使用子代理。
  • 倾向于只读子代理。
  • 避免递归委托。
  • 使用所需的最少子代理数量。
  • 保持子代理提示狭窄且基于证据。
  • 让子代理给出简洁的总结,而非转录。
  • 将子代理视为助手,而非决策者。
  • 主代理必须做出最终决定。

最终响应格式

当使用此技能时,包括:

  1. 任务分类。
  2. 使用的子代理,或未使用子代理的原因。
  3. 关键发现。
  4. 审查或更改的文件。
  5. 运行的测试,或仍缺失的测试。
  6. 剩余风险。
  7. 推荐下一步行动。