用途：autoresearch 用于自动化研究或“隔夜/在循环中优化 X”的任务。它规划有界、可度量的实验批次，再通过 codex-handoff 委托执行；要求度量一致，只保留经核实的改进，并在明确的资源或收敛限制处停止。
主要能力与编排约定：新会话须在 Plan 模式启动；若实质性更改已批准会话的目标、主指标或方向、基准或正确性命令、写入范围，或硬性资源、成本、回归、收敛限制，也必须先进入 Plan 模式。需要 Plan 模式但未激活时，应请用户切换并停止；已批准且未变更的契约可在 Plan 模式外继续接收新的假设批次。实现必须调用 $codex-handoff，不得退回父级直接实现或其它交接机制，并遵循其主机选择、计划清单、团队规模、验证归属、对账、失败与完成约定。父级负责会话契约、证据综合、假设选择与排序、停止决策；可将只读仓库调查委派出去，但研究工作者返回证据而非假设或计划。父级执行工作限于编排、完整性检查、精简结果复核和下一批次选择。
会话契约：批准前须确定目标、主指标与方向、基准与正确性命令、允许/禁止路径、运行/运行时长/命令/成本/回归限制、收敛窗口和报告节奏。默认：20 次运行、两小时墙钟时间、每次基准 10 分钟、每次正确性检查 5 分钟、无新增付费 API 支出；连续五次有效运行未产生新的保留最优即收敛。显式 --max-runs 与 --max-runtime 为硬限制。Plan 模式响应须包含已确定的契约、有证据支撑的有序初始假设批次及其完成或提前停止标准，以及 codex-handoff 要求的计划部分与清单。在已批准契约内增删或重排假设属于后续规划，不是实质性契约变更。
委托执行：构建实现简报前先阅读 references/worker-loop.md，并将其适用指令与已批准契约、有序批次、确切路径与命令、当前会话与最优结果状态或首批状态、批次停止标准内联。首个实现工作者创建隔离与会话工件并记录未变更基线；每个工作者将详细测量与日志留在工件中，只返回紧凑批次回执。父级将回执与会话模块的 JSON 状态对账，仅在决策或完整性检查需要时读取原始基准输出，然后选择下一批次或停止。
进度与完成：使用 codex-handoff 的主机原生进度界面。仅在基线、完成批次、实质最优变化、阻塞或最终停止时发送基于已定证据的更新，不转述每次运行。按会话模块渲染确切进度条、计数、指标、预算与收敛事实，并说明父级选定的下一批次但不将其记为已完成工作。结束时以 ### 🏁 Autoresearch complete — <停止原因> 收尾，包含基线/最优/增量/置信度、状态计数、保留文件树、确切检查、工作树/分支及剩余清理或集成；METRIC 行、JSONL、命令与诊断信息不加装饰。资源限制不等于收敛。