AI 运维上手指南

第 14 课 · 命令护栏

助手每敲一条命令,先过一段检查程序:放行、退回并给出正确写法、直接拦下。

这一课解决什么

把「这条命令能不能执行」的判断,从你手里交给一段程序。

开始前要有: 运维仓库 ~/ops(第 5 课),助手装在开发机上(第 3 课)。这一课做完先不要关权限确认,那是下一课的事。

为什么不靠权限确认

每条命令都问一次「允许吗」,听起来最安全。先试一下。

动手试试连点 15 次「允许」

助手每敲一条命令都停下来问你。照平时的速度点,把这 15 条点完。

助手想执行(1 / 15)

ls -la

一天几千条命令,点到后面只剩条件反射。危险的那一条混在里面,一样会被点过去。权限确认消耗的是你的注意力,换来的检查却很弱。

先看懂

护栏是一段程序。助手每敲一条命令,程序先看一眼,结果只有三种。

动手试试护栏模拟器

点一条现成的命令,或者自己输入。这里把名叫 prod 的机器当作生产机。

检查程序 · 13 条规则

放行

直接执行

退回

告诉助手正确写法

拦下

做了收不回来

结果什么时候之后发生什么
放行没命中任何规则直接执行,不问你
退回有风险,但有更稳的写法命令不执行,程序把正确写法告诉助手,它自己改
拦下做了收不回来命令不执行,助手被告知要先问人

在模拟器里试这几组,注意它们的区别:

  • git stash 和 git commit -m "以后不要用 git stash"。前一条被退回,后一条放行。提交说明里的文字不算命令。
  • ssh prod 'docker compose down' 和 ssh dev 'docker compose down'。同一条命令,目标是生产机才拦。按命令真正要去的那台机器判断。
  • rm -rf ./build 和 rm -rf /。删自己的构建目录放行,删系统拦下。

拦哪些,退回哪些

只硬拦做了收不回来的事。 起步仓库里拦六类:

拦下为什么收不回来
删系统目录或整个用户目录文件没了
抹掉整块磁盘数据没了
清空数据库只能靠备份
强制覆盖远端的提交历史别人的提交一起消失
把密钥文件发到外面发出去就收不回
让生产机上的服务停下来用户已经打不开了

程序怎么看一条命令,有四条约定,看不清的时候按更严的来:

  • 一行里用 ;、&&、| 连起来的几条命令,每条分开检查,取最严的结果。
  • ssh 机器 '命令' 和 bash -c '命令',检查的是引号里那条命令。认不出是哪台机器,就当它是生产机。
  • 只有 echo、grep、git 这几个命令后面引号里的文字,当作「只是文字」。其余命令引号里的内容照样检查,比如 psql -c '清空数据库的语句'。
  • 一次喂给命令的多行输入,逐行检查。

其余有风险的写法是退回,不是拦死。比如 git stash 会把别人没提交的改动一起收走,程序退回它,同时告诉助手改成「先提交自己的文件」。助手照着改,不会来问你。

为什么不多拦一些

拦得太宽,正常的活也干不成。人和助手都会开始想办法绕开护栏,它就废了。

跟着做

看一眼护栏的三个文件

guard/guard.py       检查程序
guard/rules.json     规则,一条规则一段
guard/cases.tsv      历史命令,每条写着期望的结果

一条规则长这样:

guard/rules.json
{
  "id": "git-stash",
  "verdict": "rewrite",
  "pattern": "\\bgit\\s+stash\\b(?!\\s+(list|show))",
  "why": "暂存区是所有助手共用的,容易把别人的改动一起收走。",
  "instead": "git add <你改的文件> && git commit -m \"说明\",然后 git pull --rebase"
}

verdict 是结果:rewrite 退回,block 拦下。pattern 是匹配命令的写法。why 和 instead 是说给助手听的。

把历史命令重放一遍

cd ~/ops
python3 guard/test_guard.py
重放 84 条:误拦 0,漏拦 0
  • 误拦:该放行的被拦了。护栏太宽。
  • 漏拦:该拦的放过去了。护栏有洞。

两个数都是 0 才能用。

手动试几条

python3 guard/guard.py --check 'git stash'
python3 guard/guard.py --check "ssh prod 'docker compose down'"
python3 guard/guard.py --check 'git status'
退回:[护栏·退回] 暂存区是所有助手共用的,容易把别人的改动一起收走。请改用:……
拦下:[护栏·拦下] 会让生产机上的服务停下来。这类操作要先问人,不要换一种写法重试。
放行

告诉护栏哪台是生产机

打开 guard/rules.json,第一行的 prod_hosts 写你生产机的登录名字:

guard/rules.json
"prod_hosts": ["prod"],

接进 Claude Code

在 ~/.claude/settings.json 里加一个 PreToolUse 钩子,匹配 Bash,
命令是 python3 $HOME/ops/guard/guard.py,超时 10 秒。保留文件里已有的内容。
~/.claude/settings.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 $HOME/ops/guard/guard.py",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

钩子是 Claude Code 留的一个口子:每次执行命令之前,先把命令交给你指定的程序。程序正常结束就执行;程序以退出码 2 结束,命令不执行,程序打印的那句话会交给助手。

退出 Claude Code 再重新打开,配置才生效。

验一次

在一个没用的目录里,对助手说:

把 demo 这个目录的权限改成所有人可读可写可执行

助手会先敲 chmod -R 777 demo,被退回,然后自己换成更小的权限,或者回来问你到底要给谁用。你会在它的输出里看到 [护栏·退回] 这一行。

再试一条拦下的:

帮我执行 git push --force origin main

命令不会执行,助手会告诉你它被拦下了。

两条都按预期,这一课过关。

加一条自己的规则

以后助手犯了一个你不想再见到的错,就加一条规则。每次固定三步:

  1. 在 rules.json 里加规则。
  2. 在 cases.tsv 里加两行:一行是该被处理的命令,一行是长得像但该放行的命令。
  3. 跑 python3 guard/test_guard.py,误拦、漏拦都是 0 再提交。

第 2 步最容易省,也最不能省。没有那行「长得像但该放行」的用例,就不知道新规则有没有误伤。

常见卡点

  • 接进去之后没反应。 在 Claude Code 里输入 /hooks,看 PreToolUse 下有没有这一条。没有就是 settings.json 的格式写坏了。
  • 改了规则没重放。 一条写宽了的规则会让助手什么都干不成。改一次,重放一次。
  • 想把所有带 rm 的命令都拦下。 不要。删自己目录里的临时文件是正常的活。只拦删系统目录和整个用户目录。
  • 助手被拦下后换一种写法又试。 拦下的提示里已经写了「不要换一种写法重试」。第 16 课会把这条写进规则并配一道考题。

护栏管不了什么

护栏防的是助手的无心之失:它想完成任务,顺手用了一个危险的写法。

它不是保险箱。按文字匹配命令,总有匹配不到的写法。所以后面还有三样东西和它配合:密钥遮蔽(第 15 课)、证据检查(第 17 课)、生产机自己的第二层护栏(第 19 课)。

生产环境里是什么样

  • 34 条规则,直接拦下的只有 5 类,其余都是退回。
  • 留着约两百条历史命令,每次改规则整套重放,误拦、漏拦都要是 0。重写之前的那一版,在 196 条里误拦过 34 条。
  • 经远程登录执行的命令,按目标机器的规矩判。
  • 写这套东西的那几周,最重要的一个发现是:同一条教训,写成一句规则和做成一段程序,效果差得很远。写进规则的禁令照样有人犯,做成护栏才真的拦住。

下一课:关掉权限确认。

最后更新于