指令与配置保护

助手交出来的样子

$ git diff --stat origin/main
 app/api/notes.py            | 14 ++++++++++--
 pyproject.toml              |  2 +-      ← max-complexity: 10 → 25
 .cursor/rules/testing.mdc   |  3 ++-     ← 新增「核心路径可豁免测试」
 3 files changed

## 合并请求说明
修复笔记接口分页，补充了两条测试。

.github/CODEOWNERS（谁必须签字）

第一列是路径，第二列是必须批准的账号。写具体账号，不写小组名——写小组名等于没有人。

# 指令类文件：会被助手读进上下文，风险最高
/AGENTS.md                        @zhangsan
/CLAUDE.md                        @zhangsan
/.claude/                         @zhangsan
/.cursor/                         @zhangsan
/.trae/                           @zhangsan

# 检查配置：决定检查判什么
/Makefile                         @lisi
/pyproject.toml                   @lisi
/.github/workflows/               @lisi

# 高风险业务路径
/app/api/notes.py                 @wangwu
/migrations/                      @wangwu

.claude/settings.json（注册拦截钩子）

PreToolUse 匹配写文件的工具，命中就调脚本。字段名以 Claude Code 官方文档为准。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "python3 scripts/guard/deny-instruction-write.py"
          }
        ]
      }
    ]
  }
}

scripts/guard/deny-instruction-write.py（拦住助手改写指令文件）

从标准输入读事件 JSON，命中受保护路径时以退出码 2 阻止，并把原因写给模型。退出码 2 是非零里唯一会把标准错误当作反馈退回给助手的一个。

#!/usr/bin/env python3
"""PreToolUse 钩子：拦住对指令类文件的写入。"""
import fnmatch
import json
import os
import sys

# 与 .github/CODEOWNERS 的指令类路径保持一致
PROTECTED = [
    "AGENTS.md", "CLAUDE.md",
    ".claude/settings.json", ".claude/commands/*", ".claude/skills/*",
    ".cursor/rules/*", ".trae/rules/*", ".github/instructions/*",
    "Makefile", "pyproject.toml",
]

def is_protected(path):
    root = os.getcwd()
    rel = os.path.relpath(os.path.abspath(path), root).replace(os.sep, "/")
    return any(fnmatch.fnmatch(rel, p) for p in PROTECTED)

def main():
    try:
        event = json.load(sys.stdin)
    except (json.JSONDecodeError, ValueError):
        return 0
    tool_input = event.get("tool_input", {})
    target = tool_input.get("file_path") or tool_input.get("path") or ""
    if target and is_protected(target):
        sys.stderr.write(
            "拒绝写入受保护文件：%s\n"
            "指令与检查配置必须由人提交。请给出改动建议，由人执行。\n" % target
        )
        return 2
    return 0

if __name__ == "__main__":
    sys.exit(main())