Skills Vetter

Skills Vetter - 技能安全审核工具

概述

Skills Vetter 是一个安全审核工具，用于验证 Claude Code skills 的安全性。在安装或使用新技能前，自动检查以下安全风险：

使用方法

1. 审核单个技能

# 审核本地技能
skills-vetter check ~/.claude/skills/my-skill/

# 审核远程技能（GitHub）
skills-vetter check https://github.com/user/skill-repo

2. 批量审核

# 审核所有已安装技能
skills-vetter check-all

# 审核指定目录
skills-vetter check-dir ~/.claude/skills/

3. 生成报告

# 生成详细报告
skills-vetter report my-skill/ --output report.md

# JSON 格式输出
skills-vetter report my-skill/ --format json

安全检查项

🔴 严重风险（自动拒绝）

🟠 高危风险（需要确认）

🟡 中危风险（建议修改）

🟢 低危风险（仅供参考）

审核流程

1. 静态分析
   ├── 解析 SKILL.md 和脚本文件
   ├── 检查代码模式匹配
   └── 提取敏感信息

2. 行为分析
   ├── 识别文件操作
   ├── 识别网络请求
   └── 识别系统调用

3. 依赖分析
   ├── 检查第三方包安全性
   ├── 识别已知漏洞依赖
   └── 检查依赖来源

4. 生成报告
   ├── 风险等级汇总
   ├── 详细问题列表
   └── 修复建议

报告示例

# Skills Security Report: my-skill

## Summary

| 风险等级 | 数量 |
|----------|------|
| 🔴 严重 | 0 |
| 🟠 高危 | 2 |
| 🟡 中危 | 3 |
| 🟢 低危 | 1 |

## Details

### 🟠 High Risk: Shell Command Execution
- **File**: scripts/run.py:42
- **Code**: `subprocess.call(user_input, shell=True)`
- **Fix**: 使用参数列表而非字符串，避免 shell=True

### 🟠 High Risk: Unrestricted File Write
- **File**: scripts/file_ops.py:15
- **Code**: `open(path, 'w')`
- **Fix**: 验证路径在允许的目录范围内

### 🟡 Medium Risk: No Timeout
- **File**: scripts/api.py:8
- **Code**: `requests.get(url)`
- **Fix**: 添加 timeout 参数

## Recommendation

⚠️ **不建议安装** - 存在 2 个高危风险需要修复

自动拒绝规则

以下情况将自动拒绝安装：

1. 检测到恶意代码 - 任何破坏性操作
2. 硬编码敏感凭证 - API Key、密码明文存储
3. 后门代码 - 隐藏的远程执行
4. 混淆代码 - 无法审计的加密代码
5. 已知的恶意来源 - 黑名单仓库

配置

在 ~/.claude/config.json 中配置审核规则：

{
  "skillsVetter": {
    "autoRejectLevel": "high",  // high, medium, low, none
    "strictMode": true,
    "whitelistedSources": [
      "github.com/official-plugins",
      "github.com/trusted-org"
    ],
    "blacklistedSources": [
      "github.com/malicious-user"
    ],
    "checkDependencies": true,
    "checkNetworkAccess": true
  }
}

与其他技能联动

• skill-creator: 创建技能后自动审核
• skill-seekers: 下载技能前先审核
• automation-workflows: 工作流执行前审核所有涉及的技能

注意事项

1. 审核仅做静态分析，无法保证 100% 安全
2. 高危技能需人工复核后才能使用
3. 建议在沙箱环境中测试新技能
4. 定期重新审核已安装的技能

命令速查