SuperAPI AI 工具集

ralph

编程与开发

查看项目

更新于 11-13 07:06

技能介绍

Ralph 是一个迭代式构建智能体(Iterative Build Agent),其核心目标是持续工作直到任务完成,即所有功能测试通过。

用途 Ralph 用于在开发过程中以迭代方式构建功能。它不依赖一次性完成,而是通过多轮循环逐步实现或修复代码,直到满足预先定义的功能验收测试。

主要能力

  • 需求收集:当 .agent/tests.json 不存在时,Ralph 会询问用户想要构建什么,理解需求后生成功能验收测试,并创建 .agent/tests.json 文件。该文件结构包含 feature(功能描述)、iteration(当前迭代次数)、maxIterations(最大迭代次数,默认 10)以及 tests 数组,每个测试项包含 id、description 和 passed 状态。Ralph 会创建 5 到 10 个有意义的测试来验证功能是否正确工作。
  • 构建与验证:读取 .agent/tests.json 了解当前状态,递增迭代计数器,实现或修复代码以使失败的测试通过。每次修改后,手动验证每个测试标准,将已通过的测试标记为 passed: true,并保存更新后的文件。
  • 状态报告:每轮迭代后更新 .agent/scratchpad.md,记录当前状态(迭代次数、通过测试数)、最近完成的内容以及下一步计划。
  • 停止钩子:当智能体停止时,ralph-continue.sh 钩子会检查 .agent/tests.json 中是否仍有失败的测试。如果还有测试未通过且迭代次数小于最大值,钩子会提示继续工作,直到所有测试通过或达到最大迭代次数。

使用方式 Ralph 通过 .agent/tests.json 和 .agent/scratchpad.md 两个文件进行状态管理。用户只需启动 Ralph 并描述想要构建的功能,Ralph 会自动生成测试并开始迭代。每轮迭代中,Ralph 会实现代码、验证测试、更新状态文件。当智能体停止时,钩子会自动判断是否需要继续。

重要规则

  • 验证测试时要彻底,实际检查每个标准是否满足。
  • 除非已验证测试有效,否则不要将其标记为通过。
  • 如果尝试了多种方法后测试仍然失败,在 scratchpad 中记录该情况。
  • 如果达到 maxIterations,优雅停止。

适用场景 Ralph 适用于需要迭代开发并带有明确功能验收测试的编码任务,尤其适合希望智能体持续工作直到所有测试通过的场景。

限制

  • 最大迭代次数默认为 10,达到上限后会停止。
  • 测试由 Ralph 根据需求生成,数量为 5 到 10 个。
  • 依赖 .agent/tests.json 和 .agent/scratchpad.md 文件进行状态跟踪。
  • 关于收费、价格、平台支持等具体信息暂未提供。