Agent 与自动化Agent Skill
Catpilot AI Guardrails:面向 AI 编程智能体与智能体框架的安全技能集
catpilotai/catpilot-ai-guardrails · Security skills for AI coding agents, AI-assisted builders, and the agent harnesses built around them. Agent Skills format, no telemetry.
ELI5:它是什么,解决什么问题
该项目以 Agent Skills 格式提供面向 AI 编程智能体、AI 辅助开发者以及团队自建智能体框架的安全指导技能,仓库中包含两个技能:面向非开发者 AI 辅助构建场景的 catpilot-safe-building(八个通俗检查点,覆盖提示中的数据、访问与身份、托管、共享、密钥与凭据、第三方服务、不可信输入以及何时求助人类)和面向真实代码库编码智能体的 catpilot-security-core(九个工程组件,涉及云 CLI、数据库、本地 shell、Docker、硬编码密钥、密钥生命周期、供应链、PII 与测试数据、安全编码模式)。此外还提供 Agent 框架相关的标准指导、shell 工具凭据门禁 hook(secret_gate.py)以及重试、定时运行、委派和自修改的参考规则,并附带一个只读参考 MCP 服务器用于查询检查点指导、构建计划检查、常见应用安全起点和已批准策略。项目声明其技能属于建议性指导,只有两个 Claude Code PreToolUse hook(Bash 凭据拦截与 Write/Edit 私钥块拦截)构成实际执行控制。
核心能力与快速开始
★ 2 · Python
- 能做什么
- 提供 Agent Skills 格式的安全技能,包含 catpilot-safe-building(面向非开发者 AI 辅助构建的八个检查点)和 catpilot-security-core(面向编码智能体的九个工程安全组件:云 CLI、数据库、本地 shell、Docker、硬编码密钥、密钥生命周期、供应链、PII 与测试数据、安全编码模式)。同时提供面向智能体框架的标准指导(覆盖工具执行沙箱、破坏性操作的人类介入、记忆与上下文隔离、提示注入防御、多智能体协调与认证、速率限制与失控预防、定时任务幂等性、智能体身份完整性、工具循环纪律等)以及两个 Claude Code PreToolUse hook(Bash 凭据拦截、Write/Edit 私钥块拦截)。另包含一个参考 MCP 服务器,提供四个只读工具(单检查点指导、构建计划确定性检查、常见应用的安全起点、公司已批准内容),并支持通过 overlay 加载企业策略。
- 适用场景
- 适合使用 AI 助手构建应用、自动化、仪表盘或数据工具的非开发者及其助手参考安全构建检查点;适合在真实代码库中工作的编码智能体获取工程安全指导;适合构建自定义智能体循环(harness)的团队为循环提供标准安全指导、在 shell 工具路径上接入凭据门禁,并参考重试、定时运行、委派和自修改规则;也可通过参考 MCP 服务器在支持 MCP 的主机中查询安全指导与策略信息。
- 项目形态
- 可直接使用的工具
- 部署方式
- 提供多种安装方式:通过 npx skills add 安装到兼容宿主;Claude.ai 可将技能 zip 上传至 Customize → Skills 或由组织管理员统一配置;ChatGPT、Microsoft Copilot Studio、Lovable、Bolt、Replit、v0 可粘贴对应文本块;仓库型智能体可追加 AGENTS.md 或 copilot-instructions.md 内容;也可在自有 harness 中调用 secret_gate.py。参考 MCP 服务器可自行运行(需 Python 环境与依赖安装),或使用公开托管端点 https://mcp.catpilot.ai/mcp(无需认证,仅提供通用默认值,不加载企业 overlay)。
- 主要依赖
- 参考 MCP 服务器需 Python 环境,按 README 通过 pip 安装 requirements-dev.txt 依赖并设置 CATPILOT_OVERLAY_FILE 环境变量(可选)。hooks 针对 Claude Code PreToolUse 路径,需要宿主版本支持;README 中验证过的 Claude Code 版本为 2.1.241。托管端点无需额外依赖。其他宿主的兼容性未验证。
- 使用限制
- README 明确说明技能为建议性指导,仅在宿主选择加载时生效,不保证被加载、遵循或强制执行;除两个 Claude Code PreToolUse hook(各覆盖单一工具路径)和 harness 中显式接入的 secret_gate.py 外,不做监控、不发送遥测、不扫描仓库、不认证合规、不记录培训完成。参考 MCP 服务器无认证、无租户隔离、无日志、无出站调用;公开托管端点仅提供通用默认值,所有回答 policy_status 为 none 且 unknown_policy 为 true,不阻断任何操作。除表格中标注日期的运行时外,其他宿主未验证。
- 许可证
- MIT
- 最近推送
- 2026-09-16 06:39
资料检查:2026-09-16 07:00 · 卡片整理:2026-09-16 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证 · 本次更新未完成,保留上次成功内容
职业应用
程序员
在真实代码库中编写、修改代码或执行 shell 命令时,加载 catpilot-security-core 技能作为安全编码指导,覆盖云 CLI、数据库、本地 shell、Docker、硬编码密钥、密钥生命周期、供应链、PII 与测试数据、安全编码模式等九个工程组件;也可在自建智能体循环中调用 hooks/harness/secret_gate.py 作为 shell 工具的凭据门禁,在命令执行前拦截含明文凭据的命令。
查看内容依据
**`catpilot-security-core`** | Coding agents working in real codebases | Nine engineering components: cloud CLI, databases, local shell, Docker, hardcoded secrets, secrets lifecycle, supply chain, PII and test data, secure-coding patterns.
由 AI 根据来源材料整理,未进行安装或运行验证
产品经理
在借助 AI 助手构建应用、自动化、仪表盘或数据工具时,使用 catpilot-safe-building 技能的八个通俗检查点(提示中的数据、访问与身份、托管、共享、密钥与凭据、第三方服务、不可信输入、何时求助人类)作为安全构建指导。
查看内容依据
**`catpilot-safe-building`** | A person, often not a developer, building an app, automation, dashboard, or data tool with an AI assistant, and the assistant helping them | Eight plain-language checkpoints that mirror Catpilot's Safe AI-assisted building course: data in prompts, access and identity, hosting, sharing, keys and credentials, third-party services, untrusted input, when to ask a human.
由 AI 根据来源材料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。