分享技能

分享技能

重點整理

• 專案技能位於 .claude/skills 中，會透過 Git 自動共享——任何複製該儲存庫的人都會取得這些技能
• 外掛程式讓您能透過市集在各儲存庫間分發技能，供更廣泛的社群使用
• 企業管理設定以最高優先順序在整個組織範圍內部署技能，非常適合強制性標準與合規要求
• 子代理不會自動看到您的技能——您必須在自訂代理的 frontmatter skills 欄位中明確列出技能
• 內建代理（Explorer、Plan、Verify）完全無法存取技能——只有在 .claude/agents 中定義的自訂子代理才可以

當技能被分享時，其價值會大幅提升。一個只有您自己使用的 PR 審查技能雖然有幫助，但若將同一個技能分享給整個團隊，就能使程式碼審查標準化，並在整個組織中創造一致的體驗。讓我們來看看分發技能的不同方式。

將技能提交到您的儲存庫

最簡單的分享方法是直接將技能提交到您的儲存庫。將它們放在 .claude/skills 中，任何複製該儲存庫的人都會自動取得這些技能——無需額外安裝。

當您推送更新時，每個人在下次拉取時都會取得更新。這種方法適用於：

• 團隊程式碼標準
• 專案特定的工作流程
• 參照您程式碼庫結構的技能

.claude 目錄包含您的代理、掛鉤（hooks）、技能與設定——全部都受版本控制，並透過一般的 Git 工作流程與團隊共享。

透過外掛程式分發技能

外掛程式是一種擴充 Claude Code 的方式，其自訂功能設計用於在團隊和專案間共享。在您的外掛程式專案中，建立一個 skills 目錄，其檔案結構與 .claude 目錄類似——每個技能都有自己的資料夾，內含一個 SKILL.md 檔案。

在您將外掛程式分發到市集後，其他使用者就能發現它，並自行將其安裝到 Claude Code 中。



當您的技能不會過於專案特定，且能對您直屬團隊以外的社群成員有所助益時，這種方法最為適合。

透過管理設定進行企業部署

管理員可以透過管理設定在整個組織範圍內部署技能。企業技能擁有最高優先順序——它們會覆寫同名的個人、專案和外掛程式技能。



管理設定檔支援諸如 strictKnownMarketplaces 之類的功能，用以控制外掛程式可從何處安裝：

"strictKnownMarketplaces": [
  {
    "source": "github",
    "repo": "acme-corp/approved-plugins"
  },
  {
    "source": "npm",
    "package": "@acme-corp/compliance-plugins"
  }
]

對於必須在整個組織中保持一致的強制性標準、安全要求、合規工作流程和程式碼撰寫規範而言，這是正確的選擇。這裡的關鍵字是「必須」。

技能與子代理

有件事會讓人感到意外：子代理不會自動看到您的技能。當您將任務委派給子代理時，它會以全新、乾淨的上下文開始。

這裡有一些重要的區別需要理解：

• 內建代理（如 Explorer、Plan 和 Verify）完全無法存取技能
• 您定義的自訂子代理可以使用技能，但僅限於您明確列出它們時
• 技能是在子代理啟動時載入的，而不是像主對話中那樣按需載入

若要建立具有技能的自訂子代理，請在 .claude/agents 中新增一個代理 markdown 檔案。您可以在 Claude Code 中使用 /agents 指令以互動方式建立一個：



產生的代理檔案包含一個 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. 後端審查者）
• 您想在委派的工作中強制執行標準，而不依賴提示

課程反思

• 對於您一直在考慮建立的技能，哪種分享方法（儲存庫、外掛程式、企業）最合理？
• 您是否有一些工作流程，其中具備特定技能的自訂子代理能提升委派工作的一致性？

接下來

在最後一堂課中，您將學習如何排解常見的技能問題——從無法觸發的技能、優先順序衝突，到執行階段錯誤——並附有一份可隨時參考的實用檢查清單。