dev-ralph
Persistence loop — keep working on a task until it's resolved or until a circuit breaker stops you. Different from /loop (which is time-based) — ralph is iteration-based with state.
适合你，如果需要一个自动重试直到成功的循环工具
npx oh-my-skill add evolution-foundation/evo-nexus/dev-ralphcurl -fsSL https://oh-my-skill.com/install.sh | bash -s -- evolution-foundation/evo-nexus/dev-ralphnpx oh-my-skill verify evolution-foundation/evo-nexus/dev-ralph怎么用
商店整理自技能原文 · 版本 7f5dd76 · 表述以原文为准Claude 会反复执行同一任务，每次基于前一次结果调整，直到任务完成、达到 5 次上限或连续 3 次相同失败才停止。每次迭代会记录尝试内容和失败原因。
当任务有明确的完成信号（如“测试通过”），但不确定需要迭代多少次时触发。常用于“修复直到测试通过”这类自动修正循环。
技能原文 SKILL.md
Dev Ralph
Derived from oh-my-claudecode (MIT, Yeachan Heo). Adapted for the EvoNexus Engineering Layer.
Persistence loop. Keep iterating on a task until it's resolved, with a circuit breaker for safety. Different from /loop (which runs a prompt every N minutes) — ralph runs the same agent repeatedly until a goal is met.
Use When
- Task has a clear completion signal but unclear iteration count
- "Fix until tests pass" type work
- Auto-correcting loops where each iteration uses the previous result
Do Not Use When
- Time-based polling → use
/loop(built-in) - Single-shot work
- No clear completion signal (you'll loop forever)
Iron Rules
- Completion signal must be defined upfront — "tests pass" or "build green" or "verifier APPROVES"
- Circuit breaker: stop after 5 iterations OR after 3 identical failures
- State persisted between iterations — what's been tried, what failed, why
- Never silently spin — emit progress every iteration
Workflow
Iteration 1: - Run agent (e.g., @bolt-executor) with task - Check completion signal - If met: STOP, success - If not: record what was tried, what failed - Increment iteration counter Iteration 2: - Run agent with task + accumulated state - Check completion signal - ... Iteration 5 (max): - Stop and report: "Reached max iterations without completion" - Hand off to @apex-architect with full state dump OR 3-identical-failure breaker: - If iteration N produces the same error fingerprint as N-1 and N-2 - Stop immediately - The issue is no longer "fix the bug" — it's "question the approach"
Output
Per iteration, emit:
[ralph iteration {N}/{max}]
Goal: {completion signal}
Tried: {what this iteration did}
Result: {success | failure: {reason}}
State: {what's been tried so far}
Final report saved to workspace/development/debug/[C]ralph-{topic}-{date}.md.
Pairs With
@bolt-executor(most common driver)@hawk-debugger(for bug-fix loops)@oath-verifier(provides the completion signal)@apex-architect(escalation when circuit breaker trips)
Cancellation
Interrupted by dev-cancel — preserves state for resume.