用途：在 Claude Code 中跨多个会话自动执行长耗时、多阶段任务，适合无人值守的后台批处理与整夜运行。
主要能力：两种执行模式。无头模式（默认）在 bash 循环中生成 claude -p 子会话，适合后台/无人值守工作，命令如 bash <skill-dir>/scripts/run-session.sh "Build a REST API" --max-sessions 10。钩子模式在交互式会话内通过 Stop 钩子拦截退出并回喂提示，命令如 bash <skill-dir>/scripts/setup-loop.sh "Build a REST API" --max-iterations 10。
两种任务策略：结构化（默认）先由 Initializer 生成含分阶段子任务的 task_list.md，再由 Executor 逐项完成，适合复杂多阶段项目；轻量（--lightweight）为 Ralph 式迭代，每次会话重复同一提示、不做任务分解，适合有明确成功标准的 TDD、修 bug、重构。完成检测有两套互补机制，先触发者生效：promise 标签，代理真正完成时输出 <promise>DONE</promise>（默认 DONE，可用 --completion-promise 自定义）；复选框计数（仅结构化模式），task_list.md 中所有 [ ] 变为 [x]。
使用方式：无头模式常用选项包括 --lightweight、--task-name、--continue/-c、--list/-l、--completion-promise、--max-sessions、--max-budget、--model、--fallback-model、--effort、--no-auto-continue、--permission-mode、--add-dir。状态保存在项目根 .autonomous/<task-name>/ 下，含 task_list.md、progress.md、.mode、sessions/ 以及 run.lock；钩子模式状态在 .claude/autonomous-loop.local.md，取消可执行 rm .claude/autonomous-loop.local.md。
限制与注意：task_list.md 的完成标记仅允许 [ ] 改为 [x]，保持只追加；每个任务同一时间只允许一个 runner，run.lock 防止并发；.autonomous/ 仅用于跟踪，项目文件仍留在项目根；代理在真正完成前不得输出 promise；默认每会话预算 5.00 美元，可用 --max-budget 调整。若出现锁文件残留、会话反复失败、嵌套会话报错、钩子循环不停、任务找不到或想重来，资料给出了删除锁文件、查看 sessions/session-NNN.log、改用钩子模式、删除 autonomous-loop.local.md、运行 --list、删除任务目录等排查办法。缺失信息：安装方法、支持的平台范围与更细的权限配置暂未提供。