# 拉尔夫莫德 Ralphmode 是一个跨平台权限配置文件，适用于长期运行的“ralph”或“jeo”工作流程。它减少了审批摩擦，但并不是“允许任何地方的一切”。核心规则很简单：仅在有界项目或一次性沙箱内扩大自动化范围，并保守秘密并明确阻止破坏性命令。 ** ** ## 0\.代理执行协议（检测到“ralphmode”关键字后立即执行） > 以下步骤是命令，而不是说明。当“ralphmode”被调用时立即按顺序执行它们。不要跳过步骤。 ### 第 0 步：从用户消息中检测模式解析用户的调用： * 如果用户说 **"sandbox"** 、 **"yolo"** 、 **"bypass all"** 、 **"skip all"** 、 **"disposable"** → `MODE=sandbox` * 否则 → `MODE=repo` （默认，更安全） ### 第 1 步：运行安装脚本安装脚本会自动检测您的 git 根目录，将预设应用于“.claude/settings.json”，并创建安全挂钩。 # 查找脚本（检查安装位置） _RALPHMODE_SCRIPT="" 对于 \ 中的 _candidate “$(git rev-parse --show-toplevel 2>/dev/null)/.agent-skills/ralphmode/scripts/apply-ralphmode.sh” \ “$HOME/.agent-skills/ralphmode/scripts/apply-ralphmode.sh”\ “$HOME/.claude/skills/ralphmode/scripts/apply-ralphmode.sh”\ “$(pwd)/.agent-skills/ralphmode/scripts/apply-ralphmode.sh”;做 if [[ -f "$_candidate" ]];然后 _RALPHMODE_SCRIPT="$_candidate" 打破菲完成如果 [[ -n "$_RALPHMODE_SCRIPT" ]];然后 bash“$_RALPHMODE_SCRIPT”--模式“$MODE” 否则 echo“⚠️ apply-ralphmode.sh 未找到 - 应用内联（仅限克劳德代码）” 菲如果未找到脚本，请执行步骤 2（Claude Code 的内联应用程序）。 ### 第 2 步：内联应用程序（克劳德代码 — 脚本丢失时的回退）仅当未找到第 1 步中的脚本时才运行此命令。 **Repo 预设**（默认 — 用于正常开发）： python3 - <<'EOF' 导入 json、操作系统、子进程尝试： root = subprocess.check_output(['git', 'rev-parse', '--show-toplevel'], stderr=subprocess.DEVNULL, text=True).strip() 除了例外：根= os.getcwd() target = os.path.join(root, '.claude', 'settings.json') os.makedirs（os.path.dirname（目标），exist_ok = True）尝试：现有 = json.loads(open(target).read()) if os.path.exists(target) else {} 除了例外：现有 = {} 现有['_ralphmode_previous_permissions'] =现有.get('权限') 现有['权限'] = { 'defaultMode': '接受编辑', '允许'：[ 'Bash(npm *)', 'Bash(pnpm *)', 'Bash(bun *)', 'Bash(yarn *)', 'Bash（python3 *）'，'Bash（pytest *）'， 'Bash(git status)', 'Bash(git diff)', 'Bash(git add *)', 'Bash(git 提交 *)', 'Bash(git 日志 *)', 'Bash(git 推送)', '读取(*)'、'编辑(*)'、'写入(*)' ], '否认'：[ '读取（.env*）'，'读取（./secrets/**）'， 'Bash(rm -rf *)', 'Bash(sudo *)', 'Bash(git Push --force*)', 'Bash(git reset --hard*)' ] } 将 open(target, 'w') 作为 f： json.dump（现有，f，ensure_ascii = False，缩进= 2） print(f'✓ Repo 预设应用于 {target}') EOF **沙盒预设**（仅适用于一次性环境）： python3 - <<'EOF' 导入 json、操作系统、子进程尝试： root = subprocess.check_output(['git', 'rev-parse', '--show-toplevel'], stderr=subprocess.DEVNULL, text=True).strip() 除了例外：根= os.getcwd() target = os.path.join(root, '.claude', 'settings.json') os.makedirs（os.path.dirname（目标），exist_ok = True）尝试：现有 = json.loads(open(target).read()) if os.path.exists(target) else {} 除了例外：现有 = {} 现有['_ralphmode_previous_permissions'] =现有.get('权限') 现有['权限'] = {'defaultMode'：'bypassPermissions'} 将 open(target, 'w') 作为 f： json.dump（现有，f，ensure_ascii = False，缩进= 2） print(f'✓ 沙箱预设应用于 {target}') EOF ### 第 3 步：确保安全钩存在 HOOK="$HOME/.claude/hooks/ralph-safety-check.sh" 如果[[！ -f“$HOOK”]]；然后 mkdir -p "$(目录名 "$HOOK")" 猫 > "$HOOK" << 'HOOKEOF' #!/usr/bin/env bash CMD=$(echo "$CLAUDE_TOOL_INPUT" | python3 -c \ “导入 sys,json; print(json.load(sys.stdin).get('command',''))” 2>/dev/null) TIER1='(rm[[:space:]]+-rf|git[[:space:]]+reset[[:space:]]+--hard|git[[:space:]]+push.*--force|DROP[[:space:]]+TABLE|[[:space:]]sudo[[:space:]]|chmod[[:space:]]+777|\.env|secrets/)' 如果回显“$CMD”| grep -qE "$TIER1";然后 echo“已阻止：检测到 1 级危险命令。” >&2 echo "命令：$CMD" >&2 2号出口菲钩夫 chmod +x "$HOOK" echo "✓ 已创建安全钩子: $HOOK" 否则 echo "✓ 安全钩存在: $HOOK" 菲 ### 第 4 步：向用户报告申请后，告诉用户： 1.应用了哪个预设（`repo`或`sandbox`） 2.写入哪个文件（`.claude/settings.json`路径） 3. 允许/拒绝列表包含哪些内容 4. 如何恢复：`rm .claude/settings.json`（项目本地）或恢复`~/.claude/settings.json`（全局） 5. **重新启动 Claude Code** 以激活权限更改 ** ** ## 什么时候使用这个技能 * 你希望“ralph”能够迭代而不需要重复的批准弹出窗口。 * 您正在为 Claude Code、Codex CLI 和 Gemini CLI 设置相同的存储库。 * 您需要一个共享的安全模型：仅存储库写入，无秘密读取，默认情况下无破坏性 shell。 * 您希望日常自动化和真正的 YOLO 模式之间有更强的分离。 ## 说明 ### 步骤 1：首先定义自动化边界在更改任何权限模式之前： * 选择一个项目根并将自动化范围限制在那里。 * 列出必须保持阻止状态的文件和命令：`.env*`、`secrets/**`、生产凭证、`rm -rf`、`sudo`、未选中的 `curl |嘘`。 * 决定这是一个普通的仓库还是一次性沙箱。如果答案是“一次性沙箱”，您可以使用平台的最高自治模式。如果没有，请改用 repo 范围内的预设。 ### 第 2 步：为每个平台选择一个预设仅使用与当前工具匹配的部分： * Claude Code：日常预设优先，“bypassPermissions”仅适用于隔离沙箱。 * Codex CLI：优先使用当前官方批准和沙盒模型；将旧的“permissions.allow”和“permissions.deny”片段视为仅兼容性。 * Gemini CLI：仅信任项目根目录；不存在真正的全局 YOLO 模式。详细模板位于 [references/permission-profiles.md]()。 ### 步骤 3：在本地而不是全局应用配置文件，除非工作空间是一次性的优先选择项目本地配置而不是用户全局默认配置。 * Claude 代码：从项目 `.claude/settings.json` 开始。 * Codex CLI：从项目配置和存储库指令或规则文件开始。 * Gemini CLI：信任当前文件夹，而不是“~/”或广泛的父目录。如果必须使用用户全局默认值，请将其与更严格的拒绝列表和沙箱边界配对。 ### 步骤 4：使用显式验证循环运行 Ralph 配置权限后： 1. 确认任务及验收标准。 2. 运行“ralph”或“jeo”计划-执行-验证循环。 3. 在声明完成之前验证输出。 4. 如果自动化配置文件是临时的，请在运行后恢复它。推荐执行合约：边界检查 -> 权限配置文件 -> ralph run -> 验证 -> 清理或恢复 ### 步骤 5：将“跳过”和“安全”分开将这些视为不同的模式： * 回购自动化：有限工作空间内的最少提示。 * 沙箱 YOLO：仅在一次性环境中快速执行。不要将它们合并为一个共享的团队默认值。 ### 步骤 6：配置中间执行批准检查点静态权限配置文件（步骤 2-3）可减少运行开始前的摩擦，但它们不会阻止执行期间出现的危险操作。添加动态检查点，以便在尝试第 1 层操作时被阻止或标记。 #### 危险操作等级等级 |行动|平台响应 ---|---|--- **第 1 层**（始终阻止）| `rm -rf`、`git reset --hard`、`git push --force`、`DROP TABLE`、`sudo`、`.env*`/`secrets/**` 访问、生产环境更改 |立即阻止，需要明确的用户批准 **第 2 层**（警告）| `npmpublish`、`dockerpush`、`gitpush`（非强制）、数据库迁移 |输出警告，确认后才继续 **第 3 层**（允许）|文件读取/编辑、测试、本地构建、lint |自动允许 #### 平台检查点机制平台|钩|封锁|推荐图案 ---|---|---|--- 克劳德·代码 | `PreToolUse` (Bash) |是 — 2 号出口 | Shell 脚本模式匹配命令；区块 1 级双子座 CLI | `BeforeTool` |是 - 非零退出 | Shell脚本块工具； stderr 进入下一轮法典 CLI | `通知`（回合后）|没有 | `approval_policy="unless-allow-listed"` \+ 提示合同开放代码 |无 |没有 | `opencode.json` 指令中提示合约 **原理**：将静态配置文件（步骤 2-3）与动态检查点（此步骤）相结合。 * 具有预工具挂钩的平台（Claude Code、Gemini）：使用挂钩脚本。 * 没有平台（Codex、OpenCode）：依赖“approval_policy”和显式提示合约，指示代理输出“CHECKPOINT_NEEDED：”并在继续执行第 1 层操作之前等待。有关每个平台的完整挂钩脚本模板，请参阅 [references/permission-profiles.md]()。 ## 示例 ### 示例 1：Claude Code 沙箱运行使用 [references/permission-profiles.md]() 中的 Claude 沙箱预设，然后仅在该隔离的存储库中运行 Ralph： /ralph“修复所有失败的测试”--max-iterations=10 ### 示例 2：Codex CLI 沙箱 Ralph 运行对于沙箱 ralph 运行，请直接使用 CLI 标志： codex -c model_reasoning_effort="高" --dangerously-bypass-approvals-and-sandbox -c model_reasoning_summary="详细" -c model_supports_reasoning_summaries=true 对于存储库范围（非沙箱）运行，请使用 [references/permission-profiles.md]() 中的配置文件方法：批准政策=“从不” sandbox_mode =“工作空间写入” 将其放入“~/.codex/config.toml”（或项目本地覆盖）中，并在运行 Ralph 之前重新启动 Codex。 ### 示例 3：Gemini CLI 沙箱或仅信任设置对于沙盒 ralph 运行，请使用 `--yolo` 模式：双子座--yolo 对于正常的存储库自动化，请通过显式文件选择信任当前项目文件夹，并仅针对该存储库运行 Ralph 工作流程。有关详细信息，请参阅 [references/permission-profiles.md]()。 ## 最佳实践 * 默认为最不宽松的预设，但仍可让 Ralph 端到端完成。 * 即使批准减少，也要保留秘密拒绝列表和破坏性命令拒绝列表。 * 仅在具有明确项目边界的一次性环境中使用完全旁路。 * 记录应用了哪个预设，以便队友可以重现或恢复它。 * 升级 CLI 版本时重新检查平台文档，因为权限模型的变化速度快于技能内容。 ## 参考文献 * [什么是特工技能？]() * [特工技能规范]() * [权限配置文件]() * [克劳德代码权限]() * [Codex 配置和规则]() * [ChatGPT Codex 沙盒和审批模式]() * [Gemini CLI 信任文件夹]()

拉尔夫莫德

包含技能