autoresearch

<用途> Autoresearch 是一种有状态技能，用于有边界、由评估器驱动的迭代改进。它一次只处理一个任务，不断迭代未通过的结果，将每次评估和决策记录为持久的工件，并在达到明确的 max-runtime 上限或其他显式终止条件时停止。 </用途>

<适用场景>

• 你已经通过 /deep-interview --autoresearch 获得了任务和评估器
• 你需要带有严格评估的持久化单任务改进功能
• 你需要在 .omc/autoresearch/ 下保存持久的实验日志
• 你希望通过 Claude Code 原生 cron 支持定期重运行 </适用场景>

<不适用场景>

• 需要在运行时生成评估器——请先使用 /deep-interview --autoresearch
• 需要协调多个任务——v1 版本禁止此操作
• 想使用已弃用的 omc autoresearch CLI 流程——该流程不再具有权威性 </不适用场景>

<合约>

• v1 版本仅支持单个任务
• 任务设置/评估器生成保留在 deep-interview --autoresearch 中
• 评估器输出必须是结构化 JSON，包含必需的布尔型 pass 字段和可选的数值型 score 字段
• 未通过的迭代不会停止运行
• 停止条件是显式且有边界的，其中 max-runtime 是主要的严格停止钩子 </合约>

<必需工件> 规范的持久化存储位于 .omc/autoresearch/<任务标识>/ 和/或 .omc/logs/autoresearch/<运行ID>/ 目录下。

最低要求的工件：

• 任务规范（mission spec）
• 评估器脚本或命令引用
• 每次迭代的评估 JSON
• Markdown 决策日志

推荐的规范结构：

.omc/autoresearch/<任务标识>/
  mission.md
  evaluator.json
  runs/<运行ID>/
    evaluations/
      iteration-0001.json
      iteration-0002.json
    decision-log.md

在可用的情况下，优先重用现有的运行时工件，而不是不必要地重复创建它们。 </必需工件>

<工作流程>

1. 确认存在一个任务，并且评估器设置已经就绪。
2. 确保模式/状态对于 autoresearch 是激活的，并记录：
   • 任务标识/目录
   • 评估器引用
   • 迭代次数
   • 开始/更新时间戳
   • 显式的 max-runtime 或截止时间
3. 每次迭代：
   • 执行恰好一个实验/变更周期
   • 运行评估器
   • 持久化机器可读的评估 JSON
   • 追加一条人类可读的 Markdown 决策日志条目
   • 即使评估未通过也继续执行
4. 在以下情况下停止：
   • 达到 max-runtime 上限
   • 用户显式取消
   • 运行时记录了其他显式的终止条件 </工作流程>

<Cron 集成> Claude Code 原生 cron 是受支持的集成点，用于定期增强任务。在 v1 版本中，优先记录/配置 cron 输入，而不是构建庞大的调度器 UI。

如果使用了 cron：

• 每个计划作业只保留一个任务
• 保持相同的任务/评估器合约
• 追加新的运行工件，而不是覆盖之前的实验 </Cron 集成>

<执行策略>

• 不要将执行交回给 omc autoresearch
• 不要创建多任务协调
• 在 src/autoresearch/* 运行时/模式助手已经符合更严格合约的情况下，优先重用它们
• 保持日志对人类有用，而不仅仅对机器有用 </执行策略>