SuperAPI AI 工具集

flow-next-ralph-init

通用与其它

查看项目

更新于 10-15 21:53

技能介绍

用途:在仓库内搭建或更新 Ralph 自主运行骨架(harness),仅在用户运行 /flow-next:ralph-init 时触发,属可选启用。

主要能力:仅在当前仓库的 scripts/ralph/ 目录内创建或更新文件;若该目录已存在会先询问是否更新,并保留 config.env;从 templates/ 复制模板,并从 ${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/ 复制 flowctl 与 flowctl.py;为 ralph.sh、ralph_once.sh、flowctl 及 hooks/ralph-guard.py 设置可执行位。

使用方式:先以 git rev-parse --show-toplevel 解析仓库根目录,检查 scripts/ralph/ 是否存在;已存在时询问“Update existing Ralph setup? (preserves config.env and runs/) [y/n]”,回答 no 则停止,yes 则置 UPDATE_MODE=1,不存在则置 UPDATE_MODE=0。非更新模式下检测可用评审后端 rp-cli、codex、copilot,多个可用时让用户选择(回复 a/rp、b/codex、c/copilot 或直接说明),默认优先 rp > codex > copilot;均无则用 none。文件必须用 cp 复制而非 Write 工具;更新时先备份 config.env 到 /tmp/ralph-config-backup.env,复制模板与 flowctl 后再还原;全新安装则创建 runs 与 hooks 目录并整体复制。随后在 config.env 中把 PLAN_REVIEW、WORK_REVIEW、COMPLETION_REVIEW 占位符替换为所选后端。最后提示在终端(而非 Claude Code 内)运行 ./scripts/ralph/ralph_once.sh(单次迭代观察)与 ./scripts/ralph/ralph.sh(完整循环,AFK)。插件更新后可重新运行该命令刷新脚本;卸载需手动执行 rm -rf scripts/ralph/。

适用场景:需要在仓库内启用 Ralph 自主运行流程、且希望脚本与配置随插件更新同步时使用。

限制:只能操作当前仓库 scripts/ralph/;更新模式会跳过评审后端检测;提示的运行命令需在终端而非 Claude Code 内执行;资料未提供收费、平台支持范围及运行效果等信息。