用途：让 Claude Code 在定义清晰、可测试的任务上自主迭代，直到真正完成，无需人工反复提示。适合让测试通过、修复 lint、审计代码库、夜间或后台自主运行、多阶段审计等；不适合主观目标、一次性修复、每步都需人工判断或没有明确交付物的探索性研究。
主要能力：双模式架构——独立模式用 Stop 钩子保持会话存活，需 RALPH_ACTIVE=1（由启动脚本设置）；多智能体模式由路由器通过 Task() 反复生成 QA 智能体来管理迭代，不涉及 Stop 钩子，是 agent-studio 中的主模式。状态持久化用 JSON 文件记录迭代次数、时间戳与发现数；熔断器在发现数连续多轮不变时优雅退出；验证优先退出只在验证命令通过时接受完成信号；护栏文件累积过往失败教训。
使用方式：独立模式运行 .claude/ralph/ralph-audit.sh（Unix/macOS）或 .claude\ralph\ralph-audit.bat（Windows），脚本自动设置 RALPH_ACTIVE=1；也可手动 export RALPH_ACTIVE=1 后运行 claude --print-output-format text < .claude/ralph/PROMPT.md。多智能体模式在 agent-studio 内使用 /ralph-loop 命令。需自行在项目 .claude/ 下创建 PROMPT.md、Stop 钩子、护栏与启动脚本等文件。
配置：环境变量包括 RALPH_ACTIVE（必须为 1 才激活 Stop 钩子）、RALPH_MAX_ITERATIONS（默认 25）、RALPH_COMPLETION_SIGNAL（默认 RALPH_AUDIT_COMPLETE_NO_FINDINGS）、RALPH_CIRCUIT_BREAKER_THRESHOLD（默认 3）。完成信号为 RALPH_AUDIT_COMPLETE_NO_FINDINGS 或 RALPH_ITERATION_COMPLETE: N findings remain。
限制：Stop 钩子必须首先检查 RALPH_ACTIVE=1，否则会困住宿主或路由器会话；多智能体场景不应使用独立模式。必须设置最大迭代次数、状态文件与护栏，否则可能无限循环、丢失进度或重复犯错。TDD 模式使用单独的 tdd-state.json，已完成场景不得重复执行。其余细节暂未提供。