SuperAPI AI 工具集

ralph-loop-help

编程与开发

查看项目

更新于 10-15 15:38

技能介绍

用途

Ralph Loop Help 是一个帮助型技能,用于向用户解释 Ralph Loop 插件是什么、如何工作以及可用的技能。当用户询问 Ralph Loop、想了解该技术或需要用法指导时触发。

什么是 Ralph Loop

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

核心概念:同一个提示被反复送入智能体。“自引用”特性来自智能体在文件和 git 历史中看到自己之前的工作,而不是把输出反馈作为输入。

每次迭代的过程:

  • 智能体收到相同的提示
  • 处理任务,修改文件
  • 尝试退出
  • Stop hook 拦截并再次送入相同提示
  • 智能体在文件中看到自己之前的工作
  • 迭代改进直到完成

启动 Ralph Loop

向智能体说明任务并附带选项:

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 状态文件
  • 智能体处理任务
  • Stop hook 拦截退出并送回相同提示
  • 智能体看到之前的工作并进行迭代
  • 持续进行,直到检测到完成承诺或达到最大迭代次数

取消 Ralph Loop

让智能体取消 ralph loop。它会移除状态文件并报告迭代次数。

完成承诺

要表示完成,智能体输出一个 <promise> 标签:

<promise>TASK COMPLETE</promise>

Stop hook 会查找这个特定标签。如果没有它(或 --max-iterations),Ralph 会无限运行。

何时使用 Ralph

适合:

  • 定义明确、成功标准清晰的任务
  • 需要迭代和细化的任务
  • 带自我修正的迭代开发
  • 全新项目

不适合:

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

了解更多

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

输出

将上述信息清晰呈现给用户,并根据其具体问题进行调整。