# git仓库下载
git clone https://github.com/wpsec/skills.git ~/.claude/skills/skill-sentinel

# 或者软链接已有项目
ln -s /path/to/Skill-Sentinel ~/.claude/skills/skill-sentinel

# 安装依赖
cd ~/.claude/skills/skill-sentinel && pip install -r requirements.txt

# 初始化扫描（扫描所有已安装 Skill）
/skill-sentinel

# 扫描指定目录
cd ~/.claude/skills/skill-sentinel && python3 -m skill_sentinel --scan-dir /path/to/skills

# 扫描单个 Skill
cd ~/.claude/skills/skill-sentinel && python3 -m skill_sentinel /path/to/skill

# 安装依赖
pip install -r requirements.txt

# 扫描 Skill（终端输出）
# 初始化安全基线（扫描所有已安装 Skill）
python3 -m skill_sentinel --init

# 扫描单个 Skill（终端输出）
python3 -m skill_sentinel /path/to/skill

# JSON 输出
python3 -m skill_sentinel /path/to/skill --json

# 导出报告
python3 -m skill_sentinel /path/to/skill -o report.json

# 使用自定义规则
python3 -m skill_sentinel /path/to/skill --rules my_rules.py

from skill_sentinel import scan_skill

result = scan_skill(\"/path/to/skill\")
print(result[\"risk_level\"])   # \"allow\" | \"review\" | \"block\"
print(result[\"risk_score\"])   # 0-100+

新 Skill 安装/加载
  │
  ▼
发现 Skill 根目录 → 解析 SKILL.md
  │
  ▼
构建资产图（入口→引用→脚本→配置→压缩包→间接依赖）
  │
  ▼
规则扫描（839 条正则规则）
  │
  ▼
风险评分 → allow / review / block
  │
  ▼
输出证据（文件:行号 + 规则 + 原因 + 建议）

MALICIOUS_PATTERNS = {
    r\"(?i)\\bos\\.system\\s*\\(\": \"执行系统命令 (os.system)\",
    r\"(?i)\\brm\\s+-rf\\s+/\": \"删除根目录\",
    # ...
}

python3 -m skill_sentinel /path/to/skill --rules my_rules.py

{
  \"skill_name\": \"example-skill\",
  \"skill_path\": \"/path/to/skill\",
  \"scan_time\": \"2026-06-22T16:49:17\",
  \"risk_level\": \"block\",
  \"risk_score\": 94,
  \"summary\": {
    \"total_files\": 123,
    \"scanned_files\": 159,
    \"total_findings\": 57,
    \"categories\": {\"8\": 36, \"5\": 18, \"3\": 3},
    \"severity_counts\": {\"critical\": 0, \"high\": 3, \"medium\": 5, \"low\": 49}
  },
  \"findings\": [
    {
      \"file\": \"/path/to/script.py\",
      \"line\": 42,
      \"rule\": \"执行系统命令 (subprocess)\",
      \"severity\": \"medium\",
      \"category\": 8,
      \"match\": \"subprocess.run\"
    }
  ],
  \"evidence\": [
    {
      \"file\": \"/path/to/script.py\",
      \"line\": 42,
      \"rule\": \"执行系统命令 (subprocess)\",
      \"category\": \"隐蔽下载与远程执行\",
      \"severity\": \"medium\",
      \"reason\": \"第 42 行匹配到规则: 执行系统命令 (subprocess)\",
      \"suggestion\": \"检查命令执行上下文，确认输入来源是否可信\"
    }
  ],
  \"asset_graph_summary\": {
    \"entry_file\": \"...\",
    \"scripts_count\": 39,
    \"configs_count\": 64,
    \"archives_count\": 0,
    \"indirect_deps_count\": 0
  }
}

SkillSentinel/
  skill_sentinel/       # 核心 Python 包
    scanner.py          # 正则扫描引擎
    rules.py            # 规则加载、分类、严重程度
    discovery.py        # Skill 发现与结构识别
    graph.py            # 资产图构建与遍历
    analyzer.py         # 风险评分与证据生成
    reporter.py         # JSON/终端输出
  rules/                # 规则文件
  scripts/              # CLI 入口
  tests/                # 测试套件（26 个用例）
  docs/                 # 文档