解释 Ralph Loop 插件与 Ralph…

当用户想了解 Ralph Loop 是什么、如何运行、如何启动/取消，或需要用法示例时，输出对应的迭代开发法说明与操作指导。

适用场景

解决思路

1. 说明 Ralph Loop 实现了 Ralph Wiggum 技术：一种基于持续 AI 循环的迭代开发方法论，由 Geoffrey Huntley 首创。
2. 说明核心概念：同一个 prompt 会被反复喂给 agent；“自我引用”来自 agent 在文件和 git 历史中看到自己之前的工作，而不是把输出反馈为输入。
3. 逐条说明每次迭代过程：agent 收到同一个 prompt；执行任务并修改文件；尝试退出；Stop hook 拦截退出并把同一个 prompt 再次喂回；agent 从文件中看到之前的工作；持续迭代改进直到完成。
4. 启动时，让用户告诉 agent 任务和选项，例如：Start a ralph loop: "Build a REST API for todos" --max-iterations 20 --completion-promise "COMPLETE"。
5. 解释 --max-iterations N：达到最大迭代次数后自动停止。
6. 解释 --completion-promise "TEXT"：用指定短语表示完成。
7. 说明启动后的工作流程：创建 .cursor/ralph/scratchpad.md 状态文件。
8. 说明 agent 开始处理任务。
9. 说明 Stop hook 拦截退出并把同一个 prompt 喂回。
10. 说明 agent 查看自己之前的工作并迭代。
11. 说明持续运行直到检测到 promise 或达到 max-iterations。
12. 取消时：让用户要求 agent 取消 ralph loop；agent 会删除状态文件并报告迭代次数。
13. 说明完成信号：agent 输出 <promise> 标签，例如 <promise>TASK COMPLETE</promise>。
14. 说明 Stop hook 查找这个特定标签；如果没有它或 --max-iterations，Ralph 会无限运行。
15. 说明适用场景：定义明确且成功标准清晰的任务、需要迭代和细化的任务、可自我纠正的迭代开发、绿地项目。
16. 说明不适用场景：需要人类判断或设计决策的任务、一次性操作、成功标准不明确的任务。
17. 提供参考资料：原始技术 https://ghuntley.com/ralph/；Ralph Orchestrator https://github.com/mikeyobrien/ralph-orchestrator。
18. 输出时，根据用户具体问题清晰呈现上述信息，并针对其问题做裁剪。

适用边界 · 注意事项

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