用途:agent-loop-orchestrator 是 agent-loop 插件的核心编排器,作为持续运行的自动化运行时,在无人监督下维持仓库健康。它以循环方式工作,每个周期依次执行轮询、分诊、分派、跟踪与报告。
主要能力:默认每 5 分钟唤醒一次(可通过 AGENT_LOOP_INTERVAL 调整,单位为秒,如 600 表示 10 分钟、120 表示 2 分钟)。分诊阶段扫描开放 issue、PR 与 CI 失败,将条目分类为 autonomous(可自动修复/合并)、needs_review(需维护者审核)、defer(陈旧、重复或低价值)、blocked(受 CI、权限或冲突阻塞)。分派阶段为每个 autonomous 条目创建独立线程,默认最大并发为 3(AGENT_LOOP_MAX_CONCURRENCY),线程相互独立,各自获得完整技能上下文。监控阶段收集线程结果并记录 passed、failed、needs_human、deferred。报告阶段输出周期摘要。
使用方式:通过 /agent-loop:start 启动编排器,加载该技能并开始循环,直到停止。分诊可运行 /agent-loop:triage --scope current 或 --scope all。状态恢复相关命令包括 /agent-loop:restore --list、/agent-loop:restore <备份文件>、/agent-loop:reset、/agent-loop:start、/agent-loop:inspect、/agent-loop:inspect --validate。
配置:环境变量包括 AGENT_LOOP_INTERVAL(默认 300)、AGENT_LOOP_MAX_CONCURRENCY(默认 3)、AGENT_LOOP_SCOPE(默认 current,可选 current、all、org)、AGENT_LOOP_LOG_DIR(默认 .agent-loop/logs)、AGENT_LOOP_STATE_FILE(默认 .agent-loop/state.json)、AGENT_LOOP_REPOS(默认取自 git remote)。
状态与恢复:状态持久化到 state.json,包含 cycle、started_at、items_processed、items_autonomous、items_needs_review、items_deferred、prs_merged、active_threads、thread_history 等字段。启动时校验文件存在、JSON 合法性、必需字段、类型安全、孤立线程与指标一致性。损坏或缺失时可从备份恢复、重置后重新开始,或先检查再决定。备份自动创建于 .agent-loop/backups/,按时间戳命名,保留最新 50 个。
线程管理:线程生命周期为创建、运行、完成,失败可重试最多 2 次,需人工处理则标记到下次报告。线程操作独立条目,无共享状态,Git 操作按仓库串行化,状态文件原子读写。停止时设置 shutdown_requested,等待活动线程完成(AGENT_LOOP_SHUTDOWN_TIMEOUT 默认 120 秒),持久化最终状态并输出周期摘要。
限制:资料未提供具体平台支持范围、收费方式、性能指标或与其他工具的兼容性说明。