分享技能
分享技能 · 4 min
當技能在團隊或組織內共享時,會變得更有價值。本影片涵蓋三種主要的分發方法—— 儲存庫提交、外掛程式,以及企業受管理設定——並說明 如何設定自訂子代理以使用技能。您將學習哪種 方法適合哪種情境,以及如何處理一個重要的陷阱: 子代理不會自動繼承技能。
重點整理
- 專案技能位於
.claude/skills中,會透過 Git 自動共享——任何複製該儲存庫的人都能取得這些技能 - 外掛程式讓您能透過市集,在不同儲存庫間分發技能,供更廣泛的社群使用
- 企業受管理設定以最高優先權在整個組織內部署技能,非常適合強制性標準與合規性需求
- 子代理無法看到您已經呼叫過的技能。如果它們擁有 Skill 工具,仍然可以尋找並呼叫技能
- 內建代理(如 Explore 和 Plan)不會預先載入技能。只有自訂子代理可以在其
skills欄位中列出啟動時要載入的技能
技能在被分享時會變得更有價值。一個只有您自己使用的 PR 審查技能固然有幫助,但同一個技能若在整個團隊內共享,就能標準化程式碼審查,並在整個組織內創造一致的體驗。讓我們來看看分發技能的不同方式。
將技能提交到您的儲存庫
最簡單的分享方法,是將技能直接提交到您的儲存庫。將它們放在 .claude/skills 中,任何複製該儲存庫的人都會自動取得這些技能——不需要額外安裝。
當您推送更新時,每個人在下次提取(pull)時都會取得它們。這種方法適用於以下情境:
- 團隊編碼標準
- 專案特定的工作流程
- 參照您程式碼庫結構的技能
.claude 目錄包含您的代理、掛鉤(hooks)、技能與設定——全部都受版本控制,並透過一般的 Git 工作流程與團隊共享。
透過外掛程式分發技能
外掛程式是一種擴充 Claude Code 的方式,其自訂功能設計為可在團隊與專案間共享。在您的外掛程式專案中,建立一個 skills 目錄,其檔案結構與 .claude 目錄類似——每個技能都有自己的資料夾,裡面有一個 SKILL.md 檔案。
將外掛程式分發到市集之後,其他使用者便可以發現它,並自行安裝到 Claude Code 中。

當您的技能不會過於特定於某個專案、並且能對超出您直接團隊範圍的社群成員有用時,這種方法最為合適。
透過受管理設定進行企業部署
管理員可以透過受管理設定在整個組織內部署技能。每個技能會放在受管理設定目錄內的 .claude/skills/ 中,位於每台機器上,例如在 Linux 上是 /etc/claude-code/.claude/skills/。企業技能擁有最高優先權:它們會覆蓋同名的個人與專案技能。

受管理設定同時也控制外掛程式。舉例來說,strictKnownMarketplaces 限制了使用者可以新增與安裝外掛程式的市集來源。上方截圖中包含一個 npm 項目,但它不符合任何規則,因此本範例改用 url 項目:
"strictKnownMarketplaces": [
{
"source": "github",
"repo": "acme-corp/approved-plugins"
},
{
"source": "url",
"url": "https://plugins.example.com/marketplace.json"
}
]企業部署是強制性標準、安全需求、合規工作流程,以及那些在整個組織內「必須」保持一致的編碼實務的正確選擇。這裡的關鍵字是「必須」。
技能與子代理
有件事會讓人感到意外:子代理看不到您已經呼叫過的技能。當您將任務委派給子代理時,它會以全新、乾淨的上下文開始,除非它是一個分支(fork)(在新分頁中開啟),這種情況下會以您對話的副本開始。一個從頭開始的子代理,仍然可以透過 Skill 工具尋找並呼叫技能,只要它擁有該工具即可。
這裡有一些重要的區別需要理解:
- 內建代理(如 Explore 和 Plan)不會預先載入技能
- 您定義的自訂子代理可以預先載入您在其
skills欄位中列出的技能。如果您為它指定了tools清單,請在其中保留Skill,這樣子代理仍然可以呼叫未列出的技能 - 預先載入的技能是在子代理啟動時就完整載入的,而不像主對話中那樣按需載入
若要建立具有技能的自訂子代理,請在 .claude/agents 中新增一個代理 markdown 檔案。您可以自己撰寫該檔案,或請 Claude 為您建立。如果 .claude/agents 在您的工作階段開始時並不存在,請重新啟動 Claude Code 以載入新的子代理。下方截圖顯示的是 /agents 精靈,該功能已在 Claude Code v2.1.198 中移除。

代理檔案的 skills 欄位列出了要載入哪些技能。以下是 frontmatter 的樣子:
---
name: frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend code for accessibility..."
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill...
model: sonnet
color: blue
skills: accessibility-audit, performance-check
---當您委派任務給這個子代理時,它會同時載入兩個技能,並將它們套用到每次審查中。請先確認這些技能存在於您的 .claude/skills 目錄中,然後建立一個新的子代理,或將 skills 欄位新增到現有代理的 markdown 檔案中。
這種模式在以下情況下效果非常好:
- 您想要進行具備特定專業知識的獨立任務委派
- 不同的子代理需要不同的技能(前端審查者 vs. 後端審查者)
- 您想要在委派的工作中強制執行標準,而不依賴提示
課程反思
- 對於您一直在考慮建置的技能,哪種分享方法(儲存庫、外掛程式、企業)最為合適?
- 您是否有一些工作流程,在其中擁有特定技能的自訂子代理能改善委派工作的一致性?
接下來
在最後一堂課中,您將學習如何排查常見的技能問題——從無法觸發的技能,到優先權衝突,再到執行階段錯誤——並提供一份實用的檢查清單,供您隨時參考。