名称: agent-team 描述: 用于涉及多个文件、PR审查、迁移规划、失败测试排查、不熟悉代码库探索的复杂Codex编码任务,或者并行只读探索和独立审查能提高质量的情况。不要用于简单的单文件编辑或明显的小修复。
Agent Team 编排
使用此技能决定Codex何时应该为复杂编码任务使用子代理。
目标是有控制的委托,而非最大限度的委托。
任务分类
在采取行动之前,将任务分类为以下之一:
简单(SIMPLE)
单文件更改,明显的错误修复,小重构,格式化更改,或具有清晰本地上下文的任务。
不要使用子代理。直接解决。
复杂-读(COMPLEX-READ)
调查、审查、探索或验证。
例如:
- PR审查
- 不熟悉代码库探索
- 失败或不稳定的测试排查
- 迁移规划
- 事件或日志分析
- 依赖/API验证
- 多模块影响分析
当工作可以干净分离时,使用专注的只读子代理。
复杂-写(COMPLEX-WRITE)
跨多个文件、模块、包或服务的实现。
首先使用只读探索。然后创建计划。默认最多使用一个写入者。编辑后,使用审查式的子代理检查差异、测试和剩余风险。
委托策略
对于简单任务:
- 不要生成子代理。
- 直接解决。
对于复杂-读任务:
- 在有用时使用只读子代理。
- 倾向于专注的角色:
- 探索者:映射文件、流程、依赖关系和可能的更改点。
- 审查者:检查正确性、安全性、回归风险、边缘情况和缺失的测试。
- 文档研究者:验证外部API、框架行为、依赖行为或特定版本的假设。
- 等待子代理结果。
- 在建议行动之前综合发现。
对于复杂-写任务:
- 首先使用只读探索。
- 让主代理创建实现计划。
- 默认只使用一个写入者/工作者。
- 在编辑后审查结果。
- 让主代理做出最终决定。
安全和预算规则
- 不要为琐碎任务使用子代理。
- 倾向于只读子代理。
- 避免递归委托。
- 使用所需的最少子代理数量。
- 保持子代理提示狭窄且基于证据。
- 让子代理给出简洁的总结,而非转录。
- 将子代理视为助手,而非决策者。
- 主代理必须做出最终决定。
最终响应格式
当使用此技能时,包括:
- 任务分类。
- 使用的子代理,或未使用子代理的原因。
- 关键发现。
- 审查或更改的文件。
- 运行的测试,或仍缺失的测试。
- 剩余风险。
- 推荐下一步行动。