让 AI 为你无限迭代优化：Claude Code 之 Ralph Wiggum 绝好攻略

在使用 Claude Code 时，你有没有想过：能不能让 AI 在同一个任务上反复打磨，每次都基于上次的成果继续改进？答案就在——Ralph Wiggum 插件。

---

📖 目录

• 什么是 Ralph Wiggum？
• 快速开始：5 分钟上手
• 核心特点
• 基本命令一览
• 适用场景
• 注意事项
• 常见问题 Q&A
• 总结

---

什么是 Ralph Wiggum？

Ralph Wiggum 是 Claude Code 的一个创意插件，它实现了一种独特的「自我迭代循环」工作模式。

简单来说，启用这个插件后，你给 AI 一个任务，AI 完成后尝试退出时……系统会自动把同一个任务再次交还给 AI，但这次 AI 能看到之前做的工作，可以基于已有成果继续改进、完善。

这就形成了一个良性循环：任务完成 → 自动反馈 → 迭代改进 → 再次完成 → 自动反馈 → 迭代改进……

名字源于《辛普森一家》中那个可爱又执着的角色，象征着简单、持续的重复与进步。

快速开始：5 分钟上手

启动 Ralph Loop 只需要一条命令：

/ralph-wiggum:ralph-loop "优化这段代码的性能" --max-iterations 3

就这么简单！系统会：

1. 开始第 1 轮迭代，AI 完成初步优化
2. AI 尝试退出时，系统自动把任务再次交还给 AI
3. 开始第 2 轮迭代，基于上次的成果继续改进
4. 重复 3 轮后自动结束

---

核心特点

🔄 1. 自动循环模式

当你启动 Ralph Loop 后，完成一个任务并尝试退出时，系统会自动将同一个提示词再次反馈给你，让你基于之前的工作成果继续迭代改进。

📂 2. 保持工作上下文

• 文件修改历史会被完整保留
• Git 历史记录清晰可见
• 前一轮的工作成果可以随时查看和修改

⚙️ 3. 精准控制循环次数

• --max-iterations：设置最大迭代次数
• --completion-promise：设置完成条件，当达成特定目标时结束循环

基本命令一览

命令	功能
/ralph-wiggum:help	查看帮助信息
/ralph-wiggum:ralph-loop [任务] [选项]	启动迭代循环
/ralph-wiggum:cancel-ralph	取消活跃的循环

启动选项详解

/ralph-wiggum:ralph-loop "[任务描述]" [选项]

可用选项：

选项	说明	示例
--max-iterations N	设置最大迭代次数	--max-iterations 3
--completion-promise "内容"	设置完成条件	--completion-promise "测试全部通过"

实际运行效果

当你启动 Loop 后，会看到类似这样的输出：

🔄 Ralph loop activated in this session!

Iteration: 1
Max iterations: 3

The stop hook is now active. When you try to exit, the SAME PROMPT
will be fed back to you. You'll see your previous work in files,
creating a self-referential loop where you iteratively improve.

🔄

每次 AI 完成工作后尝试退出时，系统会自动将其拉回，开始下一轮迭代：

Iteration: 2
Max iterations: 3
🔄

---

适用场景

💻 1. 迭代优化代码

当你需要对同一功能反复优化时：

/ralph-wiggum:ralph-loop "优化这个数据处理函数的性能" --max-iterations 5

每次迭代都可以基于上次的改进继续优化。

📝 2. 完善文档内容

当你需要逐步完善一篇文章或文档时：

/ralph-wiggum:ralph-loop "编写一份技术文档" --max-iterations 3

🎨 3. 持续改进设计方案

当需要多次迭代的方案设计时：

/ralph-wiggum:ralph-loop "设计这个 API 接口方案" --completion-promise "API 设计已完成并通过代码审查"

⚠️ 注意事项

重要提示

• Ralph Loop 一旦启动，无法手动停止（除非设置了最大迭代次数）
• 如果不设置限制，它会无限循环运行
• 请务必在启动前设置 --max-iterations 或 --completion-promise

最佳实践

1. 始终设置迭代次数：--max-iterations 是最简单有效的控制方式
2. 明确定义完成条件：使用 --completion-promise 设置可验证的目标
3. 专注单一改进点：每个迭代聚焦一个具体的问题
4. 利用 git 历史追踪：随时回看每次的变化

---

监控循环状态

想查看当前循环的进展情况？运行以下命令：

head -10 .claude/ralph-loop.local.md

这个文件会记录当前的迭代次数、最大迭代次数和完成条件等信息。

---

常见问题 Q&A

Q1：Ralph Loop 会无限循环吗？

A： 默认情况是的，所以强烈建议始终设置 --max-iterations 或 --completion-promise 来控制循环次数。如果不设置，它会一直运行下去。

Q2：每个迭代之间能看到之前的工作吗？

A： 可以！系统的设计目的就是让你在每次迭代中都能看到之前的工作成果，包括文件修改和 git 历史。

Q3：可以手动停止 Loop 吗？

A： Ralph Loop 一旦激活，无法通过常规方式手动停止（这是特性，不是 bug）。只能等待达到最大迭代次数或满足完成条件。所以务必在启动前设置好选项！

Q4：和普通对话有什么区别？

A： 普通对话是你和 AI 的一来一回，Ralph Loop 是让 AI 在同一个任务上自主迭代，更像是一个自我反思和改进的过程。

Q5：最多设置多少次迭代比较合适？

A： 取决于任务复杂度。一般性优化 3-5 次足够，复杂任务可能需要 5-10 次。次数太多可能边际效益递减。

---

总结

Ralph Wiggum 插件为 Claude Code 带来了强大的自我迭代能力。通过持续的循环改进，你可以：

✅ 逐步完善复杂任务，越迭代越好
✅ 在每次迭代中看到之前的工作成果
✅ 基于已有内容继续深化改进
✅ 设置明确的完成条件来控制循环

特别适合这些场景：

• 📌 代码性能优化
• 📌 文档内容完善
• 📌 方案设计打磨
• 📌 多轮调试和 bug 修复

---

记住黄金法则： 始终设置 --max-iterations 或 --completion-promise，避免意外的无限循环！

感谢阅读！快去试试 Ralph Wiggum，让你的 AI 助手学会自我迭代吧！

---