ralph 是一个以“完成定义(Definition of Done,DoD)”为核心的迭代任务完成循环,结合了 Ralph Wiggum 技巧(在停止时通过 Stop hook 重新注入提示词)与基于 DoD 的独立验证机制。
用途与流程:先根据用户请求提出 3–7 条具体、可独立验证的 DoD 标准,再通过 AskUserQuestion 让用户确认、增删或修改,并设定最大迭代次数(默认 10)。标准要求可二值判定,例如“所有单元测试通过(npm test 退出码 0)”“TypeScript 无错误(tsc --noEmit 退出码 0)”,避免“代码整洁”等主观描述。
状态初始化:确认后写入 DoD 清单文件,将原始提示词与配置写入状态,供 Stop hook 使用,并输出初始化确认信息。
工作执行:只专注完成任务,不读取或修改 DoD 文件,也不自行勾选条目。尝试结束时 Stop hook 检查清单:仍有未勾选项则阻止退出,重新注入原始提示词与剩余条目;全部勾选则允许退出。
验证:收到重新注入的原始提示词后,需在前台启动 ralph-verifier 代理(不后台运行,否则主代理停止会触发 Stop hook 并中断循环),传入 DoD 文件路径与原始提示词;验证器在全新上下文中读取实际文件与测试并给出客观 JSON 结果,PASS 项勾选,FAIL 项在本轮修复,修复后下一轮 Stop hook 再触发验证。
限制:DoD 文件在工作阶段受保护,仅在验证阶段可编辑;提示词通过 heredoc 与 jq 构造以降低注入风险;达到最大迭代次数时熔断,防止无限循环。其他细节暂未提供。