技能偵察員 是做什麼的?
在建立新技能之前使用此技能。目標是避免重複現有社群或市集的工作,同時在採用任何外部技能前先進行審查。
來源:由 redminwang 從社群 PR #1232 中搶救回來。
使用時機
- 使用者說「建立技能」、「構建技能」、「製作技能」或「新技能」。
- 使用者問「有沒有技能可以做 X?」或「是否存在能做 Y 的技能?」。
- 使用者描述一個工作流程,而你正打算建議建立一個新技能。
- 使用者想要分叉或擴充現有技能。
如果使用者明確表示要跳過搜尋或從頭建立,請確認並繼續執行要求的建立流程。
運作方式
步驟 1 - 捕捉意圖
提取:
- 技能應執行的任務。
- 使用技能的觸發條件。
- 涉及的領域、工具、框架或資料來源。
- 三到五個搜尋關鍵字以及可用的同義詞。
步驟 2 - 搜尋本地來源
首先搜尋已安裝和市集的技能名稱。本地來源的優先級較高,因為它們已經是使用者環境的一部分。
find ~/.claude/skills -maxdepth 2 -name SKILL.md 2>/dev/null | grep -iE "keyword|synonym"
find ~/.claude/plugins/marketplaces -path '*/skills/*/SKILL.md' 2>/dev/null | grep -iE "keyword|synonym"
然後搜尋 frontmatter 說明:
grep -RilE "keyword|synonym" ~/.claude/skills ~/.claude/plugins/marketplaces 2>/dev/null
步驟 3 - 搜尋遠端來源
使用可用的 GitHub 和網路搜尋工具。偏好簡潔的查詢:
gh search repos "claude code skill keyword" --limit 10 --sort stars
gh search code "name: keyword" --filename SKILL.md --limit 10
對於網路搜尋,最多使用三個針對性查詢,例如:
"claude code skill" keyword
"SKILL.md" keyword
"everything-claude-code" keyword
步驟 4 - 審查外部匹配
在推薦任何外部技能供採用或分叉之前:
- 閱讀
SKILL.md的 frontmatter 和說明。 - 檢查是否有未預期的 Shell 指令、檔案寫入、網路呼叫、憑證處理或套件安裝。
- 檢查儲存庫是否維護中。
- 偏好複製到全新的本地分支並檢視 diff,而不是直接編輯市集原始內容。
步驟 5 - 排名結果
依以下條件為候選項目排名:
- 技能名稱中的精確關鍵字匹配。
- 說明中的關鍵字或同義詞匹配。
- 本地已安裝或市集來源。
- 有近期活動的 GitHub 維護來源。
- 僅網路提及。
最終列表最多 10 個結果。
步驟 6 - 呈現決策選項
為使用者提供一個簡短表格:
| 選項 | 含義 |
|---|---|
| 使用現有 | 直接叫用或安裝匹配的技能。 |
| 分叉或擴充 | 複製最接近的技能並修改。 |
| 新建 | 在確認無接近匹配後建立新技能。 |
僅在使用者選擇該路徑或搜尋未找到接近匹配後,才建立新技能。
範例
結果表格
| # | 技能 | 來源 | 匹配原因 | 差距 |
| --- | --- | --- | --- | --- |
| 1 | article-writing | 本地 ECC | 撰寫文章和指南 | 不專注於發行說明 |
| 2 | content-engine | 本地 ECC | 多格式內容工作流程 | 比所需更重 |
| 3 | blog-writer | GitHub | 部落格寫作技能,有近期提交 | 需安全審查 |
面向使用者的摘要
我找到兩個接近的本地匹配和一個外部候選項目。最接近的是 `article-writing`;它涵蓋草稿和修訂,但不包含您要求的發行說明檢查清單。我可以原樣使用它、將其分叉為發行說明變體,或建立一個新技能。
反模式
- 不應在可以合理搜尋時直接跳轉到新技能建立。
- 不應未經閱讀就安裝外部技能。
- 不應呈現一長串未排序的弱匹配結果。
- 不應將僅網路提及視為可信來源。
- 不應就地編輯已安裝的市集原始內容。
相關
search-first- 通用「先搜尋再建立」工作流程。skill-stocktake- 審計已安裝技能的健康狀態、重複項和缺口。agent-sort- 分類並整理現有的代理和技能。