前言¶
從 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。
