用途：Sigil 为 AI 智能体代码提供八阶段安全分析，用于在克隆仓库、安装 pip/npm 包、审查 MCP 服务器配置或使用陌生技能前做风险检查。
主要能力：检测安装钩子、危险代码模式、网络外传、凭据访问、混淆、来源问题、提示注入与 AI 技能安全威胁。输出单个 JSON，含 verdict、score、files_scanned、findings_count、各阶段结果与逐条 findings（阶段、严重度、权重、规则 ID、文件、行号、片段）。另提供环境审计（检查 .env、家目录凭据文件权限、shell 历史泄露、智能体可访问目录）与已安装技能审计（枚举 ~/.agents/skills/、~/.claude/skills/、~/.cursor/skills/、~/.roo/skills/、~/.codex/skills/ 等路径）。
使用方式：首次使用先运行 bash scripts/setup.sh 校验 CLI，失败可手动安装 brew install nomarj/tap/sigil、npm install -g @nomarj/sigil 或 cargo install sigil-cli。扫描用 bash scripts/scan.sh <target>，target 支持本地路径、GitHub URL、owner/repo、npm 包、pip:包名或任意 URL。环境审计用 bash scripts/audit-env.sh，技能审计用 bash scripts/audit-skills.sh，报告生成用 bash scripts/scan.sh <target> | bash scripts/report.sh 或 bash scripts/report.sh results.json。
结果解读：0-9 为 LOW RISK/CLEAN，10-24 为 MEDIUM RISK，25-49 为 HIGH RISK，50+ 为 CRITICAL RISK/CRITICAL；InstallHooks 阶段出现 Critical 严重度会立即升级判定。退出码 0 表示低风险，非零表示中风险及以上。
限制：判定基于自动化模式检测，不构成安全保证或恶意意图的最终认定；不应将代码定性为“安全”或“恶意”；中风险及以上需用户明确批准后才可继续安装或执行。规则与评分细节见 references/PHASES.md、references/SCORING.md，故障排查见 references/TROUBLESHOOTING.md。