SuperAPI AI 工具集

ralph-loop-help

编程与开发

查看项目

更新于 11-19 03:05

技能介绍

Ralph Loop Help 是一个说明型技能,当用户询问 Ralph Loop 是什么、如何工作,或需要用法指导时触发,用于清晰地解释 Ralph Loop 插件及其可用技能,并针对用户的具体问题组织回答。

用途:帮助用户理解 Ralph Loop 这一迭代开发方法的定位与机制。Ralph Loop 实现的是 Ralph Wiggum 技术,这是一种基于持续 AI 循环的迭代开发方法,由 Geoffrey Huntley 提出。其核心概念是向智能体反复送入同一个提示词;“自我参照”来自智能体在文件和 git 历史中看到自己此前的工作,并非把输出作为输入回灌。

主要能力与每次迭代的流程:智能体收到同一个提示词;执行任务并修改文件;尝试退出;停止钩子(stop hook)拦截退出并再次送入同一提示词;智能体在文件中看到自己此前的工作;如此迭代改进直至完成。

使用方式:向智能体说明任务并给出选项即可启动循环,示例为: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 状态文件;随后智能体执行任务,停止钩子拦截退出并回送同一提示词,智能体看到此前工作并继续迭代,直到检测到完成承诺或达到最大迭代次数。取消循环时,可要求智能体取消 ralph loop,它会移除状态文件并报告迭代次数。

完成机制:智能体通过输出 <promise> 标签表示完成,例如 <promise>TASK COMPLETE</promise>;停止钩子查找该特定标签。若没有该标签且未设置 --max-iterations,Ralph 将无限运行。

适用场景:适合成功标准明确的任务、需要迭代与细化的任务、带自我纠正的迭代开发,以及全新项目(greenfield projects)。

限制:不适合需要人工判断或设计决策的任务、一次性操作,以及成功标准不清晰的任务。

更多信息:原始技术见 https://ghuntley.com/ralph/,Ralph Orchestrator 见 https://github.com/mikeyobrien/ralph-orchestrator。