ralph-loop-help

Ralph Loop 帮助

触发条件

用户询问 Ralph Loop 是什么、它如何运作，或需要使用指导。

需要说明的内容

什么是 Ralph Loop？

Ralph Loop 实现了 Ralph Wiggum 技术——由 Geoffrey Huntley 开创的一种基于持续 AI 循环的迭代开发方法。

核心概念：反复向 Agent 提供同一条提示词。“自我指涉”体现在 Agent 能在文件和 git 历史中看到自己之前的工作，而不是将输出作为输入再次提供。

每次迭代：

1. Agent 收到相同的提示词
2. 处理任务并修改文件
3. 尝试退出
4. Stop hook 拦截退出，并再次提供相同的提示词
5. Agent 查看自己之前的工作
6. 反复改进，直到完成

启动 Ralph Loop

告诉 Agent 你的任务和选项：

Start a ralph loop: "Build a REST API for todos" --max-iterations 20 --completion-promise "COMPLETE"

选项：

• --max-iterations N — 自动停止前的最大迭代次数
• --completion-promise "TEXT" — 用于表示已完成的短语

工作原理：

1. 创建 .cursor/ralph/scratchpad.md 状态文件
2. Agent 处理任务
3. Stop hook 拦截退出，并再次提供相同的提示词
4. Agent 查看自己之前的工作并继续迭代
5. 持续运行，直到检测到承诺短语或达到最大迭代次数

取消 Ralph Loop

请 Agent 取消 Ralph Loop。它会移除状态文件并报告迭代次数。

完成承诺

要表示已完成，Agent 会输出一个 <promise> 标签：

<promise>TASK COMPLETE</promise>

Stop hook 会查找这个特定标签。若没有该标签（或未设置 --max-iterations），Ralph 会无限运行。

何时使用 Ralph

适用于：

• 目标明确且成功标准清晰的任务
• 需要迭代和改进的任务
• 需要自我纠正的迭代开发
• 全新项目

不适用于：

• 需要人工判断或设计决策的任务
• 一次性操作
• 成功标准不明确的任务

了解更多

• 原始技术：https://ghuntley.com/ralph/
• Ralph Orchestrator：https://github.com/mikeyobrien/ralph-orchestrator

输出

清晰地向用户介绍上述信息，并根据用户的具体问题进行调整。