前言¶
在 Cursor、Claude Code、OpenClaw 等環境裏，能力往往以 Skill（SKILL.md）形式掛在本地目錄。技能越積越多，問題就變成：用戶說「我想做海報」「有沒有能分析大盤的工具」，Agent 該去哪個目錄、哪個市場找對應能力？手工翻目錄或逐個記 slug 都不現實。下面介紹的 Find Skills（座標 @indiv-guipi/find-skills）面向「找技能 + 裝技能」這一類對話，把場景理解、多源搜索和安裝步驟寫進 Skill 本身，讓 Agent 按文檔執行。
這是什麼¶
Find Skills 是發佈在 SkillHub 上的智能體技能，版本 1.0.0，上游來自 ClawHub（guipi888/find-skills），分類爲 ai-agent，標籤標明 requires_api_key=false（本身不依賴額外 API Key）。SkillHub 頁面上的簡介是：當用戶詢問「如何做 X」「找 X 的技能」「有能做……的嗎」等問題時，幫助發現並安裝合適的智能體技能。
維護與分發渠道包括：
- SkillHub：
https://www.skillhub.cn/skills/indiv-guipi/find-skills - 官方 API 頁：
https://api.skillhub.cn/org-xyyuvez5/find-skills - 上游說明與完整流程：ClawHub
https://clawhub.ai/guipi888/find-skills
核心功能¶
以下能力均來自上述官方頁面與上游文檔，按執行順序概括。
場景與關鍵詞雙模式觸發¶
用戶可以用自然語言描述需求（例如「我想做一個海報」），也可以說「安裝技能」「find skills」「找個 skill」。Skill 會從表述裏抽取任務意圖、領域和中英文檢索詞，再進入搜索流程。
多層聯合搜索¶
上游文檔將搜索範圍分爲多層（合併去重後排序推薦）：
- 官方內置技能：掃描 WorkBuddy 內置技能目錄，讀取各技能
SKILL.md的 YAML frontmatter，做語義匹配。 - 本地已安裝技能：掃描用戶級目錄（如
~/.workbuddy/skills/）與項目級.workbuddy/skills/。 - 遠程市場：優先查本地 marketplace 緩存；若無匹配，再按順序檢索 SkillHub API、蝦評市場、GitHub（含
SKILL.md的倉庫/代碼搜索），必要時回退到npx skills find與npx clawhub search。
遠程 SkillHub 搜索示例（文檔中的接口形態）：
curl -s "https://lightmake.site/api/v1/search?q=<URL-encoded 中文關鍵詞>&limit=10"
curl -s "https://lightmake.site/api/v1/search?q=<URL-encoded English keywords>&limit=10"
低相關結果會按文檔規則過濾（例如 score < 0.05 的結果丟棄）。
排序、說明與一鍵安裝¶
合併結果後按「內置 → 已安裝 → 各遠程源」的優先級排序，輸出技能名、一句話說明、匹配理由、來源與安裝提示。用戶確認安裝遠程技能時，文檔要求先做客戶端檢測（通過 __CFBundleIdentifier 區分 CodeBuddy 與默認 WorkBuddy），再寫入對應 skills 目錄；支持從 marketplace 緩存複製、SkillHub/蝦評/ClawHub 下載解壓、GitHub 拉取以及 Vercel Skills CLI 等路徑（詳見上游各 Step 5 小節）。
安裝與啓用¶
在 SkillHub 生態中安裝¶
SkillHub 頁面給出的方式是：讓 Agent 閱讀安裝說明並安裝座標 @indiv-guipi/find-skills：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@indiv-guipi/find-skills`。
若本機已有 skillhub CLI，應按當前 Agent 的 skills 目錄安裝（文檔強調必須使用 --dir，否則默認 ./skills/ 可能不會被識別）：
command -v skillhub && skillhub --version
skillhub install find-skills --dir <你的 Agent skills 目錄>
常用目錄（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/ - WorkBuddy：
~/.workbuddy/skills/
CLI 未安裝時，可按 SkillHub 文檔執行官方安裝腳本（完整安裝或 --cli-only）。
在 OpenClaw / ClawHub 側安裝¶
ClawHub 頁面提供的命令爲：
openclaw skills install @guipi888/find-skills
與 SkillHub 座標不同（@indiv-guipi/find-skills vs @guipi888/find-skills），對應同一上游技能在不同商店中的發佈名，安裝時以你當前使用的客戶端文檔爲準。
典型用法¶
對話觸發¶
| 用戶表達 | 行爲 |
|---|---|
| 「我想做 XXX」 | 場景理解後進入多層搜索 |
| 「幫我找 XXX 的技能」 | 直接搜索 |
| 「有沒有能 XXX 的工具」 | 搜索並推薦 |
| 「這個場景應該用哪個技能」 | 匹配已安裝與遠程候選 |
輸出形態（文檔示例）¶
搜索完成後，助手按模板列出「官方·內置」「本地·已安裝」「遠程·可安裝」等分區，並註明是否需安裝、路徑或安裝命令。用戶可說「安裝第 N 個」進入 Step 5 的安裝分支。
上游文檔中的海報場景示例（節選邏輯）：先在本地已安裝技能中命中圖片生成類能力並可直接使用；同時在 SkillHub、ClawHub 列出可安裝的專向技能，由用戶選擇是否安裝。
適用場景與注意¶
適合誰
- 經常在對話裏臨時擴展能力、又不想手動維護一長串技能 slug 的開發者。
- 使用 WorkBuddy / CodeBuddy 或 OpenClaw 系客戶端、希望統一從內置、本地與多箇中文/英文市場找技能的用戶。
限制與注意
- 環境綁定：內置掃描路徑、marketplace 緩存、
__CFBundleIdentifier檢測等寫法面向 WorkBuddy/CodeBuddy 文檔；在純 Cursor 環境下，更現實的路徑是 SkillHub CLI 安裝本 Skill，並依賴其遠程搜索與 Cursor 的~/.cursor/skills/目錄，內置層可能無對應目錄。 - 網絡與認證：遠程搜索依賴各市場 API；GitHub 代碼搜索在文檔中說明需要
GITHUB_TOKEN時配額更高；蝦評安裝流程文檔要求先具備「蝦評指南」技能並按其認證步驟操作。 - 與官方舊插件的關係：上游文檔寫明其意圖覆蓋並替代原
find-skills插件的觸發範圍；若你同時存在多個發現類 Skill，注意 description 與觸發詞是否衝突。 - 數據以頁面爲準：SkillHub API 頁記錄的本技能評分爲 100000，下載 1318334，安裝 75956（抓取時點）；商店數字會變動，引用時以安裝時頁面爲準。
結尾¶
Find Skills 把「用戶怎麼說」映射到「去哪搜、裝到哪、先推薦哪一個」，適合作爲智能體棧裏的技能發現入口。安裝與行爲細節以 SkillHub 與 ClawHub 官方頁爲準：
- https://www.skillhub.cn/skills/indiv-guipi/find-skills
- https://api.skillhub.cn/org-xyyuvez5/find-skills
- https://clawhub.ai/guipi888/find-skills
