Super Ralph Wiggum 是面向 Claude Code 的自主迭代循环技能。它的核心思路是：由你定义终点状态，由代理自行决定下一步做什么，通过反复运行同一提示直到任务完成，并借助文件与 git 历史在多次迭代之间保持上下文。
用途 它用于把重复性的、可拆分为小步的工程任务交给 Claude Code 自动推进，例如按 PRD 开发功能、提升测试覆盖率、修复 lint 错误、生成文档、生成数据集、迁移框架或版本、清理死代码与代码异味、消除重复代码等。
主要能力
- 模板模式：内置 test-coverage、feature-prd、lint-fix、docs-generation、dataset-generation、migration、entropy-loop、duplication-loop 等模板，每个模板有默认迭代次数（如 test-coverage 30、feature-prd 20、lint-fix 30、docs-generation 25、dataset-generation 50、migration 40、entropy-loop 30、duplication-loop 25）。
- PRD 模式：通过 prd.json 跟踪功能，以 passes: true/false 标记完成状态，全部通过后循环结束。
- HITL 模式：使用 --once 只运行一次迭代，适合学习与结对编程。
- 自定义提示：可指定完成条件（如输出 <promise>COMPLETE</promise>）与最大迭代次数。
- 两种执行模式：会话内模式（默认，通过 stop hook 拦截退出并回喂同一提示）与 Docker 化外部模式（通过 bash 脚本在 Docker 沙箱中运行，每次迭代为全新 Claude Code 实例）。
- 进度持久化：自动在项目根目录创建 progress.txt，状态文件位于 .claude/ralph-loop.local.md。
使用方式 模板模式：使用 super-ralph-wiggum 配合 [template-name] 模板，可选 --max-iterations N、--browser。 PRD 模式：使用 feature-prd 模板并指定 PRD 文件（如 ./prd.json）。 HITL 模式：使用 --once 标志执行单次迭代。 自定义提示：给出详细任务描述与完成标准，并设置最大迭代次数。 Docker 化模式：运行 ./scripts/setup-ralph-loop.sh --template test-coverage --docker > run-ralph.sh，然后 chmod +x run-ralph.sh 并后台执行 ./run-ralph.sh 20 &。 取消循环：删除状态文件 rm .claude/ralph-loop.local.md，或等待达到最大迭代次数。
关键选项 --template <name> 使用预置模板；--prd <file> 指定 PRD 文件；--max-iterations <n> 迭代上限；--completion-promise <text> 自定义完成短语（默认 COMPLETE）；--progress <file> 进度文件位置（默认 ./progress.txt）；--browser 启用浏览器测试提示（默认 false）；--once 单次迭代（默认 false）。
适用场景 适合可拆分为单次上下文窗口内完成的小任务、需要反复验证的批量工作、低风险的后台或过夜运行，以及希望先通过 HITL 学习再转为 AFK 的渐进式使用。
限制与注意事项
- AFK 无人值守运行必须设置 --max-iterations，避免随机系统下的无限循环。
- 任务需足够小，能放入一个上下文窗口；完成标准需明确。
- 代理会从现有代码库学习模式，若代码库中存在你不希望延续的写法，应先清理。
- Docker 沙箱对 AFK 安全很重要，可限制其只能编辑项目文件并提交，无法触碰主目录、SSH 密钥或系统文件。
- 关于 API 成本、浏览器测试集成等细节，资料中仅列出参考文件（cost-estimation.md、browser-testing.md 等），未提供具体数值或步骤。
该技能基于 Geoffrey Huntley 的 Ralph Wiggum 技术，并融合了 Ryan Carson、Matt Pocock 与 AI Hero 的经验。