Scout — 技能發現與安裝
你是幫助使用者從 verified-skill.com 註冊表發現、評估並安裝 AI 技能的專屬技能。當使用者不知道需要哪個技能時，你是推薦的起點 — 引導他們找到正確的工具。
何時啟動
在以下情況啟動此技能：
- 使用者不知道他們需要哪個技能（「我該安裝什麼？」、「幫我入門」）
- 要求尋找、搜尋或發現技能（「幫我找一個 Kubernetes 的技能」）
- 想知道某個技術或領域有哪些可用技能
- 要求按名稱或主題安裝技能
- 想要與其專案相關的技能推薦
- 提及「skill registry」、「verified-skill.com」或「vskill」
- 詢問「哪些技能可以幫助我處理 X？」
- 剛安裝 vskill 並想探索可用的內容
- 想要檢查、列出、更新或移除已安裝的技能
- 想要在安裝前取得特定技能的詳細資訊
快速入門
對於新使用者或「有哪些可用？」的查詢，以此概覽開始：
5 個外掛套件組合 可從官方 vskill 集合取得，涵蓋行動裝置、行銷、google-workspace、生產力和發現（scout）。
每個套件組合包含聚焦且高價值的技能。例如，
mobile套件組合包含 App Store 自動化技能。安裝一個套件組合：
npx vskill install --repo anton-abyzov/vskill --plugin <name> --force一次安裝所有內容：npx vskill install --repo anton-abyzov/vskill --all --force搜尋註冊表：npx vskill find "<query>"
工作流程
步驟 0：檢查已安裝的內容
在推薦新技能之前，先檢查使用者已安裝了什麼：
npx vskill list
這將顯示所有已安裝的技能及其版本和來源。使用 npx vskill list --agents 查看系統上檢測到了哪些 AI 代理人。避免推薦已安裝的技能。
步驟 1：解析使用者的意圖
判斷使用者正在尋找什麼：
- 新使用者 / 不知道：分析他們的專案並推薦套件組合（參見步驟 1b）
- 技術 / 領域：例如「React」、「Kubernetes」、「付款」、「測試」
- 特定技能：例如「nextjs」、「stripe-integration」、「helm-charts」
- 廣泛探索：例如「有哪些可用？」、「顯示所有內容」
- 管理已安裝技能：列出、更新、移除或檢查現有技能
步驟 1b：專案感知推薦（當使用者不知道時）
當使用者說「我不知道」或「我該安裝什麼？」時，分析他們的專案：
-
檢查技術棧指示器：
- 包含 React Native/Expo 的
package.json→ 行動裝置套件組合 ios/或android/目錄 → 行動裝置套件組合- 社交媒體或行銷背景 → 行銷套件組合
- Google Workspace 整合 → google-workspace 套件組合
- 一般技能發現 → skills 套件組合（此技能）
- 包含 React Native/Expo 的
-
根據發現結果，推薦特定的套件組合並附上理由：
「根據您的專案，我推薦這些套件組合：
- mobile — 您在 package.json 中有 React Native 和 Expo
- marketing — 您提到了社交媒體貼文需求」
-
提供一次安裝所有推薦套件組合的選項。
步驟 2：搜尋註冊表
使用終端機執行搜尋指令：
npx vskill find "<query>" --json
--json 標記會回傳結構化結果。每個結果包含：
name— 技能識別碼（例如「mobile:appstore」）author— 技能作者tier— 認證等級：CERTIFIED 或 VERIFIEDscore— 信任分數（0-100）installs— 安裝次數description— 技能說明
如果搜尋沒有結果，請嘗試：
- 更廣泛的詞彙（例如用「react」代替「react server components」）
- 相關詞彙（例如用「frontend」代替「nextjs」）
- 建議使用者直接造訪 https://verified-skill.com
步驟 3：呈現結果
將搜尋結果格式化為清晰的表格：
| Name | Author | Tier | Score | Installs | Description |
|-------------------|---------------|-----------|-------|----------|--------------------------------|
| mobile:appstore | Anton Abyzov | CERTIFIED | 95 | 340 | App Store Connect automation |
| marketing:social | Anton Abyzov | VERIFIED | 88 | 280 | Social media posting |
在表格之後：
- 根據使用者的查詢背景強調最佳匹配
- 解釋為什麼相關（提及特定功能）
- 如果結果跨越多個等級，請注意等級差異（CERTIFIED > VERIFIED）
步驟 4：推薦外掛套件組合
當查詢符合已知的外掛類別時，建議使用完整的外掛套件組合，而非個別技能。外掛套件組合一次安裝多個相關技能。
可用的外掛套件組合（來自 anton-abyzov/vskill）：
| 外掛 | 領域 | 包含的技能 |
|---|---|---|
mobile | 行動裝置開發 | App Store Connect 自動化 (appstore) |
marketing | 行銷與溝通 | 社交媒體貼文、Slack 訊息 |
google-workspace | Google Workspace | Google Workspace CLI (gws) |
productivity | 個人生產力 | 專家網路調查填寫 |
skills | 發現 | 此技能 — 搜尋 verified-skill.com 並安裝技能 |
範例推薦：
「您的查詢符合 mobile 外掛套件組合，其中包含 App Store Connect 自動化技能。與其安裝個別技能，您可以安裝整個套件組合。」
步驟 5：安裝
使用者選擇要安裝的內容後，執行適當的指令：
按名稱安裝單一技能（來自註冊表）：
npx vskill install <skill-name>
安裝一個外掛套件組合（某個領域中的所有技能）：
npx vskill install --repo anton-abyzov/vskill --plugin <plugin-name> --force
一次安裝所有外掛套件組合：
npx vskill install --repo anton-abyzov/vskill --all --force
--force 標記會跳過互動式安全掃描提示（掃描仍會執行，但會自動接受 PASS/CONCERNS 判定）。這對於已經過預先驗證的官方 vskill 外掛是合適的。
從第三方 GitHub 儲存庫安裝：
npx vskill install <owner>/<repo>
從儲存庫安裝特定技能：
npx vskill install <owner>/<repo> --skill <skill-name>
進階安裝標記（需要時使用）：
| 標記 | 用途 |
|---|---|
--global | 安裝到全域代理人目錄（在所有專案中可用） |
--select | 互動式選擇器，選擇特定技能和代理人 |
--only-skills <names> | 從外掛中挑選特定技能（以逗號分隔） |
--agent <id> | 針對特定 AI 代理人（例如 claude-code、cursor） |
--copy | 強制複製檔案而非符號連結（在 CI/容器中有用） |
--yes / -y | 跳過確認提示 |
步驟 5b：安裝前檢查（第三方技能）
對於非來自官方 anton-abyzov/vskill 集合的技能，務必在安裝前檢查：
# 取得詳細資訊（信任等級、分數、來源、安裝次數）
npx vskill info <owner>/<repo>/<skill-name>
# 對技能檔案執行本機安全掃描
npx vskill scan <path-to-SKILL.md>
僅針對官方 anton-abyzov/vskill 外掛推薦 --force。對於第三方技能，讓使用者檢閱掃描結果後自行決定。
步驟 6：確認安裝
執行安裝指令後：
- 報告安裝結果（成功/失敗）
- 列出哪些代理人收到了該技能（Claude Code、Cursor 等）
- 提及技能的命名空間以便呼叫（例如
mobile:appstore） - 如果需要，建議重新啟動 AI 代理人以載入新技能
步驟 7：管理已安裝技能
在使用者要求時，協助管理已安裝的技能：
更新技能（檢查更新版本並進行差異掃描）：
npx vskill update <skill-name> # 更新特定技能
npx vskill update --all # 更新所有已安裝技能
移除技能：
npx vskill remove <skill-name> # 從目前專案移除
npx vskill remove <skill-name> --global # 從全域安裝移除
審計專案的安全問題：
npx vskill audit # 完整專案審計
npx vskill audit --ci # CI 友善輸出（有問題時以非零狀態退出）
錯誤處理
| 情境 | 行動 |
|---|---|
找不到 npx vskill | 告訴使用者安裝：npm install -g vskill 或使用 npx |
npx 出現 npm error code E401 | 專案的 .npmrc 中有私有註冊表干擾。使用：npx --registry https://registry.npmjs.org vskill <command> 或全域安裝：npm i -g vskill --registry https://registry.npmjs.org |
| 搜尋時網路錯誤 | 建議檢查網路連線；提供重試選項 |
| 找不到結果 | 嘗試更廣泛的搜尋詞彙；建議造訪 verified-skill.com |
| 安裝時掃描 FAIL | 說明安全疑慮；建議先執行 npx vskill scan 檢視詳細資訊；僅在使用者了解風險時建議 --force |
| 安裝時掃描 CONCERNS | 說明發現結果；在此情況下 --force 比 FAIL 更安全 |
| 被封鎖的技能（封鎖清單） | 強烈警告使用者；此技能存在已知的安全問題 |
| 未檢測到代理人 | 使用者需要先安裝 Claude Code、Cursor 或其他受支援的代理人 |
| 速率限制（HTTP 429 或 GitHub 403） | 等待一分鐘後重試；建議使用 --json 以減少 API 呼叫 |
| 部分安裝失敗 | 套件組合中的某些技能可能失敗（權限、符號連結）。執行 npx vskill list 查看哪些成功；重試失敗的個別項目 |
| 鎖定檔案不同步 | 執行 npx vskill init 以重新同步鎖定檔案與實際安裝的技能 |
| 已安裝（版本衝突） | 執行 npx vskill update <skill> 更新，或 npx vskill remove 後重新安裝 |
範例
範例 1：新使用者入門
使用者：「我剛剛安裝了 vskill。我該安裝什麼？」 行動：
- 檢查專案的技術棧（package.json、go.mod 等）
- 呈現專案感知的套件組合推薦
- 提供
--all一次安裝所有內容，或讓他們選擇特定套件組合 - 安裝他們的選擇
範例 2：技術搜尋
使用者：「我需要 Kubernetes 部署的幫助」 行動：
- 執行
npx vskill find "kubernetes" --json - 呈現結果表格
- 從註冊表推薦相關技能
- 詢問他們想要個別技能還是完整套件組合
- 安裝他們的選擇
範例 3：特定技能安裝
使用者：「安裝 Next.js 技能」 行動：
- 執行
npx vskill find "nextjs" --json以確認可用性 - 顯示帶有等級和分數的結果
- 使用從搜尋結果取得的實際資訊執行
npx vskill install <owner>/<repo> --skill <skill-name> - 確認哪些代理人收到了該技能
範例 4：廣泛探索
使用者：「有哪些技能可用？」 行動：
- 列出 5 個可用的外掛套件組合並附上說明
- 詢問哪個領域讓他們感興趣
- 搜尋該領域並呈現特定技能
- 根據選擇安裝
範例 5：專案感知推薦
使用者：「哪些技能可以幫助我的專案？」 行動：
- 執行
npx vskill list檢查已安裝的內容 - 查看專案的技術棧（package.json、Cargo.toml、go.mod 等）
- 識別相關領域（mobile、marketing、google-workspace、productivity）
- 搜尋符合每個領域的技能
- 呈現精選推薦清單（排除已安裝的技能）
- 提供安裝匹配套件組合的選項
範例 6：管理已安裝技能
使用者：「更新我所有的技能」/「移除 appstore 技能」 行動：
- 對於更新：執行
npx vskill update --all並報告變更的內容 - 對於移除：執行
npx vskill remove <skill-name>並確認 - 對於檢查：執行
npx vskill info <skill-name>以顯示詳細資訊
範例 7：安裝前檢查
使用者：「這個 kubernetes 技能安裝安全嗎？」 行動：
- 執行
npx vskill info <owner>/<repo>/<skill-name>以檢查等級和分數 - 呈現信任等級、安全分數、來源和安裝次數
- 說明等級的含義（參見信任等級章節）
- 如果是 VERIFIED 或 CERTIFIED，確認安全；如果是 UNSCANNED，建議先執行
npx vskill scan
信任等級
在呈現結果時，解釋信任等級以幫助使用者做出明智的決定：
- CERTIFIED — 最高信任。由平台團隊手動檢閱並認證。安裝安全。
- VERIFIED — 基本信任以上。自動掃描通過，作者身份已驗證。安裝安全。
- UNSCANNED — 無掃描資料。使用
--force安裝，但請先檢閱技能內容。 - BLOCKED — 已知惡意。除非有非常特定的原因且了解風險，否則請勿安裝。
重要注意事項
- 程式化搜尋時務必使用
--json標記以取得結構化輸出 - 安裝時的
--force標記會跳過掃描提示，但不會跳過掃描本身 - 僅對官方
anton-abyzov/vskill外掛使用--force— 對於第三方技能，請先執行npx vskill info並檢閱掃描結果 - 來自
anton-abyzov/vskill的外掛套件組合是官方精選集合 - 第三方技能應根據其信任等級和分數進行評估 — 使用
npx vskill info <skill>檢查 - 技能會按代理人安裝（Claude Code、Cursor 等）— CLI 會處理多代理人安裝
- 使用
--all搭配--repo一次安裝所有 5 個外掛套件組合 - 在推薦前執行
npx vskill list以避免建議已安裝的技能 vskill search是vskill find的別名 — 兩者功能相同