ralph 是 Ouroboros 循环的可移植方法契约,核心流程为:访谈(Interview)→ 种子(Seed)→ 执行(Execute)→ 评估(Evaluate)→ 演进(Evolve),并可通过 ooo ralph 持续循环直到完成被验证。
用途:适合需求模糊、需要先做苏格拉底式访谈再写代码的场景;需要把需求冻结为不可变规范后再实现;需要“验证后才算完成”的循环而非一次性回答;需要对照原始契约衡量漂移;反复失败时需要结构化“解困”步骤。
主要能力与用法:
- 访谈:ooo interview "build a task management CLI",歧义度需 ≤ 0.2 才进入种子阶段。
- 种子:ooo seed,锁定目标、约束、验收标准、本体/核心对象模型,作为漂移检查基线。
- 执行:ooo run [seed.yaml],默认形态为 Discover、Define、Design、Deliver。
- 评估:ooo evaluate <session_id>,分机械(lint、测试、构建、类型检查、覆盖率)、语义(验收标准与目标对齐)、共识(可选多模型/评审)三阶段。漂移阈值:0.00–0.15 优秀,0.15–0.30 可接受但需关注,0.30+ 需先纠偏。
- 演进:ooo evolve "topic",可加 --no-execute。
- 持续完成:ooo ralph "fix all failing tests",循环为执行、验证、记录失败证据、调整,直到验证通过或达到上限。
- 解困:ooo unstuck 及 simplifier、hacker、contrarian、researcher、architect 等模式。
适用场景:规范优先的开发任务、需要持续验证的修复或实现任务、需要衡量契约漂移的项目。
限制与边界:ralph 有意保持运行时无关,不负责 Claude/Codex/Gemini 的平台设置与执行策略,这些分别路由到 omc、omx、ohmg;权限姿态、审批、信任目录等路由到 ralphmode;集成项目台账、计划评审、浏览器验证与清理工作流路由到 jeo;仅做实现前调研则路由到 survey。平台钩子、审批、信任设置和 shell 命令属于运行时文档与兄弟技能。
可用脚本:scripts/setup-codex-hook.sh、scripts/setup-gemini-hook.sh、scripts/ooo-state.sh。示例:bash .agent-skills/ralph/scripts/setup-codex-hook.sh。来源为 Q00/ouroboros,MIT 许可。