用途：为工程团队引入 AI 编码智能体（Claude Code、Cursor、Copilot、Codex）时提供安全护栏，适用于首次接入、智能体可访问含密钥或基础设施配置的仓库、合规框架（SOC 2、ISO 27001、FedRAMP）要求对自动生成代码设控、以及自主或半自主智能体提交 PR 的场景。
主要能力：
- 权限边界：通过仓库根目录 CLAUDE.md 限制智能体行为（禁止读取 .env、.pem、.key，禁止执行 rm -rf、DROP TABLE、kubectl delete、terraform destroy，禁止直推 main/master，禁止未经批准修改 infrastructure/、terraform/、.github/workflows/）；用 .agent-permissions.yaml 定义命令允许/阻止清单与路径白名单。
- 文件系统控制：用 setup-agent-workspace.sh 创建受限 agent 用户，通过 chown/chmod/setfacl 仅授予 src、tests、docs 写权限，拒绝敏感目录访问。
- 密钥保护：用 git-secrets 安装 pre-commit 钩子并注册 AWS、私钥、GitHub、OpenAI、Slack 等模式；用 scan_agent_output.py 扫描智能体输出中的密钥；在 .git/hooks/pre-commit 中集成扫描，命中即阻止提交。
- 沙箱隔离：提供 Dockerfile.agent-sandbox 与 run-agent-sandbox.sh，以非 root 用户、--network none、--read-only、cap-drop ALL、内存/CPU/PID 限制运行；seccomp-agent.json 阻止网络与 ptrace 等系统调用。
- 代码审查门禁：GitHub Actions 工作流识别 AI 生成 PR（分支前缀 ai/、agent/ 或提交信息含生成标识），运行 Semgrep、Trufflehog 扫描，依赖文件变更需额外审查；用 configure-branch-protection.sh 为 ai/、agent/ 分支设置至少 2 名审批人与必需状态检查。
- 仓库配置：.cursorrules 规定禁止硬编码密钥、禁用 eval/exec、使用参数化查询、限制修改基础设施与 CI 文件等。
使用方式：将上述配置文件放入仓库对应位置，按需调整允许/阻止清单与路径，安装 git-secrets 与扫描脚本，构建沙箱镜像并挂载必要目录，配置 GitHub Actions 与分支保护规则。
限制：资料未提供具体版本兼容性、性能开销、误报率、许可协议或收费信息；示例中的组织名、仓库名、密钥模式需按实际环境替换；seccomp 与 ACL 配置依赖 Linux 环境，其他平台支持情况暂未提供。