SuperAPI AI 工具集

watchdog-approvals

编程与开发

查看项目

更新于 10-24 16:22

技能介绍

用途

watchdog-approvals 的核心用途是:当 Codex 反复对同一类安全动作(例如运行测试、读取日志、执行 git 操作)弹出审批确认时,把用户已经明确批准过的行为固化进 Codex 的审批配置,使下次执行同类动作不再反复弹窗,同时避免权限被放大到不可控范围。

其核心思想是只持久化“确定安全且高频”的动作,并使用最小化的 allowlist(可回滚、可审计)。

什么算“已批准”

仅指在当前会话中,用户对某一类操作明确说过“可以”“都授权”“以后别再问”或“加入 allowlist”。

不包括:

  • 没有得到用户明确授权的高风险动作(删除、执行未知二进制、访问敏感目录等)
  • 只做一次的临时动作(除非用户要求持久化)

Codex 审批配置位置

通常需要同时查看两处:

  • 项目信任级别(Project trust level)
    • 文件:~/.codex/config.toml
    • 键:[projects."<path>"] trust_level = "trusted" | "untrusted"
  • 命令允许规则(Command allow rules)
    • 文件:~/.codex/rules/default.rules
    • 格式:prefix_rule(pattern=[...], decision="allow")
    • 含义:当命令 argv 以 pattern 为前缀时,直接允许

这是用户机器上的安全边界配置,任何写入都必须可解释、可撤销、可最小化。

协作规则与安全纪律

写入审批配置前,必须做到:

  • 先提案,后落盘:列出候选允许项清单(每条含用途、风险、范围),让用户逐条确认(YES/NO)。
  • 最小化授权:优先 allowlist 仓库内固定脚本(例如 scripts/run_*.sh 或 scripts/run_*.ps1),不要直接 allowlist /bin/bash -lc <任意命令>;不要 allowlist 带用户输入参数的危险命令(例如 rm -rf <path>),除非 path 是固定且安全的;避免全局路径(例如把 /mnt/e/development 设为 trusted 会覆盖太多仓库,优先 repo root)。
  • 可回滚:修改前备份,例如 cp ~/.codex/rules/default.rules ~/.codex/rules/default.rules.bak、cp ~/.codex/config.toml ~/.codex/config.toml.bak;每次只加少量规则(1–5 条),验证通过再继续。
  • 可验证:写入后立刻执行一次“原本会弹审批”的动作,确认已静默通过。
  • 不伪造:不猜测用户想授权什么,只从用户明确批准过的行为提炼规则。

使用方式(工作流程)

第 1 步:会话中建立候选清单

当出现审批提示且用户批准时,立刻记录一条候选项:

  • 动作名称(如“运行无头 Godot 测试”)
  • 精确的命令 argv(更推荐引导改成固定脚本后再 allowlist 脚本)
  • 范围(只允许本仓库?只允许某个固定参数组合?)
  • 安全性理由(为什么这是安全、可控、高频的)

第 2 步:归一化为稳定的允许模式

按从安全到危险的优先级:

  1. allowlist scripts/<fixed entrypoint>(强烈推荐)
  2. allowlist git push、git status 这类低风险固定子命令
  3. allowlist 固定二进制加固定参数前缀(需要谨慎)
  4. 禁止 /bin/bash -lc "<anything>"(范围过大)

第 3 步:提案并逐条确认

以表格形式给用户逐条确认(YES/NO),例如:

  • Candidate:Run tests
  • Pattern:["scripts/run_godot_tests.ps1"]
  • Why:CI-equivalent
  • Risk:low
  • Persist:YES

第 4 步:写入配置并验证

  • 追加 prefix_rule(...) 到 ~/.codex/rules/default.rules
  • 如需信任仓库,写入 ~/.codex/config.toml 的 [projects."<repo-root>"] trust_level="trusted"
  • 运行一次验证命令(应不再弹审批)

执行清单

  1. 列出本次会话里重复出现的审批点(命令或行为)
  2. 对每个候选项写明:用途、风险、最小 pattern、是否可改成固定脚本
  3. 让用户逐条 YES/NO
  4. 备份配置文件:cp ~/.codex/rules/default.rules ~/.codex/rules/default.rules.bak 与 cp ~/.codex/config.toml ~/.codex/config.toml.bak
  5. 小步写入(1–5 条规则)
  6. 立刻验证一次“原本会弹审批”的动作
  7. 如果出现意外放权或误匹配,立刻回滚 .bak 并重新收敛 pattern

需立即停止的危险信号

  • “先全部设成 trusted 或 allow all,省事”
  • “给 /bin/bash -lc 做通配 allowlist”
  • “加一个 rm -rf * 的规则”
  • “没让用户逐条确认就落盘”

安全模式示例

建议优先 allowlist 固定脚本,而不是 Godot 二进制本身:

  • Windows:scripts\run_godot_tests.ps1
  • WSL/Linux:先封装一个 scripts/run_godot_tests_linux.sh(固定 GODOT_LINUX_EXE),再 allowlist 这个脚本

适用场景与限制

适用于使用 Codex 并在会话中反复遇到同类安全操作审批提示、希望按最小权限原则固化审批的用户。该技能本身不负责判定动作是否安全,安全判断与逐条确认仍依赖用户;对未明确授权的操作不做持久化。官方页面暂未提供更详细的价格、平台支持或版本说明。