（14105期）vigil – AI 代理实时安全防火墙

AI 代理实时安全防火墙 来自 hexitlabs 的开源 AI 代理安全护栏，零依赖架构毫秒级拦截危险指令与注入攻击，为工具调用提供实时防护与审计能力。 使用说明 Vigil 是一款专为 AI 代理设计的轻量级安全护栏工具，通过在工具调用执行前进行实时验证，有效拦截破坏性命令、服务器端请求伪造（SSRF）、SQL 注入、路径遍历、数据泄露及提示注入等多种攻击向量。作为 vigil-agent-safety npm 包（仅 12.3KB）的封装层，它能在不到 2 毫秒的时间内完成安全检测，为零依赖环境下运行的 AI 代理提供开箱即用的安全保护。 该技能的核心用法十分直观：开发者只需在代理执行工具调用前插入 checkAction() 检查，即可根据返回的决策（ALLOW/BLOCK/ESCALATE）决定是否继续执行。Vigil 提供三种运行模式以适应不同场景——warn 模式仅记录违规行为而不阻断，适合初期观察；enforce 模式直接阻断危险调用，适用于生产环境；log 模式则静默记录供审计使用。此外，内置的 restrictive、moderate 和 permissive 策略模板允许开发者根据安全需求灵活调整规则严格程度。 Vigil 的显著优势在于其极致的轻量化和全面性。基于 22 条精心设计的检测规则，它能在无外部依赖的情况下识别 rm -rf / 等破坏性命令、元数据端点访问等 SSRF 攻击、以及 Base64 编码绕过等高级威胁。开源的 Apache 2.0 许可证和透明的代码库（GitHub: hexitlabs/vigil）确保了工具的可审计性，而 CLI 工具和脚本包装器则方便了与现有工作流的集成。 然而，该技能也存在一定局限性。作为外部 npm 包的包装器，SKILL.md 中未提供 package.json 或 package-lock.json 来锁定依赖版本，这意味着用户需要自行验证 vigil-agent-safety 包的完整性和版本一致性。此外，虽然该工具能有效拦截常见攻击模式，但不应被视为唯一的安全防线，在高安全要求的生产环境中仍需结合其他安全措施。 目标用户群体主要包括构建 AI 代理的开发者、设计 MCP（Model Context Protocol）服务器的工程师，以及需要为自动化脚本添加安全审计层的运维人员。特别适合那些需要代理执行 shell 命令、文件操作或外部 API 调用，但又担心提示注入或恶意指令导致系统受损的场景。 使用风险方面，除了前述的供应链依赖风险外，由于该工具依赖模式匹配而非深度语义分析，可能存在误报或漏报的情况。建议首次部署时先使用 warn 模式观察行为，并定期关注上游安全规则的更新。同时，开发者应确保通过 npm 官方源安装依赖，并在可能的情况下指定具体版本号以避免潜在的供应链攻击。 原始说明 AI agent safety guardrails for tool calls. Use when (1) you want to validate agent tool calls before execution, (2) building agents that run shell commands, file operations, or API calls, (3) adding a safety layer to any MCP server or agent framework, (4) auditing what your agents are doing. Catches destructive commands, SSRF, SQL injection, path traversal, data exfiltration, prompt injection, and credential leaks. Zero dependencies, under 2ms.