SuperAPI AI 工具集

ai-coding-agent-guardrails

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:为工程团队引入 AI 编码智能体时提供安全护栏指导,明确权限边界、密钥防护、评审门禁、沙箱隔离与审计轨迹,适用于 Claude Code、Cursor、Copilot、Codex 等工具。

主要能力:

  1. 权限边界:在仓库根目录创建 CLAUDE.md,禁止读取或输出 .env、secrets.yaml、.pem、.key 等敏感文件;禁止执行 rm -rf、DROP TABLE、kubectl delete、terraform destroy;禁止直推 main/master;修改基础设施与工作流目录前须经用户批准;安装依赖前须先列出供审阅。允许读取修改 src/、lib/、tests/,运行 npm test、pytest、go test 及 eslint、ruff、golangci-lint,创建 ai/ 或 agent/ 前缀分支。
  2. 命令允许清单:通过 .agent-permissions.yaml 定义 allowed_commands、blocked_commands、blocked_paths、allowed_paths,如允许 git status、git diff、npm test,阻止 curl、ssh、kubectl、terraform、docker push、npm publish。
  3. 文件系统控制:用独立系统用户 ai-agent 配合 setfacl 仅授予 src、tests、docs 写权限,拒绝 .env、infrastructure、.github/workflows 访问。
  4. 密钥防护:使用 git-secrets 注册模式并安装 pre-commit hook,在提交前扫描 AI 生成内容中的 AWS 密钥、GitHub Token、OpenAI/Anthropic 密钥、Slack Token、私钥、JWT、硬编码密码等;命中则阻止提交。
  5. 沙箱隔离:以 Docker 运行智能体,禁用网络、只读根文件系统、限制内存与 CPU、drop 全部能力、加载限制性 seccomp 配置,并仅挂载必要目录。

适用场景:首次将 AI 编码智能体引入团队;智能体接触含密钥或基础设施配置的仓库;SOC 2、ISO 27001、FedRAMP 合规需要自动化代码生成控制;需统一多智能体与成员的安全策略。

限制:仅作指导,须在授权范围内使用,破坏性步骤先在非生产环境验证;本条目为纯文档导入,上游辅助脚本与模板未随附;具体平台支持与收费信息暂未提供。