前言¶
从 SkillHub、仓库或同事分享目录安装 Agent Skill 时，常见做法是先看 README 和触发词，很少系统检查脚本、依赖与供应链风险。Skill 一旦被 Agent 加载，可能接触工作区文件、环境变量或执行外部命令；问题往往在「已经装上」之后才暴露。
下面介绍 skill-scanner：在安装或使用某个 Skill 之前，用本地静态分析做一次安全向检查，分析过程不把 Skill 文件内容或凭据发到外部。
这是什么¶
skill-scanner 是 SkillHub 上社区发布的 Skill（坐标 @user_87fe1a85/gwchen17，当前版本 1.0.0），分类为 it-ops-security。能力由 Tencent Zhuque Lab A.I.G（AI-Infra-Guard） 提供支撑；页面标注 requires_api_key=false，不依赖额外 API Key。
定位可以概括为：对任意 Agent Skill 做安全风险扫描，采用 100% 本地静态分析，兼容 CodeBuddy、Cursor、Windsurf、Claude Code、OpenClaw 等常见 Agent 环境。
核心功能¶
依据官方简介，已核实的能力包括：
- 安装或使用前扫描：针对目标 Skill 做安全向检查，而不是泛泛的 Agent 使用辅导或整机体检。
- 纯本地静态分析：分析在本机完成，官方明确说明不会把文件内容或凭据传出设备。
- 自然语言触发：在对话中用约定表述唤起扫描（见下文「典型用法」）；未列出的场景（例如一般开发调试、全系统健康检查）不在设计触发范围内。
SkillHub 上该 Skill 评分为 100000（平台展示规则以 SkillHub 为准），下载量以页面实时数据为准（资料中曾出现不同统计口径，写作时以 SkillHub 详情页 为准）。
安装与启用¶
Skill 遵循通用 SKILL.md 形态，需先进入当前 Agent 能识别的 skills 目录。SkillHub 推荐通过 CLI 安装，并强调 --dir 必须指向当前 Agent 的 skills 路径，否则默认落在 ./skills/，Agent 可能无法加载。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行（完整安装含默认 Skill；仅 CLI 可加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 skill-scanner 到对应 Agent 目录¶
将 @user_87fe1a85/gwchen17 安装到当前环境的 skills 目录。常见路径示例（以 SkillHub 安装文档 为准）：
| Agent / 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目内 .windsurf/skills/ |
| Codex | ~/.codex/skills/ 或项目内 .agents/skills/ |
安装命令形式如下（将 <skills 目录> 换成上表对应路径）：
skillhub install user_87fe1a85/gwchen17 --dir <skills 目录>
也可按 SkillHub 页面提示，让 Agent 根据 https://skillhub.cn/install/skillhub.md 安装 @user_87fe1a85/gwchen17。
安装后若 Agent 未立即识别新 Skill，按各客户端说明重启或刷新 skills 加载。
典型用法¶
skill-scanner 通过对话中的特定意图触发，官方列出的表述包括：
- 中文：「这个 skill 安全吗」「skill 安全扫描」「检查 skill 安全」
- 英文：audit skill、scan skill、check skill safety、analyze skill、inspect skill、verify skill、skill security、skill supply chain
使用步骤可以概括为：
- 按上一节将 skill-scanner 装入当前 Agent 的 skills 目录。
- 在对话中说明要检查的 Skill（本地路径、SkillHub 坐标或待审目录均可，以 Agent 实际能访问的范围为准）。
- 使用上述触发语之一，请求对目标 Skill 做安全扫描。
官方说明：不要指望它处理一般 Agent 使用问题、全系统健康检查、项目调试或日常开发任务；这些不在触发设计范围内。
适用场景与注意¶
适合谁
- 从 SkillHub 或第三方渠道拉取 Skill 前，希望多一道供应链与安全向把关的开发者。
- 在团队内推广「先扫再装」流程的维护者。
限制与注意
- 能力是 静态分析，无法替代运行态渗透测试或人工代码审计；高危场景仍应结合组织内安全规范。
- 扫描对象需在本机可读；Agent 无权访问的路径无法分析。
- 与「装完再用」相比，价值在于 安装前 发现明显风险，减少误装高权限或可疑依赖的 Skill。
结尾¶
skill-scanner 把 Zhuque Lab AI-Infra-Guard 的安全扫描能力封装成 Agent Skill：本地静态、不传凭据，用固定话术在安装或使用前审一眼目标 Skill。
