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 status）、检测结果（findings）

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

⚠️ 此功能完全可选，且默认处于禁用状态。启用该功能需通过 --upload-url 显式配置。

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

当您配置了 --upload-url 时，将发送以下内容：

• 一份结构化的 JSON 报告，其中包含检测发现（findings）
• 您通过 --instance-id 提供的实例标识符（instance identifier）
• 绝不会传输任何 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 的内容将在基础层面被脱敏（redacted）。但这**不能保证所有敏感文本均被移除**：请仅使用可信端点，并确认其数据处理策略。

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

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

外部引擎集成

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

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

所需权限