Skill Scan Wrapper

在安装本地 skill、归档包或 release bundle 之前，使用该 skill 进行快速安全检查。

⚠️ 安全须知

本工具默认在本地执行扫描，要求用户信任您所运行的二进制文件。原生 LLM 审查会向用户配置的端点发送大小受限的文本数据包；外部 LLM 审查则遵循对应外部扫描器的数据政策。下载后请务必校验校验和（checksum）。如需最高安全性，建议从源码构建（推荐）。

附带二进制文件

运行前请先在本地校验：

sha256sum assets/bin/skillscan
# 将输出结果与上方 SHA-256 值比对

该打包版本包含预编译二进制文件。若您倾向自行构建，仍可选择从源码编译：

git clone https://gitee.com/random_player/cmic-skill-scanner.git
cd cmic-skill-scanner && cargo build --release

前置条件

• 默认 auto 模式将优先尝试调用本地可解析的 external scanner；若无可用 scanner，则回退至内置 native 引擎
• 不安装 external scanner 亦可正常使用：单体二进制会自动回退至 native 引擎
• --upload-url 和 --use-llm 功能默认禁用，仅在用户显式配置时启用

信任模型

这是一个开源（MIT-0 许可证）软件包。所附带或下载的二进制文件仅为便利性用途 —— 它本身不赋予任何额外信任保障。

您的可选方案：

默认行为与信任边界：

• CMIC 不会在您未配置 --upload-url 的情况下上传报告
• CMIC 不会在您未设置 --use-llm 的情况下配置 LLM 端点
• auto 模式可能执行本地解析到的 external scanner；如需禁止此行为，请使用 --engine native
• 除非您明确指定扫描路径中包含相关文件，否则 CMIC 不会将凭据（credentials）或 SSH 配置作为扫描目标进行访问

工作流程

1. 调用 skillscan：

skillscan review /path/to/target --format markdown
skillscan review /path/to/skills --output-dir /tmp/skillscan-out

2. 阅读输出内容中的以下字段：输入类型（input type）、完整度（completeness）、engine 执行状态（engine status）、发现项（findings）

网络上传功能（默认禁用）

⚠️ 此功能完全可选且默认禁用。 必须通过 --upload-url 显式配置方可启用。

该功能仅适用于报告上传。LLM 审查是另一项独立且需显式启用的网络功能；已解析的 external scanner 则拥有其自身的依赖关系与网络行为。

上传内容说明（仅当您配置了 --upload-url 时）：

• 一个包含检测结果的结构化 JSON 报告
• 您通过 --instance-id 提供的实例标识符
• 绝不会传输任何 skill 源码、凭据或系统配置信息

可选 LLM 审查

⚠️ 此功能完全可选且默认禁用。 需显式指定 --use-llm，并兼容 native、external 和 auto 三种引擎模式。

skillscan review /path/to/target --engine native --use-llm   --llm-endpoint http://localhost:11434/v1   --llm-model your-model

在 native 模式下，LLM 端点将接收静态检测结果摘要，以及目标包中最多 24 个文本文件（每个文件不超过 8 KiB，总计不超过 64 KiB）。文件中行名匹配 api_key、token、password、secret 或 authorization 的内容将在基础层面被脱敏处理。但请注意：这并不能保证所有敏感文本均被移除；请仅使用您信任的端点，并确认其数据处理策略。

对于兼容 Cisco 的 external 引擎，CMIC 将添加 --use-llm 参数，并通过 SKILL_SCANNER_LLM_* 环境变量向子进程传递 LLM 端点、模型及可选密钥；外部扫描器自行控制其请求数据包构造、脱敏逻辑与失败处理行为。auto 模式将优先尝试调用该 external LLM，失败后回退至 native 引擎。API 密钥绝不会写入扫描命令或报告中。

若 native LLM 请求失败，仍会返回 native 静态分析结果，且 engine.fallback_reason 字段将记录失败原因。

外部引擎集成

默认 auto 模式会首先尝试调用本地可解析的 external scanner，当其不可用或执行失败时，再回退至 native 引擎。您可使用 --engine external 强制仅使用 external 引擎结果，或使用 --engine native 强制仅运行内置引擎。

CMIC 将目标路径传递给用户配置的本地工具。该工具以当前用户的进程权限运行；您需单独信任该 external 工具及其配置。仅当显式设置 --use-llm 时，CMIC 才会为 external 引擎配置 LLM 端点；否则 external 工具可自主引导依赖项或使用其自有网络配置。

所需权限