ralph

Ralph

Ralph 是一个由 PRD 驱动的持久化循环，会持续处理任务，直到所有用户故事都标记为 passes: true 并通过审核者验证。

适用场景

• 任务需要确保完成并经过验证
• 工作可能需要多轮迭代，并需要持续推进
• 任务适合采用结构化的 PRD 驱动执行方式

不适用场景

• 完整的自主执行流水线 → 使用 /omg-autopilot
• 提交之前先探索或规划 → 使用 /plan
• 快速的一次性修复 → 委派给 @executor

标志

• --no-prd：跳过 PRD 生成，以旧模式工作（适用于简单修复）
• --no-deslop：跳过强制性的审核后清理步骤

步骤

1. 设置 PRD（首次迭代）

• 通过 omg_read_prd 检查 .omc/prd.json 是否存在
• 如果不存在，则生成包含任务专属验收标准的 PRD 框架
• 关键：将通用标准替换为具体、可测试的标准
• 初始化进度跟踪

2. 选择下一个故事

• 通过 omg_read_prd 读取 PRD
• 选择优先级最高且 passes: false 的故事

3. 实现当前故事

• 根据复杂度级别委派给 @executor
• 如果发现子任务，将其作为新故事添加到 PRD 中

4. 验证验收标准

• 针对每项标准，使用最新证据进行验证
• 运行相关检查（测试、构建、lint、类型检查）
• 如果有任何标准未达成，则继续处理

5. 标记故事已完成

• 通过 omg_update_story 设置 passes: true
• 在 progress.txt 中记录进度

6. 检查 PRD 是否完成

• 调用 omg_check_completion
• 如果并非全部完成，则循环回到步骤 2
• 如果全部完成，则继续验证

7. 审核者验证

• @verifier 根据 PRD 中的具体验收标准进行检查
• @architect 审查架构的合理性

7.5 强制清理步骤

• 除非使用 --no-deslop，否则仅对已更改的文件运行 /ai-slop-cleaner

7.6 回归重新验证

• 清理后重新运行所有测试
• 仅在回归测试通过后继续

8. 完成

• 获批后：运行 /cancel 干净退出
• 未获批：修复问题、重新验证并循环返回

执行策略

• 同时启动彼此独立的任务
• 在后台运行构建和测试
• 交付完整实现：不得缩减范围或只完成部分内容

检查清单

• 所有 PRD 故事的 passes: true
• 验收标准针对具体任务（而非通用标准）
• 满足所有要求（未缩减范围）
• 最新测试输出显示所有测试均已通过
• 审核者验证已通过
• 清理步骤已完成（或使用了 --no-deslop）
• 清理后的回归测试已通过