用途：无人值守地循环推进一个功能的待完成阶段。每轮迭代调用 /dev-resume 从磁盘加载上下文、实现下一阶段、执行 /dev-checkpoint，然后用 /dev-judge 审核 diff；循环持续到功能完成、审阅升级或达到迭代上限。
主要能力与用法：先执行 bash "$DISCOVER" root 发现项目根目录（$DISCOVER 为本技能目录内 scripts/discover.sh 的绝对路径），并将结果存为 $PROJECT_ROOT。功能名取自 $ARGUMENTS 的第一个位置参数，为空则询问用户并停止。预检命令为 node "$CLI" list --json --afk --scan "$PROJECT_ROOT"，据此判断功能是否可 AFK 运行。需确认已安装官方市场的 ralph-loop 插件，否则停止并提示用 /plugins 安装后重跑 /dev-afk。随后读取提示模板并替换 {{FEATURE_NAME}}，默认迭代上限为 --max-iterations 20（用户提供 N 则用 N），调用：/ralph-loop "<composed prompt with feature interpolated>" --completion-promise "AFK DONE" --max-iterations <N>。调用后可查看 .claude/ralph-loop.local.md 前约 20 行确认提示未被破坏。监控可用 head -10 .claude/ralph-loop.local.md；取消用 /cancel-ralph。
适用场景：代码验收标准可完全由 diff 验证的阶段（lint、构建、测试）最合适；通常适合 1–3 个阶段的功能，5 个以上阶段建议拆分或手动运行。
限制：依赖磁盘上的 PRD、checkpoint、会话日志作为跨迭代权威状态；手动验证型验收条件（浏览器 DevTools、开发隧道、人工视觉比对）无法由循环满足，通常第 1 轮判为 revise、第 2 轮无新 diff 后升级退出。存在终止符竞态：停止钩子可能因转录刷盘时序错过 <promise>AFK DONE</promise>，导致多跑若干轮，可删除 .claude/ralph-loop.local.md 中断（磁盘工作保留）。提示模板已做防 shell 注入处理，替换时不要加入反引号、$、!。隐私方面，提示中不得包含带用户名的绝对路径、密钥或个人信息，只用功能名和相对路径。