用途:在 Codex CLI 或 Codex app 中,当用户明确要求子代理、并行代理、逐点审查、多代理计划或自定义代理时,协调有边界的子代理工作,保持主线程干净、可问责、模型中立。
主要能力:提供决策树判断是否应生成子代理;覆盖并行代码审查、大型研究或代码库探索、多步实现、测试与日志分流、安全与权限场景、重复失败诊断、风险工作完成检查等情形;包含委派策略、Codex 机制、提示模板与来源说明等参考文档,以及本地预检脚本 scripts/detect_codex_surface.py。
使用方式:仅在 Codex CLI 或 Codex app 会话中使用。先按决策树逐项判断:非 Codex 环境应停止,不得用其他模型或工具模拟;未明确要求子代理时不要生成;明确要求时先读 references/delegation-policy.md,做简短本地计划,保留关键路径任务在本地,只委派可独立运行的有限工作。涉及设置、自定义代理、/agent、沙箱行为或 [agents] 配置时先读 references/codex-mechanics.md;需要提示示例时读 references/patterns.md。
适用场景:读多、噪声大或可独立验证的工作,如探索、分流、测试、日志分析、审查、总结和完成检查;写操作并行仅在文件或模块所有权清晰且互不重叠时使用。
限制:子代理在 Codex 中为显式选择加入,普通工作不应自动生成;任务耦合时更多代理可能更慢或更贵;递归委派易过度;子代理摘要只是证据而非证明,高风险结论需本地验证;子代理继承父级沙箱策略,子级审批失败可能影响父工作流;模型名称会过时,应围绕任务需求与继承策略而非固定模型版本。其他平台或未知 Codex 界面暂未提供支持。