SuperAPI AI 工具集

autonomous-opus-loop

智能体与模型

查看项目

更新于 10-15 10:53

技能介绍

用途

autonomous-opus-loop 用于将 Claude Code 从交互式操作转变为完全自主运行。它借助另一个 Claude 实例(Opus 4.5)在每次响应后分析工作进度,决定是否继续或停止,并给出具体的下一步指令,从而在无人干预的情况下持续推进任务直至目标达成。

主要能力

  • 自主循环:Stop hook 触发后,脚本读取对话记录、检查安全限制、调用 Opus 分析器,分析器返回 CONTINUE、COMPLETE 或 ESCALATE 决策,其中 CONTINUE 的具体任务会作为 reason 字段回传给 Claude Code 作为下一条指令。
  • 进度分析:分析器对照目标与成功标准,检查已完成与剩余工作,避免重复已完成任务。
  • 安全限制:包括迭代上限、成本上限、连续失败次数上限、最大运行时长,以及通过 stop_hook_active 标志防止无限递归、通过语义分析检测循环工作模式。
  • 配置管理:通过 .claude/autonomous-config.json 配置目标、成功标准、分析器模型、行为选项等。
  • 状态与日志:提供状态查询、会话日志查看、紧急停止等脚本。
  • 自定义分析器提示词:可在 .claude/autonomous-prompts/ 下为重构、新功能、缺陷修复、测试等场景创建专用提示词文件。
  • 与其他技能集成:可与 hooks-manager、agent-memory-system、momentum-keeper、可观测性栈等配合使用。

使用方式

  1. 安装 Hook:运行 .claude/skills/autonomous-opus-loop/scripts/install.sh,或手动在 .claude/settings.json 的 hooks.Stop 中添加命令 .claude/skills/autonomous-opus-loop/scripts/autonomous-loop.sh,超时设为 120。
  2. 配置目标:创建 .claude/autonomous-config.json,设置 enabled、objective、success_criteria、max_iterations、max_cost_usd、analyzer_model、verbose 等字段。
  3. 启动 Claude Code:例如 claude -p "Begin implementing user authentication per the objective in .claude/autonomous-config.json"。
  4. 运行控制:使用 enable.sh 启用、disable.sh 禁用、status.sh 查看状态、view-log.sh 查看日志、emergency-stop.sh 紧急停止。

适用场景

  • 通宵功能开发:如构建包含图表、筛选、导出的完整用户仪表盘。
  • 快速重构任务:如将 utils/ 转为 TypeScript 严格模式。
  • 缺陷排查会话:如定位并修复 WebSocket 处理器的内存泄漏。
  • 任何需要多步骤、长时间自主推进的编码任务。

限制

  • 需要设置 ANTHROPIC_API_KEY。
  • 分析器调用会产生额外成本,不同模型成本不同(资料给出 Sonnet 4 约 $0.045/次、Opus 4.5 约 $0.225/次、Haiku 3.5 约 $0.012/次的估算,另加 Claude Code 使用成本)。
  • 受迭代、成本、运行时长、连续失败等上限约束。
  • 若配置或脚本异常,可能出现 Hook 不触发、立即停止、无限循环、API 错误等问题,需按故障排查步骤处理。
  • 资料未提供具体平台兼容性、安装前置依赖等更多细节。