SuperAPI AI 工具集

autoresearch

智能体与模型

查看项目

更新于 10-15 18:05

技能介绍

Autoresearch 是一个面向实验型优化任务的技能,适用于“autoresearch”或“optimize X overnight/in a loop”这类需求。它的核心思路是:由父级(parent)负责研究决策与编排,由编排工人(orchestration workers)执行实验。

用途 用于规划有边界、可衡量的实验批次,并委派执行。它关注一致度量、只保留经验证的改进,并在明确的资源或收敛限制处停止。

编排契约 在新的 autoresearch 会话中,以 Plan 模式启动。凡是要实质性变更已批准会话的目标、主指标或方向、基准或正确性命令、写入范围,或硬性资源、成本、回归、收敛限制,也必须处于 Plan 模式。若需要 Plan 模式但未激活,应请用户切换并停止。未变更的已批准契约可以在 Plan 模式之外恢复并接收新的假设批次。

实现必须始终调用 $orchestration,不得退回父级直接实现或使用其他交接机制,并遵循其主机选择、计划清单、团队规模、验证归属、对账、失败与完成契约。

父级拥有会话契约、证据综合、假设选择与排序以及停止决定。它可以在有用时委派只读的仓库调查,但研究工人返回的是证据,而不是假设或计划。父级自身的执行工作应限于编排、完整性检查、紧凑结果审阅以及选择下一批次。

实现工人执行父级提供的、有序的假设批次。对于顺序搜索,默认使用一个工人。把多个相关假设打包进一份简报,直到达到编排的规模限制。不要默认每个想法分配一个工人。只有当假设彼此独立、依赖波次需要如此,或一份简报刊超出规模限制时才拆分。

工人可以做出执行所分配假设所需的局部调整。它必须报告一个实质性不同的研究方向,而不是去执行它。

计划与会话契约 在批准前,需确定目标、主指标与方向、基准与正确性命令、允许/禁止的路径、运行/运行时/命令/成本/回归限制、收敛窗口以及报告节奏。应从请求与仓库推断安全事实。仅当缺失的选择会改变实验时才提问。

默认值:20 次运行、两小时挂钟时间、每次基准 10 分钟、每次正确性检查 5 分钟、不新增付费 API 支出、连续五次有效运行且未产生新的保留最佳后视为收敛。显式的 --max-runs 与 --max-runtime 值是硬限制。

Plan 模式响应必须包含:已解析的契约、有证据支持且有序的初始假设批次及其完成或提前停止标准,以及编排所要求的计划部分与清单。在已批准契约内增加、删除或重排假设属于后续规划,不属于实质性契约变更。

委派执行 在构建实现简报之前,先阅读 references/worker-loop.md。将其中适用的指令与已批准契约、有序批次、精确路径与命令、当前会话与最佳结果状态或首批状态,以及批次停止标准一并纳入。编排拥有其余提示与结果字段。

第一个实现工人创建隔离与会话产物,并记录未变更的基线。每个工人把详细测量与日志留在这些产物中,只返回工人参考所要求的紧凑批次回执。父级将该回执与会话模块的 JSON 状态进行对账。只有在做决定或完整性检查需要时,才读取原始基准输出。然后它选择另一个批次或停止。在未变更契约下的后续批次仍属于已批准成果内的后续工作。

进度与完成 使用编排的主机原生进度界面。仅从已确定证据发送父级编写的更新,即在基线、完成批次、实质性最佳变更、阻塞或最终停止时。不要转述每次运行的叙述。渲染会话模块的精确进度条、计数、指标、预算与收敛事实,并指出父级选择的下一批次,但不要把它记录为已确定工作。

结束时输出 ### 🏁 Autoresearch complete — <stop reason>,以及基线/最佳/增量/置信度、状态计数、保留文件树、精确检查、工作树/分支,以及剩余清理或集成。保持 METRIC 行、JSONL、命令与诊断不加装饰。资源限制不等于收敛。