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

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

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

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

一、什么是Skills

1.官方的解釋

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

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

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

2. 我理解的Skill

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

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

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

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

二、編寫(xiě)一個(gè)Skills

接下來(lái)我們就學(xué)著編寫(xiě)一個(gè)Skills，先說(shuō)它的存放位置。

1. Skills的存放位置

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

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

通過(guò)這個(gè)表，可以看出，其實(shí)Skills就是一個(gè)SKILL.md文件。下面就以項(xiàng)目級(jí)

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

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

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

2. 編寫(xiě)Skills文件

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

路徑為：.項(xiàng)目根目錄/.claude/skills/hello-jspang/SKILL.md

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

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

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

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

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

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

/hello-jspang

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

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

最新評(píng)論