在人工智能輔助編程的時代，如何讓 AI 助手更好地理解你的需求、遵循你的規(guī)范、執(zhí)行特定任務(wù)，是提升開發(fā)效率的關(guān)鍵。Claude Code 的 Skills 系統(tǒng)正是為解決這一問題而生。

Skills 并非傳統(tǒng)意義上的"插件"或"擴展"，而是一種按需加載的認知結(jié)構(gòu)。它將領(lǐng)域知識、執(zhí)行步驟、輸出規(guī)范與約束條件封裝成獨立的能力單元，在需要時被語義觸發(fā)，漸進式加載到主 Agent 的認知空間中。這種設(shè)計既保持了主 Agent 的簡潔性，又實現(xiàn)了能力的無限擴展。

本文將從 Skills 的基本概念入手，深入解析其觸發(fā)機制與存放位置，并通過實際案例演示如何編寫一個完整的 Skills 文件。你將了解到 Skills 的兩大類型——參考型（提供知識規(guī)范）與任務(wù)型（執(zhí)行具體操作），以及它們在 YAML 前綴、觸發(fā)方式和應(yīng)用場景上的核心差異。

無論你是希望統(tǒng)一團隊代碼風(fēng)格，還是想要自動化重復(fù)性工作流程，掌握 Skills 的編寫方法都將為你的開發(fā)體驗帶來質(zhì)的提升。

一、什么是Skills

1.官方的解釋

Skill是一個技能，是一個包含一下內(nèi)容的文件夾：
- SKILL.md（必需）：使用Markdown格式說明，帶有YMAL前文
- scripts/ （可選）：可執(zhí)行代碼（Python，Bash等）
- references/ ( 可選)： 按需加載的文檔
- assets/ (可選) ： 輸出中使用的模版、字體、圖標(biāo)

.claude/skills/<skill-name>/
    SKILL.md
    templates/     (可選)
    references/    (可選)
    scripts/       (可選)
    assets/        (可選)

可以看到，一個Skill就是一個文件夾，或者叫做路徑。

2. 我理解的Skill

Skills是一種可被語義觸發(fā)的能力包，它包含領(lǐng)域知識、執(zhí)行步驟、輸出規(guī)范與約束條件，并在需要時漸進式加載到主Agent的認知空間中。

Skills并不是簡單的"能力擴展機制"（或者叫做插件），它本質(zhì)上是一種按需加載的認知結(jié)構(gòu)。可能你還是不太好理解，我這里做個簡單的比喻，來幫助你理解： Skills = 你手機里的App應(yīng)用。

• 主Agent = 你的手機
• Skills = 手機里的應(yīng)用（App）
• 語音觸發(fā) = 用手點看了App

當(dāng)明白了什么是Skills, 可以更具像一點，在Claude Code 里的Skills是一markdown文檔。

二、編寫一個Skills

接下來我們就學(xué)著編寫一個Skills，先說它的存放位置。

1. Skills的存放位置

新建一個Skills我們首先要確定它的存放位置，位置不同，它的適用范圍也不同。也就是**位置決定了誰能使用它，以及優(yōu)先級順序。

同名優(yōu)先級：Enterprise > Personal > Project。Plugin Skills 使用  plugin-name:skill-name  命名空間，不與其他級別沖突。

通過這個表，可以看出，其實Skills就是一個SKILL.md文件。下面就以項目級

2. 兩大類型的Skills：參考型和任務(wù)型

從工程角度，Skill 內(nèi)容分為兩類，參考型和任務(wù)型。參考型 Skill 影響“怎么做”，任務(wù)型 Skill 決定“做什么”。前者是語義環(huán)境，后者是具體行動。

這有點向古代的文官和武將，這兩種類型的Skills定義的方法也稍有不同。下面我們就來試著編寫一個任務(wù)型Skill并使用它。

2. 編寫Skills文件

編寫一個項目的Skills，這個是任務(wù)型的，編寫這個的主要目的是讓大家了解，如何來編寫Skill，已經(jīng)如何執(zhí)行，其實這個Skill沒有任何用處，類似些程序時候的Hello World 。

路徑為：.項目根目錄/.claude/skills/hello-jspang/SKILL.md

這個Skill就是一個參考型的skill，用于規(guī)定軟件的“API設(shè)計規(guī)范”。

.claude/skills/hello-jspang/     # skill 目錄，名稱即 skill 名
└── SKILL.md                        # 主文件（必需）
---
name: hello-jspang
description: 創(chuàng)建/更新HELLO_JSPang.md,用于驗證skill能跑通閉環(huán).
trigger: manual ?
---
## Instructions
1. 在項目根目錄創(chuàng)建或更新 `HELLO_JSPang.MD`。
2. 內(nèi)容必須包含三行：
? ?- `# hello skill`
? ?- `生成了 Hello_JSPang`
? ?- `Time: <當(dāng)前時間>`
3. 最后用不超過3行告訴我你完成了什么。

注意這個 Skill 的關(guān)鍵特征——它是一個典型的任務(wù)型 Skill**。

1. 有執(zhí)行步驟： 需要一個完成的執(zhí)行過程，這里的1、2、3步驟就是。
2. 有輸出模板： 需要個給它一個固定的輸出格式。
3. trigger: manual ： 必須使用/xxxx來調(diào)用skill。

一個Skill的編寫，description 是靈魂，因為它不是給人看的文檔，而是給Claude 看的觸發(fā)器。Cluade選擇是否激活一個Skill，完全依賴于閱讀description。它不是單純的拼配關(guān)鍵詞，而是語義理解。（雖然我這里使用了中文，但是建議英文好的使用英文）

如何調(diào)用？在控制臺直接輸出

/hello-jspang

Claude就會開始調(diào)用這個Skill，開始執(zhí)行你設(shè)置好的技能，創(chuàng)建文件，寫入內(nèi)容，通知結(jié)果。

到此這篇關(guān)于Claude Code 中的Skill基礎(chǔ)和創(chuàng)建過程的文章就介紹到這了,更多相關(guān)Claude Code Skill創(chuàng)建內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論