Ralph 循环

Ralph循环(Ralph Loop / Ralph Wiggum Loop) 是2025年兴起的一种AI编程范式,核心是让AI代理在循环中持续迭代、自我修正,直到任务真正完成,而非单次执行后就停止。

一、名称由来

得名于《辛普森一家》中性格执着、屡败屡试的角色Ralph Wiggum,象征“不完成不罢休”的迭代精神。由AI工程师Geoffrey Huntley提出,后被Anthropic官方采纳为Claude Code插件。

二、核心原理

传统AI编程是“单次提示→执行→结束”,AI常因主观判断提前终止,导致代码不完整、测试失败。
Ralph循环通过外部循环+停止钩子(Stop Hook) 强制AI持续工作:

  1. 任务启动:AI执行编码、调试、重构等任务。
  2. 拦截退出:AI试图结束时,Hook拦截并检查完成条件(如输出DONE、测试通过)。
  3. 循环迭代:未达标则回传任务+历史(代码、Git、报错),AI重新尝试。
  4. 终止条件:达标或达最大迭代数(10–50次)时退出。

三、关键设计:状态外置

Ralph循环不依赖AI上下文记忆,而是用文件系统与Git保存进度

  • 每轮迭代“清零记忆”,只读当前文件、日志、提交历史。
  • 避免上下文溢出,确保状态可追溯、可复现。

四、典型工作流(3阶段)

  1. 需求定义(Phase 1)
    人+AI整理specs/需求清单,明确验收标准。
  2. 规划模式(Phase 2)
    AI读需求与现有代码,生成优先级IMPLEMENTATION_PLAN.md
  3. 构建模式(Phase 3)
    循环取最高优先级任务→实现→验证(测试/ lint)→提交Git→标记完成→下一轮。

五、最简实现(Bash示例)

# 无限循环直到任务完成
while :; do
  cat PROMPT.md | claude-code --continue
done

六、适用场景

  • Bug修复:自动跑测试、改代码、再验证
  • 功能开发:从需求到完整实现全流程
  • 代码重构/迁移:批量修改、依赖升级
  • 测试补充:自动生成单元/集成测试

七、优势

  • 强自治:AI“自动加班”,减少人工干预
  • 高可靠:以客观结果(测试通过)为终止标准
  • 易落地:一行脚本即可启用,无需复杂框架
  • 可控制:最大迭代+完成关键词双重安全机制

八、与ReAct/Plan-Act的区别

  • ReAct:LLM内部思考→行动→观察→再思考
  • Ralph外部循环+状态外置,每轮独立重启动,记忆在文件而非上下文
相关资讯