跳至主要内容

Claude Code Skills 擴充指南

Claude Code 透過 Skills 機制賦予 CLI 工具執行複雜任務的能力,並引入了動態命令執行與子代理 (Subagent) 模式,將 AI 的自動化潛力推向極致。

1. 核心邏輯:任務導向的擴展

Claude Code 的 Skills 是基於 agentskills.io 標準,允許使用者將特定的指令、工作流程與自動化腳本封裝在一起。這使得 Claude 不僅能「理解」程式碼,更能「執行」複雜的工程任務。

2. 進階特性:動態上下文 (Dynamic Context)

Claude Code 允許在 Skill 中使用 !command 語法。這意味著在 Skill 指令傳送給 AI 之前,可以先在本地 Shell 執行命令並抓取最新資訊。

範例: 在指令中包含 !git log -n 5,可以讓 AI 始終掌握最新的提交歷史。

3. 執行模式:子代理隔離 (Fork Context)

對於複雜且具破壞性的任務,Claude Code 支援將 Skill 放在獨立的子代理 (Subagent) 中執行:

  • 隔離執行:在子代理中完成任務後,僅將結果回傳給主代理。
  • 防止干擾:子代理的冗長中間過程不會汙染主對話的上下文。

4. 技能目錄結構

Claude Code 優先尋找以下目錄:

  1. 專案目錄.claude/skills/ (推薦用於團隊共享)。
  2. 全域目錄~/.claude/skills/ (用於個人常用工具)。

5. 撰寫規範要點

  • 唯一性name 必須與資料夾名稱一致,這也是觸發的斜槓命令。
  • 明確性description 是 AI 自動選取技能的依據,應包含關鍵場景。
  • 安全性:包含腳本的 Skill 在執行前,Claude Code 會提示使用者確認,確保操作透明。