Skill Vetter Pro 🔒🛡️

专业级技能安全审查系统

核心能力

• 四维安全审查：静态扫描 → 行为监控 → 完整性校验 → 依赖 CVE
• 子会话推送保障：强制 sessions_yield 绑定，解决推送失败问题
• 完整 SOP：六阶段全链路审查，从触发到记录可追溯

When to Use

• 安装任何 skill 前必须审查
• 第三方来源的 skill 必须全面审查
• 官方 skill 常规复审
• 收到安全告警后复审

四维审查体系

触发词

• "审查技能"、"全面审查"、"深度安全审查"
• "检查这个skill"、"帮我审核"
• "vetting"、"skill安全检查"
• "查这个skill有没有风险"

📋 完整执行流程 SOP

阶段一：接收与解析

触发词匹配后：

1. 确认审查目标路径
2. 判断触发类型（首次审查 / 复审 / 快速审查）
3. 根据 policy/default-policy.md 判断需要哪些维度

阶段二：依赖检查

# 检查 Docker
docker info > /dev/null 2>&1 && echo "Docker OK" || echo "Docker unavailable"

# 检查镜像
docker images python:3-alpine --format "{{.Repository}}" | grep -q alpine && echo "Image OK" || echo "Image not found"

# 检查脚本
ls /home/strong/.openclaw/workspace/skills/skill-vetter-pro/scripts/skill_vet.py

依赖缺失时的处理：

阶段三：子会话执行审查

【关键】sessions_spawn 指令：

sessions_spawn(
  task="对 /home/strong/.openclaw/workspace/skills/[目标skill] 进行完整安全审查。

【强制要求】
- 所有步骤完成后，必须调用 sessions_yield 推送结果
- sessions_yield 是工具调用，不是描述，禁止仅在回复中提及而不调用

【步骤1】来源验证
ls /home/strong/.openclaw/workspace/skills/[目标skill]/
head -10 /home/strong/.openclaw/workspace/skills/[目标skill]/SKILL.md
cat /home/strong/.openclaw/workspace/skills/[目标skill]/_meta.json 2>/dev/null

【步骤2】维度一：静态扫描（必须）
docker run --rm \
  -v /home/strong/.openclaw/workspace/skills/[目标skill]:/skill:ro \
  -v /home/strong/.openclaw/workspace/skills/skill-vetter-pro/scripts/skill_vet.py:/vet.py:ro \
  python:3-alpine \
  python3 /vet.py /skill

【步骤3】维度三：哈希清单生成（推荐）
python3 /home/strong/.openclaw/workspace/skills/skill-vetter-pro/scripts/skill_integrity_checker.py \
  --save /home/strong/.openclaw/workspace/skills/[目标skill] \
  /home/strong/.openclaw/workspace/skills/skill-vetter-pro/records/[目标skill]-manifest.json

【步骤4】维度四：依赖CVE检查（如有依赖文件）
python3 /home/strong/.openclaw/workspace/skills/skill-vetter-pro/scripts/dependency_cve_checker.py \
  /home/strong/.openclaw/workspace/skills/[目标skill]

【步骤5】逐文件人工审查
读取所有 .py .sh 文件，参考 references/checklist.md 逐项检查。

【步骤6】生成完整报告
格式参考 references/vetting_report_template.md

【步骤7】追加审查日志
将结论追加到 records/vetting-log.md

【步骤8】强制推送（不可跳过）
调用 sessions_yield 工具：
sessions_yield(message="[完整报告全文，不含任何占位符]")
",
  runtime="subagent",
  sessionTarget="isolated"
)

阶段四：报告汇总与裁决

阶段五：安装前完整性校验

python3 skill_integrity_checker.py \
  --verify /home/strong/.openclaw/workspace/skills/[目标skill] \
  /home/strong/.openclaw/workspace/skills/skill-vetter-pro/records/[目标skill]-manifest.json

# 一致 → 执行安装
# 不一致 → 拒绝安装，报告被篡改

阶段六：记录持久化

# 审查记录已自动追加到 records/vetting-log.md
# 哈希清单已保存到 records/[目标skill]-manifest.json

工具脚本说明

skill_vet.py（AST扫描器）

自检结果：21/21 全通过（13 恶意样本全检出，8 良性样本零误报）

检测能力：

skill_integrity_checker.py（SHA256 哈希链）

# 审查时保存
--save <skill路径> [manifest.json]

# 安装前验证
--verify <skill路径> <manifest.json>

dependency_cve_checker.py（OSV API CVE 检查）

支持：requirements.txt、package.json、Gemfile、go.mod、composer.json、Cargo.toml

skill_behavior_monitor.py（strace 行为监控）

# 在有 strace 的环境中使用
python3 skill_behavior_monitor.py <skill路径> <执行命令>

监控：系统调用、文件修改、进程创建、网络连接

scanner_self_test.py（扫描器自检）

# 定期验证扫描器自身可信度
python3 scanner_self_test.py [skill_vet.py路径]

# 期望结果：21/21 全部通过

文件结构

skill-vetter-pro/
├── SKILL.md
├── _meta.json
├── CHANGELOG.md
├── scripts/
│   ├── skill_vet.py              # AST扫描器（21/21自检通过）
│   ├── skill_integrity_checker.py # SHA256哈希链
│   ├── dependency_cve_checker.py  # OSV API CVE检查
│   ├── skill_behavior_monitor.py  # strace行为监控
│   ├── scanner_self_test.py       # 扫描器自检
│   └── skill_checker.py          # 正则辅助扫描
├── references/
│   ├── checklist.md               # 四阶段审查清单
│   └── vetting_report_template.md # 报告模板
├── records/
│   └── vetting-log.md            # 审查历史日志
└── policy/
    └── default-policy.md         # 默认策略规则

记录层

所有审查结论自动追加到 records/vetting-log.md，包含：
- 审查时间、skill 名称、版本
- 裁决结果、风险等级、简要原因
- 报告摘要

策略层

policy/default-policy.md 定义：

安全不是功能，而是基础。 🔒