NVIDIA/SkillSpector

SkillSpector 是做什么的？

用于AI代理技能的安全扫描器。检测漏洞、恶意模式和安全风险。

概述

NVIDIA/SkillSpector 是一款专门为 AI 代理技能构建的安全扫描工具。它分析技能定义文件（如 SKILL.md、agent.md 等），识别潜在的安全漏洞、恶意行为模式以及配置风险。

特性

• 静态分析：无需执行代码即可检测风险。
• 模式匹配：基于已知恶意模式数据库进行检测。
• 权限审计：评估技能请求的权限是否合理。
• 敏感信息检测：扫描硬编码的密钥、令牌或凭据。
• 跨平台支持：适用于 Claude Code、Cursor、Codex 等 AI 代理平台。

快速开始

安装

pip install skillspector

使用

扫描单个技能文件：

skillspector scan SKILL.md

扫描整个项目目录：

skillspector scan ./path/to/skills/

输出

扫描结果以 JSON 格式输出，包含每个发现项的风险等级、描述和修复建议。

{
  "vulnerabilities": [
    {
      "severity": "high",
      "description": "发现可能执行任意命令的模式",
      "location": { "file": "SKILL.md", "line": 42 },
      "suggestion": "移除未授权的子进程调用"
    }
  ]
}

规则配置

你可以通过 .skillspector.yml 自定义扫描规则：

rules:
  - id: "disallowed-commands"
    enabled: true
    patterns:
      - "subprocess.run"
      - "os.system"
      - "eval("
  - id: "api-key-leak"
    enabled: true
    patterns:
      - "sk-[A-Za-z0-9]+"
      - "API_KEY="

集成

CI/CD

# GitHub Actions 示例
steps:
  - name: Run SkillSpector
    run: skillspector scan .

Pre-commit Hook

repos:
  - repo: https://github.com/NVIDIA/SkillSpector
    rev: v1.0.0
    hooks:
      - id: skillspector

支持

有关更多信息，请参阅完整文档。

许可证

本项目采用 Apache 2.0 许可证。