Skill Security Scanner 产品介绍

一、产品概述

Skill Security Scanner 是一款面向 AI Agent 智能插件（Skills）的专用安全扫描工具，专注于深度检测技能代码中的安全漏洞、恶意行为与风险模式，为 AI 智能体插件全生命周期提供安全审计与风险管控能力。

核心定位：企业级、可独立部署的 Skills 代码安全扫描工具

---

二、行业背景与产品意义

行业背景

随着 AI Agent（智能体）技术的快速发展，Skills（技能插件）作为 AI Agent 扩展能力的核心单元，正在被广泛使用。然而，Skills 在带来强大功能的同时，也引入了严重的安全风险。攻击者可以将恶意逻辑伪装成正常 Skills，通过供应链传播、提示注入、数据窃取、远程代码执行等方式攻击终端用户。

安全研究人员已发现大量恶意 Skills 实例：根据公开研究，截止2026年3月20日，LobeHub 平台存在 不少于38 个已标注的恶意 Skills（HuggingFace 16个 + AISA Group 22个），OpenClaw 生态中已收录 352 条恶意/可疑 Skills 记录，Agent Skills 市场中已收录 347 条恶意/可疑 Skills 记录。这些恶意 Skills 涵盖云端训练投毒、Web 测试注入、文档处理远程执行、系统信息外传、数据窃取、支付漏洞等多种攻击向量。

详见 lobehub-malicious-skills.md 、openclaw-malicious-skills-/和agent-skill-malware.md，了解更多风险类型：供应链风险、提示注入风险、数据窃取风险、远程执行风险。

---

行业痛点

在 AI Agent 爆发初期，Skills 安全处于"裸奔"状态。虽然目前已有部分安全工具开始关注 Skills 安全问题，但存在以下痛点：

1. 评估体系缺失：Skills 代码缺陷问题本质上偏向传统安全，但目前尚没有一款工具支持 CVSS 评分，导致 Skills 风险的评估缺乏科学性
2. 工具化局限：目前市面上的 Skills 扫描工具多处于"小工具"阶段，不具备提供系统性能力支持的能力

痛点解决方案

针对上述行业痛点，Skill Security Scanner 采用多种扫描器（静态规则）+ LLM 语义分析 + CVSS 评分的技术路线，破解 Skills 安全审计难题，核心特性如下：

• 零依赖：无外部第三方依赖，支持离线独立部署
• 服务化：支持 REST API，可融入企业安全体系
• 可私有化：支持完全本地部署，数据不出网
• 可商业化：提供完整的产品能力，支持企业级需求

---

产品核心功能

🔍 安全扫描（18 种风险检测能力）

🤖 LLM 深度语义分析（18+N 扩展检测能力）

🌐 多种使用方式

⚙️ 灵活配置

---

产品优势

竞品对比

四大优势

1. 通用性：不限制 Agent 平台或框架，任何 Skills 都可以扫描
2. 专业性：18+N 检测能力 + CVSS 3.1 评分，科学量化风险
3. 工程化：REST API + 离线部署 + 多格式输出，具备企业级产品能力
4. 灵活性：支持私有化部署，数据不出网，安全可控

---

检测能力

检测器列表

检测能力详解

🔴 CRITICAL 级别

🟠 HIGH 级别

🟡 MEDIUM 级别

🟢 LOW 级别

---

扫描范围

• 文件类型：Markdown (SKILL.md)、Python、JavaScript、Shell、YAML、JSON 等
• 代码模式：恶意命令、危险函数、敏感操作等
• 威胁情报：已知恶意域名、IP、哈希等
• 语义分析：通过 LLM 理解代码意图，发现隐蔽威胁

---

使用场景

1. 开发阶段安全检测

python -m skill_scanner --path /path/to/skill --severity high

2. CI/CD 集成

python -m skill_scanner --path ./skill --format sarif --severity high -o results.sarif

3. LLM 深度分析

python -m skill_scanner --path /path/to/skill --use-llm --llm-provider openai

4. 批量扫描

for dir in /skills/*/; do
  python -m skill_scanner --path "$dir" --format json -o "reports/$(basename $dir).json"
done

5. Web 界面交互扫描

python -m skill_scanner.web_ui --port 9000

访问 http://localhost:9000

---

技术规格

---

性能特点

---

快速开始

安装

pip install -r requirements.txt
pip install -e .

基本使用

# 基本扫描
python -m skill_scanner --path /path/to/skill

# HTML 报告
python -m skill_scanner --path /path/to/skill --format html -o report.html

# 过滤严重级别
python -m skill_scanner --path /path/to/skill --severity high

# 启用 LLM 分析
python -m skill_scanner --path /path/to/skill --use-llm

# 启用所有检测器
python -m skill_scanner --path /path/to/skill --use-ioc --use-yara --use-llm

Web 界面

python -m skill_scanner.web_ui --port 9000

REST API

python -m skill_scanner.api_server --port 8080

curl -X POST http://localhost:8080/scan \
  -H "Content-Type: application/json" \
  -d '{"path": "/path/to/skill", "format": "json"}'

---

效果展示

🌐 例1：工具扫描效果

🌐 例2：Web界面展示

1. 命令行，启用web界面

2. 访问Web界面，配置扫描参数，开始扫描

3. 查看扫描结果报告

• 更多扫描结果，进入目录skill_scanner/reports/查看

许可模式

• 开源版本：基础功能免费使用
• 商业版本：提供专业功能，如批量扫描、专业LLM深度分析、244小时支持等
• 本地部署：支持完全离线部署

---

获取支持

• 技术文档：参考本项目文档目录
• 部署指南：参考 DEPLOY.md
• 使用手册：参考 MANUAL.md
• CVSS 评分：参考 CVSS.md
• 命令行帮助：python -m skill_scanner --help
• Web 界面：访问 http://localhost:9000

联系我们

• 官网：https://www.aimohu.com