关于 ralph-loop-help
为 Cursor Agent 提供 Ralph Loop 原理、启动选项、取消方式和适用场景的说明技能。内容涵盖重复提示词、停止钩子及完成标记。
主要功能
- 01说明 Ralph Loop 的迭代机制
- 02介绍最大迭代次数选项
- 03说明完成标记的用法
- 04提供取消循环的指导
- 05列出适用与不适用任务
适用场景
- 01了解 Ralph Loop 的工作方式
- 02为任务设置循环参数
- 03判断任务是否适合迭代执行
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/ralph-loop-help确认已加载。
详细介绍
Ralph Loop 帮助
触发条件
用户询问 Ralph Loop 是什么、它如何运作，或需要使用指导。
需要说明的内容
什么是 Ralph Loop？
Ralph Loop 实现了 Ralph Wiggum 技术——由 Geoffrey Huntley 开创的一种基于持续 AI 循环的迭代开发方法。
核心概念：反复向 Agent 提供同一条提示词。“自我指涉”体现在 Agent 能在文件和 git 历史中看到自己之前的工作，而不是将输出作为输入再次提供。
每次迭代：
- Agent 收到相同的提示词
- 处理任务并修改文件
- 尝试退出
- Stop hook 拦截退出，并再次提供相同的提示词
- Agent 查看自己之前的工作
- 反复改进，直到完成
启动 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"— 用于表示已完成的短语
工作原理：
- 创建
.cursor/ralph/scratchpad.md状态文件 - Agent 处理任务
- Stop hook 拦截退出，并再次提供相同的提示词
- Agent 查看自己之前的工作并继续迭代
- 持续运行，直到检测到承诺短语或达到最大迭代次数
取消 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
输出
清晰地向用户介绍上述信息，并根据用户的具体问题进行调整。
评论
支持 Markdown