技能安全验证器

面向AI代理的安全优先技能审查工具

概述

技能安全验证器 是一个安全优先的技能审查工具，用于在安装任何外部技能前进行安全检查。

为何重要

AI代理拥有高级权限，可以：

• - 执行任意命令
• 访问文件系统
• 发起网络请求
• 读取环境变量

未经审查的技能 = 安全风险

---

工作流程

┌─────────────────────────────────────────────────────────────────────────┐
│ 技能安全验证器流程 │
└─────────────────────────────────────────────────────────────────────────┘

用户请求
│
▼
┌─────────────────────┐
│ 1. 获取技能 │
│ - 克隆/解压 │
│ - 读取SKILL.md │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ 2. 并行扫描 │
│ ┌───────────────┐ │
│ │ 套接字检查 │ │ ← 检查出站连接
│ └───────────────┘ │
│ ┌───────────────┐ │
│ │ 漏洞扫描 │ │ ← 查询GitHub Advisory API
│ └───────────────┘ │
│ ┌───────────────┐ │
│ │ 代码模式 │ │ ← 扫描危险函数
│ └───────────────┘ │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ 3. 风险评分 │
│ - 计算总分 │ ← 网络 + 漏洞 + 权限
│ - 分类等级 │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ 4. 呈现结果 │
│ - 风险雷达图 │
│ - 警告信息 │
│ - 建议 │
└─────────────────────┘
│
▼
用户决策

---

核心职责

1. 风险评估

从三个维度评估技能：

维度	检查内容	风险等级
套接字/网络	出站连接、API调用	严重
代码质量

Snyk漏洞、依赖项 | 高 |
| 权限 | 文件访问、命令执行 | 高 |

2. 危险信号检测

常见可疑模式：

yaml
red_flags:
网络:
- 可疑域名（非标准顶级域）
- 硬编码IP地址
- 对未知域名的DNS查询
- 过多出站连接

执行:
- os.system() / 未经过滤的subprocess
- eval() / exec() 使用
- Shell注入模式
- 下载并执行代码

数据:
- 读取敏感环境变量
- 泄露文件
- 记录键盘输入
- 窃取凭证

权限:
- 过宽的文件权限
- 无提示的sudo/root
- 请求完全磁盘访问

3. 风险分类

┌─────────────────────────────────────────────────────────────┐
│ 风险分类 │
├──────────────┬──────────────┬─────────────────────────────┤
│ 等级 │ 分数 │ 操作 │
├──────────────┼──────────────┼─────────────────────────────┤
│ 🟢 安全 │ 0-10 │ 自由安装使用 │
│ 🟡 低 │ 11-30 │ 谨慎安装 │
│ 🟠 中 │ 31-60 │ 审查代码后决定 │
│ 🔴 高 │ 61-100 │ 请勿安装 │
└──────────────┴──────────────┴─────────────────────────────┘

---

评估标准

套接字/网络风险

告警数量	风险分数
0	0
1-2

10 | | 3-5 | 25 | | >5 | 50 |

代码/漏洞风险

严重程度	分数
严重	25
高

15 | | 中 | 10 | | 低 | 5 |

GitHub Advisory API 集成

使用 GitHub Advisory API 获取真实漏洞数据，不阻塞安装流程。

API: https://api.github.com/advisories
认证: 无需 Token（匿名 60次/小时）
TTL: 本地缓存 24 小时

流程:

1. 1. 用户触发安装 → 立即返回 安检中...
2. 后台并行: 克隆代码 + 查缓存 + 异步请求 API
3. 缓存命中? Yes → 直接返回 | No → 等 API (超时 5s)
4. 合并 Socket分析 + 代码模式 + 漏洞数据 → 呈现

权限范围风险

范围	分数
只读	0
网络调用

10 | | 文件写入 | 15 | | 命令执行 | 25 | | 完全系统访问 | 50 |

---

工作流程

用户: 安装技能 X
│
▼
┌─────────────────────┐
│ 1. 获取技能 │
│ - 克隆/解压 │
│ - 读取SKILL.md │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ 2. 安全扫描 │
│ - 套接字告警 │
│ - Snyk漏洞 │
│ - 代码模式 │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ 3. 风险评分 │
│ - 计算总分 │
│ - 分类等级 │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ 4. 呈现结果 │
│ - 风险等级 │
│ - 警告信息 │
│ - 建议 │
└─────────────────────┘
│
▼
用户决策

---

输出格式

进度条样式（推荐）

✅ weather - 风险评估

┌─────────────────────────────────────────┐
│ 📊 风险雷达图 │
├─────────────────────────────────────────┤
│ 网络 [░░░░░░░░░░░] 0/50 🟢 │
│ 漏洞 [░░░░░░░░░░░░] 0/25 🟢 │
│ 权限 [░░░░░░░░░░░░] 0/50 🟢 │
│ ───────────────────────────────────── │
│ 总计 [░░░░░░░░░░░░] 0/100 🟢 │
├─────────────────────────────────────────┤
│ 依赖项: curl, wttr.in │
│ 建议: ✅ 安全可安装 │
└─────────────────────────────────────────┘

实现逻辑

python

进度条渲染

def renderbar(score, maxscore, label, width=10):
percent = score / max_score
filled = int(percent * width)
bar = █ filled + ░ (width - filled)
emoji = getriskemoji(percent)
return f {label:<12} [{bar}] {score}/{max_score} {emoji}

颜色映射

def getriskemoji(percent): if percent < 0.2: return 🟢 if percent < 0.5: return 🟡 if percent < 0.8: return 🟠 return 🔴

安全技能

✅ skill-name - 风险评估完成

┌─────────────────────────────────┐
│ 🟢 低风险 │
│ 套接字告警: 0 │
│ Snyk问题: 0 │
│ 代码模式: 干净 │
└─────────────────────────────────┘

建议: 安全可安装使用。

包含内容:

• - 功能A
• 功能B

中等风险技能

⚠️ skill-name - 风险评估完成

┌─────────────────────────────────┐
│ 🟠 中风险 │
│ 套接字告警: 2 │
│ Snyk问题: 1 (中