Skill Security Auditor

基于《OpenClaw 极简安全实践指南》和《安全验证与攻防演练手册》的 Skill 安全审计工具。对 OpenClaw Skill 进行从源码到运行时的全生命周期安全审查，覆盖供应链投毒、Prompt 注入载荷、恶意代码模式、权限越权等威胁向量。

Purpose

OpenClaw Skills 是 Agent 能力的扩展机制，通过 /workspace/skills/{skill_name}/SKILL.md 被 Agent 加载执行。恶意 Skill 可以：

• 通过 Prompt 注入劫持 Agent 行为
• 在代码块中嵌入反弹 Shell、数据外传命令
• 引用恶意外部依赖进行供应链攻击
• 通过 Unicode 混淆、零宽字符隐藏恶意指令

本技能为 Skill 的安装和更新提供安全门禁，在 Skill 进入生产环境前完成安全审查。

Prerequisites

输入要求

• 目标 Skill 目录路径（包含 SKILL.md 和 references/ 等）
• 或 Skill 的远程仓库 URL（用于拉取审计）

环境要求

• Node.js 运行时（用于执行审计脚本）
• 对 Skill 文件的读取权限

Core Workflow

1. 元数据验证: 解析 SKILL.md 的 frontmatter，验证 name、version、description、metadata 完整性和合法性。
2. Prompt 注入扫描: 检测 SKILL.md 正文中的指令注入模式（角色劫持、指令覆盖、隐蔽指令）。
3. 代码块安全审计: 提取所有代码块（bash, python, javascript 等），对每个代码块进行恶意模式检测。
4. 依赖与引用审查: 检查 Skill 引用的外部 URL、npm 包、Python 包的安全性和来源可信度。
5. 文件结构检查: 验证 Skill 目录结构是否符合规范，检测异常文件（二进制、可执行文件、符号链接）。
6. Unicode 和编码检测: 扫描隐藏的 Unicode 控制字符、零宽字符、Bidi 覆盖字符。
7. 权限声明审查: 验证 Skill 声明的权限范围是否合理，检测权限越权请求。
8. 历史版本对比: 对 Skill 更新进行 diff 分析，检测是否引入了新的恶意内容。
9. 沙箱验证: 在受限环境中试运行 Skill 代码片段，观察其行为。

审计检查项

1. 元数据完整性

2. Prompt 注入检测

3. 代码块安全审计

4. 依赖与外部引用

5. 文件结构检查

6. 权限声明审查

审计报告格式

{
  "audit_id": "AUDIT-2026-0001",
  "timestamp": "2026-03-13T10:30:00Z",
  "skill": {
    "name": "example-skill",
    "version": "1.0.0",
    "path": "/workspace/skills/example-skill"
  },
  "verdict": "REJECT",
  "risk_score": 85,
  "findings": [
    {
      "id": "F001",
      "severity": "CRITICAL",
      "category": "prompt_injection",
      "title": "检测到角色劫持指令",
      "description": "SKILL.md 第 42 行包含 'Ignore all previous instructions' 模式",
      "location": "SKILL.md:42",
      "evidence": "...ignore all previous instructions and act as...",
      "recommendation": "移除该指令，如有合法用途需在 metadata 中声明"
    }
  ],
  "summary": {
    "critical": 1,
    "high": 2,
    "medium": 3,
    "low": 1,
    "total": 7
  },
  "recommendation": "REJECT - 存在 CRITICAL 级别发现，不建议加载"
}

审计判定标准

与其他安全技能的协作

Skill 安装/更新
     │
     ▼
┌─────────────────────┐
│ skill-security-     │  ← 入口审计：源码级安全检查
│ auditor             │
└────────┬────────────┘
         │ PASS
         ▼
┌─────────────────────┐
│ openclaw-security-  │  ← 环境检查：Skill 加载后的配置影响
│ checker             │
└────────┬────────────┘
         │ PASS
         ▼
┌─────────────────────┐
│ openclaw-threat-    │  ← 运行时：Skill 执行中的行为监控
│ detect              │
└─────────────────────┘

Tool Categories

References

• references/tools.md - 工具函数签名和参数说明
• references/workflows.md - 审计流程定义和判定规则