关于codex子代理的使用提示词,以下是一些关键点和规则,用于指导如何有效地使用子代理来辅助主代理完成任务。

  1. 上下文检索强制:在仓库中查找或定位相关内容时,必须首先使用codebase-retrieval进行语义检索和定位。只有在codebase-retrieval不可用、调用失败或检索结果不足的情况下,才允许使用Grep/Glob或手动读取,并在.codex/tasks/operations-log.md中记录降级原因和影响。
  2. 上下文预算与定位升级:当任务进入“定位/检索”模式时,优先使用codebase-retrieval+精确搜索定位,避免在主窗口连续展开大量文件全文。如果出现多次检索定位仍无法确定下一步动作、打开/浏览文件或精读行数达到阈值、连续两次尝试无实质进展等情况,必须升级策略并留痕。升级动作包括启用1-2个子代理并行定位,每个子代理独立检索并输出候选文件清单+证据指针,主代理吸收必要片段复核后再推进。
  3. 需求对齐与验收契约:在进入阶段2前必须形成“验收契约”,并在实现与交付时逐条对齐。如果存在歧义或主观置信度低于95%,必须先做高价值澄清或给出2-3个可选方案。如果同一问题返工两次或偏差,必须先做“差异分析”并更新验收契约,再继续推进。
  4. 规范性术语约定:本文中的“必须/不得/禁止”表示硬约束,“应/应当/建议”表示默认期望,“可以”表示可选。规则冲突按2.1裁决并留痕取舍,术语定义冲突以本节与“术语定义”条款为准。
  5. 术语定义:“主代理”是当前会话对用户负责、做最终决策/汇总/写操作的执行者;“子代理”是spawn_agent创建的并行协作者,行为约束为不得执行写操作/破坏性命令,允许执行只读验证命令并回传关键输出,只输出分析、定位、证据、建议命令与拟patch,落地修改由主代理执行。
  6. 子代理并行协作:当满足任一触发条件时,主代理必须先做“并行收益评估”并留痕。默认采用“最小并行→按需扩容”,并行度默认2,建议范围1-2,必要时可扩到4-6,建议上限10。触发条件包括可并行子问题、高风险决策需要独立复核、跨领域且单链路易漏项。主代理负责最终决策、汇总与所有写操作,高影响结论必须“双源复核”。若环境限制导致可复现证据不可得,必须记录原因,并改为“保守结论/残余风险 + 下一步验证动作”。主代理必须在operations-log.md留痕每个子代理的agent_id、分工、关键输出摘要,并在结束前输出READY_TO_CLOSE,由主代理close_agent收尾。

标签: none

评论已关闭