# 使用 uv（推荐）
uv pip install cisco-ai-skill-scanner

# 使用 pip
pip install cisco-ai-skill-scanner

# 用于 LLM 分析器和元分析器
export SKILL_SCANNER_LLM_API_KEY="your_api_key"
export SKILL_SCANNER_LLM_MODEL="claude-3-5-sonnet-20241022"

# 用于 VirusTotal 二进制扫描
export VIRUSTOTAL_API_KEY="your_virustotal_api_key"

# 用于 Cisco AI Defense
export AI_DEFENSE_API_KEY="your_aidefense_api_key"

skill-scanner

# 扫描单个技能（核心分析器：静态 + 字节码 + 流水线）
skill-scanner scan /path/to/skill

# 使用行为分析器进行扫描（数据流分析）
skill-scanner scan /path/to/skill --use-behavioral

# 使用所有引擎进行扫描
skill-scanner scan /path/to/skill --use-behavioral --use-llm --use-aidefense

# 使用元分析器进行误报过滤
skill-scanner scan /path/to/skill --use-llm --enable-meta

# 使用触发分析器检查模糊描述
skill-scanner scan /path/to/skill --use-trigger

# 多次运行 LLM 分析器并保留多数同意的发现
skill-scanner scan /path/to/skill --use-llm --llm-consensus-runs 3

# 递归扫描多个技能
skill-scanner scan-all /path/to/skills --recursive --use-behavioral

# 使用跨技能重叠检测扫描多个技能
skill-scanner scan-all /path/to/skills --recursive --check-overlap

# 扫描 GitHub 仓库（owner/repo 简写或完整 URL）
skill-scanner scan-repo owner/repo
skill-scanner scan-repo https://github.com/owner/repo --use-llm

# 宽松模式：容忍格式错误的技能，而不是失败
skill-scanner scan /path/to/skill --lenient
skill-scanner scan-all /path/to/skills --recursive --lenient

# 宽松模式，配合非标准技能格式（不需要 SKILL.md）
skill-scanner scan .claude/commands/deploy --lenient
skill-scanner scan-all .claude/commands --recursive --lenient

# 使用自定义元数据文件名而不是 SKILL.md
skill-scanner scan /path/to/skill --skill-file README.md

# CI/CD：如果发现威胁则构建失败
skill-scanner scan-all ./skills --fail-on-severity high --format sarif --output results.sarif

# 生成带有攻击关联分组的交互式 HTML 报告
skill-scanner scan /path/to/skill --use-llm --enable-meta --format html --output report.html

# 使用自定义 YARA 规则
skill-scanner scan /path/to/skill --custom-rules /path/to/my-rules/

# 使用自定义分类 + 威胁映射配置文件（JSON/YAML）
skill-scanner scan /path/to/skill --taxonomy /path/to/taxonomy.json --threat-mapping /path/to/threat_mapping.json

# VirusTotal 哈希扫描，可选上传未知文件
skill-scanner scan /path/to/skill --use-virustotal --vt-upload-files

# 使用扫描策略预设（strict, balanced, permissive）
skill-scanner scan /path/to/skill --policy strict

# 使用自定义组织策略文件
skill-scanner scan /path/to/skill --policy my_org_policy.yaml

# 生成一个可自定义的策略文件
skill-scanner generate-policy -o my_org_policy.yaml

# 交互式策略配置器（TUI）
skill-scanner configure-policy

from skill_scanner import SkillScanner
from skill_scanner.core.analyzers import BehavioralAnalyzer

# 使用分析器创建扫描器
scanner = SkillScanner(analyzers=[
    BehavioralAnalyzer(),
])

# 扫描一个技能
result = scanner.scan_skill("/path/to/skill")

print(f"发现: {len(result.findings)}")
print(f"最高严重等级: {result.max_severity}")

# 注意：is_safe 表示未检测到 HIGH/CRITICAL 发现。
# 它不能保证技能完全安全，没有风险。
if not result.is_safe:
    print("检测到问题——部署前请审查发现")

$ skill-scanner scan ./my-skill --use-behavioral

============================================================
技能: my-skill
============================================================
状态: [OK] 未发现
最高严重等级: NONE
发现总数: 0
扫描耗时: 0.15s

# .github/workflows/scan-skills.yml
name: 扫描技能
on:
  pull_request:
    paths: [".cursor/skills/**"]
jobs:
  scan:
    uses: cisco-ai-defense/skill-scanner/.github/workflows/scan-skills.yml@main
    with:
      skill_path: .cursor/skills
    permissions:
      security-events: write
      contents: read

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/cisco-ai-defense/skill-scanner
    rev: v1.0.0  # 使用最新发布标签
    hooks:
      - id: skill-scanner

skill-scanner-pre-commit install