用途:面向规格驱动开发(SDD),把「实现—评审—修复—清理—同步」拆成单步循环。每次调用只做一步,状态写入 fix_plan.json,下次从该文件恢复,避免一次性执行全部步骤导致上下文溢出。它只展示应在 CLI 中执行的命令,不直接执行任意 bash 命令。
主要能力:Python 编排脚本 ralph_loop.py 负责状态管理、任务选择与命令生成;支持按任务区间过滤(--from-task/--to-task)、依赖检查、评审失败最多重试 3 次、多 CLI 代理(claude、codex、copilot、kimi、gemini、glm4、minimax),可在任务 frontmatter 中按任务指定代理。状态文件固定位于 docs/specs/[ID-feature]/_ralph_loop/fix_plan.json,旧文件会自动迁移。
用法:初始化执行 python3 plugins/developer-kit-specs/skills/ralph-loop/scripts/ralph_loop.py --action=start --spec=docs/specs/001-feature/ --from-task=TASK-036 --to-task=TASK-041;随后用 --action=loop 获取当前步骤与应执行的命令,手动在 CLI 运行,再用 --action=loop 或 --action=next 推进状态;--action=status 查看进度;--no-commit 可跳过 git 提交。结合 Claude Code 的 /loop 5m 可周期执行。任务文件格式为 tasks/TASK-XXX.md,含 YAML frontmatter(id、title、status、lang、dependencies、complexity、agent)。
限制:该技能已废弃,旧命令 /specs:ralph-loop 将被移除,请迁移到 ralph-loop-v2。状态 step 仅允许 init、choose_task、implementation、review、fix、cleanup、sync、update_done、complete、failed。脚本不会自动执行命令,必须手动运行。要求 git 状态干净、测试可通过,否则回压无效。切勿在单次调用中同时实现、评审与同步。