ralph
Autonomous task loop that picks ready tasks, implements them in new threads, commits, and repeats. Use when asked to "ralph", "use a ralph loop", or "ralph this".
📖 中文导读:Autonomous task loop that picks ready tasks, implements them in new threads, commits, and repeats. Use when asked to "ralph", "use a ralph loop", or "ralph this". 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: ralph description: Autonomous task loop that picks ready tasks, implements them in new threads, commits, and repeats. Use when asked to "ralph", "use a ralph loop", or "ralph this".
Ralph Loop
Autonomous task execution loop for this repository.
Workflow
Check for ready tasks
task_list action: "list", repoURL: "<repo-url>", ready: trueIf no ready tasks: Stop and report "Ralph complete - no ready tasks remaining."
If ready tasks exist:
- Pick the task most relevant to what was just completed (prefer related functionality, same module/area, or dependent work over unrelated tasks)
- If no prior context or unclear relevance, pick the first ready task
- Use the
handofftool with goal: "Implement and verify task [task-id]: [task-title]. [task-description]. When complete, consider if any learnings from this task should be added to AGENTS.md to improve future performance (e.g., common patterns, gotchas, useful commands). Then commit the changes with the commit-messages skill and invoke the ralph skill to continue the loop."
Task Discovery
While working, liberally create new tasks when you discover:
- Failing tests or test gaps
- Code that needs refactoring
- Missing error handling
- Documentation gaps
- TODOs or FIXMEs in the code
- Build/lint warnings
- Performance issues
- Any other issues worth addressing
Use task_list action: "create" to add these immediately. Set appropriate dependsOn relationships. Don't wait—capture issues as you find them.
Important
- Always pass
ready: truewhen listing tasks to only get tasks with satisfied dependencies - The handoff goal must include instructions to commit and re-invoke ralph
- Each iteration runs in a fresh thread to maintain clean context
- Prefer tasks in the same area/module as the just-completed work for better context continuity