用途:在当前仓库内搭建或更新 Ralph 自主运行框架(harness),仅在用户运行 /flow-next:ralph-init 时按需启用,属于 opt-in 操作。
主要能力:只在当前仓库创建或更新 scripts/ralph/;若该目录已存在,会询问是否更新,并在更新时保留 config.env 与 runs/;从 templates/ 复制模板,并从 ${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/ 复制 flowctl 与 flowctl.py;为 ralph.sh、ralph_once.sh、flowctl 设置可执行权限。
使用方式:先通过 git rev-parse --show-toplevel 解析仓库根目录,再检查 scripts/ralph/ 是否存在。若存在则询问是否更新,回答 no 则停止,回答 yes 则设 UPDATE_MODE=1;不存在则设 UPDATE_MODE=0。非更新模式下检测可用评审后端:HAVE_RP=$(which rp-cli >/dev/null 2>&1 && echo 1 || echo 0)、HAVE_CODEX=$(which codex >/dev/null 2>&1 && echo 1 || echo 0)、HAVE_COPILOT=$(which copilot >/dev/null 2>&1 && echo 1 || echo 0)。多个可用时询问用户选择 rp、codex 或 copilot,默认优先级 rp > codex > copilot;仅一个可用则用该后端;都不可用则用 none。复制文件必须使用 cp 而非 Write 工具。更新模式先备份 config.env 到 /tmp/ralph-config-backup.env,复制模板与 flowctl、flowctl.py、hooks/ralph-guard.py 后恢复 config.env;全新安装则创建 runs 与 hooks 目录,用 cp -R 复制模板(含 .gitignore 等点文件),再复制 flowctl、flowctl.py 与 hooks/ralph-guard.py,并 chmod +x 相关脚本。非更新模式下编辑 scripts/ralph/config.env,将 PLAN_REVIEW、WORK_REVIEW、COMPLETION_REVIEW 的占位符替换为所选后端。最后提示在终端(而非 Claude Code 内)运行 ./scripts/ralph/ralph_once.sh 观察单次迭代,或 ./scripts/ralph/ralph.sh 进行完整循环。
适用场景:需要在仓库内初始化或刷新 Ralph 自主运行框架时。
限制:仅操作当前仓库的 scripts/ralph/;更新会保留 config.env 与 runs/;插件更新后需重新运行 /flow-next:ralph-init 刷新脚本;卸载需手动执行 rm -rf scripts/ralph/。