星标数:25810★ Fork数:2287 《SkillSpector:AI 代理技能安装前的安全漏洞扫描器》
SkillSpector 是一款针对 AI 代理技能(agent skills)的安全扫描器,用于在安装技能之前检测漏洞、恶意模式和安全风险。在 Claude Code、Codex CLI、Gemini CLI 等工具中使用的 AI 代理技能,往往以隐式信任的方式执行,几乎不经过审查。在研究数据集的 31,132 个技能分析子集中,26.1% 的技能包含漏洞,5.2% 表现出可能的恶意意图。
SkillSpector 帮助你回答这样一个问题:“这个技能安装起来安全吗?” 它是 NVIDIA Verified Skills 流水线的一部分,该流水线会在发布前对代理技能进行扫描、评估和签名;通过审查的技能会被发布到 NVIDIA skills 技能目录。
主要特点
- 多格式输入:可扫描 Git 仓库、URL、zip 文件、目录或单个文件
- 覆盖 17 个类别的 71 种漏洞模式,包括提示词注入、数据渗出、权限提升、供应链、代理越权、输出处理、系统提示词泄露、记忆投毒、工具滥用、流氓代理、反拒绝、触发器滥用、危险代码(AST)、污点追踪、YARA 签名、MCP 最小权限和 MCP 工具投毒
- 两阶段分析:快速静态分析 + 可选的 LLM 语义评估
- 实时漏洞查询:SC4 模块查询 OSV.dev 获取实时 CVE 数据,并自动回退到离线模式
- 多种输出格式:终端、JSON、Markdown 和 SARIF 报告
- 风险评分:0-100 分、严重级别标签和清晰的修复建议;支持基线/误报抑制,重复扫描时只暴露新增问题
快速开始
使用 uv 快速安装(仅 CLI):
uv tool install git+https://github.com/NVIDIA/skillspector.git
# 后续更新:uv tool update skillspector
如果需要运行 skillspector mcp,请在安装时包含 mcp 扩展:
uv tool install 'skillspector[mcp] @ git+https://github.com/NVIDIA/skillspector.git'
从源码安装(需先创建并激活虚拟环境):
# 克隆仓库
git clone https://github.com/NVIDIA/skillspector.git
cd skillspector
# 创建并激活虚拟环境
uv venv .venv && source .venv/bin/activate
# 或:python3 -m venv .venv && source .venv/bin/activate
# 安装用于生产使用
make install
无需安装 Python 时,可使用 Docker 构建并运行:
make docker-build
# 或:docker build -t skillspector .
# 扫描本地目录
docker run --rm -v "$PWD:/scan" skillspector scan ./my-skill/ --no-llm
基本用法示例:
# 扫描本地技能目录
skillspector scan ./my-skill/
# 扫描单个 SKILL.md 文件
skillspector scan ./SKILL.md
# 扫描 Git 仓库
skillspector scan https://github.com/user/my-skill
# 扫描 zip 文件
skillspector scan ./my-skill.zip
输出格式示例:
# JSON 输出(机器可读)
skillspector scan ./my-skill/ --format json --output report.json
# SARIF 输出(用于 CI/CD 集成和 IDE 工具)
skillspector scan ./my-skill/ --format sarif --output report.sarif
📊 本项目 GitHub 星标数:25810。最后更新:2026-11-13,发布:2026-11-04。项目地址:https://github.com/NVIDIA/SkillSpector
