用途：Ralph Runner 用于运行 Ralph Wiggum 自主编码循环，按 PRD（产品需求文档）迭代实现功能。适合需要从任务列表自动实现功能、执行 PRD 或启动自主编码的场景。
主要能力：每轮迭代读取 prd.json，选取优先级最高且 passes 为 false 的用户故事，启动新的 Claude Code 实例实现该单个故事，运行类型检查、lint、测试等质量检查；通过后提交代码、更新 prd.json 并追加到 progress.txt。全部完成后输出 <promise>COMPLETE</promise>。记忆通过 Git 提交、progress.txt 和 prd.json 持久化。
使用方式：前置条件为 Claude Code（claude --version）与 ralph-cli（ralph --version）。常用命令：ralph status prd.json 查看状态；ralph run prd.json 运行循环；可加 --context AGENTS.md --context ./docs 传入上下文，--iterations 20 增加迭代次数。CLI 选项包括 -i/--iterations（默认 10）、-c/--context、-p/--prompt、--headed 实时显示输出、--dry-run 预览。PRD 为 JSON，含 project、branchName、description 和 userStories（含 id、title、priority、passes）。
适用场景与限制：适合将 PRD 拆成小故事逐步自动实现。最佳实践是保持故事足够小、验收标准明确、加入类型检查、传入 AGENTS.md 等上下文并查看 progress.txt。完整 PRD 格式见 references/prd-format.md。其他细节暂未提供。