SuperAPI AI 工具集

loop-nanny

智能体与模型

查看项目

更新于 10-15 23:33

技能介绍

用途:Loop Nanny 用于看护已经启动的 agent 循环,负责监控、失败分诊、完成后清理,以及判断何时需要人工介入。启动循环由 agent-loop 技能负责,本技能负责让循环保持健康。

主要能力:通过 joelclaw CLI 查看循环状态,例如 joelclaw loop status <LOOP_ID>;建议每 2–3 分钟轮询一次。状态输出可区分 PASS、SKIP、STORY.DISPATCHED、TESTS.WRITTEN、CHECKS.COMPLETED、STORY.RETRIED、RETRO.COMPLETED、pending 等阶段,并据此决定等待、检查尝试输出或介入。

失败分诊:对 SKIP 的故事,需检查尝试输出与代码是否实际落地,例如查看 /tmp/agent-loop/<LOOP_ID>/<STORY_ID>-<ATTEMPT>.out,检查合并后文件是否存在,以及用 git log 查找对应提交。常见跳过原因包括重复工作、测试断言失败、TypeScript 编译错误、超时等。

完成后清理:合并回主分支后,验证合并是否落地,运行受影响及仓库要求的检查,检查失败的验收测试,执行 bunx tsc --noEmit,必要时重启 worker 部署,并提交清理。

介入判断:首次尝试、带反馈重试、刚跳过但后续故事仍待处理时通常不介入;同一错误重复出现、合并冲突、worker 崩溃、全部故事跳过、循环卡住超过 15 分钟时应介入。可用 joelclaw loop cancel <LOOP_ID> 取消卡住的循环,并手动清理 worktree。

诊断:可用 joelclaw loop diagnose all -c 快速诊断,加 --fix 自动修复,如 CHAIN_BROKEN、ORPHANED_CLAIM、STUCK_RUN、WORKER_UNHEALTHY。

限制与注意:取消不会自动合并,worktree 分支不会自动删除;共享循环需使用隔离 worktree 或互不重叠的路径;prd.json 与 progress.txt 变脏属正常;跨文件测试污染需调查测试隔离问题,保留有效覆盖并修复共享状态缺陷。资料未提供收费、价格或平台信息。