工具层与 Git 层双保险
6 个 PreToolUse 拦截器在 Write、Edit、NotebookEdit、Read、Grep 与 Bash 阶段离线快速介入,4 个 Git 钩子在提交、合并与推送阶段联网复查。
它能做到什么程度(已实现能力)
6 个离线 PreToolUse 包装器拦截高危写入、Secret 读取与护栏篡改(放行安静 exit 0,绝不输出 permissionDecision: "allow");配合 SessionStart 自动刷新动态名单。pre-commit、pre-merge-commit、commit-msg 与 pre-push(--net)统一强制 R1–R7、6h TTL 缓存、非通用 ed25519 SSH 签名直验(ssh-keygen -Y check-novalidate)与基于真实 ls-remote 的 known_content 重签豁免。policy/check.py、refresh-private.py、bootstrap.sh、doctor.py 与 scan-repo.py 的参数契约与示例。明确不做什么(边界与硬限制)
R5 禁止推送至 claude/、codex/ 等 15 个 Agent 分支前缀,但 main 分支保护和强推阻断有意交给 CNB / GitHub Rulesets。Glob 调用:forbid-read-path.sh 仅拦截可返回文件正文的 Read / Grep;高权限本机用户若绕过 Shell 提醒,最终强制防线为 Git 层钩子与远端权限隔离。/root/.claude/... 模板路径,必须经 policy/bootstrap.sh 改写至 $GUARD(且产品包钩子与本仓库维护脚本 tools/repo_maintenance_guard.py 严格分离)。源码仓库本身预置了待改写的部署模板路径;正式使用需通过 policy/bootstrap.sh 铺设到 $GUARD(默认为 $HOME/.claude/guardrails)。在任何目录运行以下命令可只读检查本机接线与缓存健康度:
python3 policy/doctor.py
# 未铺设过的源码目录预期输出 Overall: DEGRADED;铺设且刷新缓存后预期 Overall: PASS按照读者需求快速跳转
bootstrap.sh 铺设流程与只读自检 doctor.py;policy.json 参数、多来源聚合逻辑、常见报错与 known_content 边界;PreToolUse/SessionStart 载荷、check.py CLI 契约与规则定制要点;