前言

用 Claude Code 久了就會(huì)發(fā)現(xiàn)一件事：很多話你在反復(fù)說。

寫 PR 描述要固定格式，做代碼審查要先看風(fēng)險(xiǎn)，文檔要符合團(tuán)隊(duì)模板。第一次解釋沒問題，但每次都說一遍，就是純體力活了。

Skill 解決的就是這個(gè)問題。

你可以把它當(dāng)成一份給 Claude 的"工作說明書"。把常用的規(guī)則寫進(jìn)去，以后遇到類似的活，它就自己按規(guī)矩來，不用你重新教。

所以 Skill 的核心很簡(jiǎn)單：把你反復(fù)說的要求，變成 Claude 自動(dòng)調(diào)用的規(guī)則。

一、Skill 是什么

Skill 是一個(gè)"任務(wù)說明文件"，Claude Code 可以發(fā)現(xiàn)并調(diào)用它。

實(shí)現(xiàn)上，就是一個(gè)文件夾，里面放著一個(gè) SKILL.md。這個(gè)文件告訴 Claude：碰到這類任務(wù)，按這套規(guī)則來。

可以把它理解成三樣?xùn)|西的組合：

- 一份操作手冊(cè)。比如你寫了個(gè) PR 描述 Skill，Claude 以后每次寫 PR 描述就照著來。
- 一個(gè)工作模板。你希望文檔永遠(yuǎn)按"背景 → 問題 → 方案 → 結(jié)論"輸出，就寫進(jìn) Skill。
- 一種外 掛記憶。不是 Claude 真的記住了，而是你把規(guī)則寫成文件，需要時(shí)它去讀，然后照著做。

二、為什么需要 Skill

沒有 Skill 的時(shí)候，你可能經(jīng)常這樣說：

幫我寫個(gè) PR 描述，格式先寫 What，然后 Why，然后列 Changes，語氣簡(jiǎn)潔一點(diǎn)，別太長(zhǎng)。

說一次沒事。一周說五次，就煩了。

Skill 把這些重復(fù)說明固定下來。以后你只需要說"幫我寫 PR 描述"，Claude 就知道怎么寫。

就像你帶新人。第一次要把每個(gè)步驟講清楚，但如果寫成 SOP，以后新人直接看 SOP 就行。Skill 就是給 AI 用的 SOP。

它省掉的是：重復(fù)溝通、每次重新解釋、輸出格式忽好忽壞的不穩(wěn)定感。同時(shí)把你和團(tuán)隊(duì)的工作方式沉淀下來。

三、Skill 適合解決什么問題

判斷標(biāo)準(zhǔn)就一條：你有沒有對(duì) Claude 說過三次以上同樣的話？

如果有，就值得寫成 Skill。

常見場(chǎng)景：寫 PR 描述、做代碼審查、寫 commit message、按固定格式寫文檔、檢查代碼規(guī)范、按模板生成報(bào)告、解釋項(xiàng)目架構(gòu)、按某種風(fēng)格改寫內(nèi)容。

打個(gè)比方。你每次點(diǎn)奶茶都說"少冰、三分糖、不要珍珠、加椰果"——這就是一個(gè)固定偏好。Skill 等于把這個(gè)偏好存成"我的默認(rèn)配置"。以后說"老樣子"，對(duì)方就懂了。

四、Skill 的基本結(jié)構(gòu)

目錄結(jié)構(gòu)長(zhǎng)這樣：

~/.claude/skills/pr-description/
? SKILL.md

pr-description 是 Skill 文件夾，SKILL.md 是真正寫規(guī)則的地方。

一個(gè)最簡(jiǎn)的 SKILL.md 示例：

name: pr-description
description: Writes pull request descriptions. Use when creating a PR or summarizing changes.
---

When writing a PR description:

1. Check the current branch changes.
2. Write using this format:

## What
One sentence on what this PR does.

## Why
Why this change is needed.

## Changes
- Main changes, grouped together
- Deleted or renamed files if relevant

拆開來看就兩塊：

- 上半部分（frontmatter）：告訴 Claude 這個(gè) Skill 叫什么、什么時(shí)候用。
- 下半部分（正文）：告訴 Claude 具體怎么做。

五、name 和 description

Skill 里最關(guān)鍵的兩個(gè)字段：

name: pr-description
description: Writes pull request descriptions...

name 是名字，簡(jiǎn)短清晰，只用小寫字母、數(shù)字和連字符。好的命名像 pr-description、code-review、commit-message、frontend-review。太泛的名字比如 review、doc、work 容易撞車，也不好維護(hù)。

description 是觸發(fā)條件。Claude 靠它判斷什么時(shí)候該用這個(gè) Skill。寫得太模糊，Claude 不知道該不該用。

糟糕的例子：

description: Helps with work.

好的例子：

description: Writes pull request descriptions. Use when creating a PR, writing a PR, or summarizing code changes for a pull request.

寫 description 的時(shí)候，想象自己在給 Claude 貼標(biāo)簽：用戶說這些話時(shí)，你就該想到這個(gè) Skill。

六、Skill 放哪里

兩個(gè)位置：

個(gè)人 Skill（~/.claude/skills）：

只屬于你，跨項(xiàng)目使用。適合放你喜歡的 PR 格式、commit message 風(fēng)格、文檔結(jié)構(gòu)偏好、代碼解釋習(xí)慣。

項(xiàng)目 Skill（.claude/skills）：

放在代碼倉(cāng)庫(kù)里，團(tuán)隊(duì)共享。適合放團(tuán)隊(duì)代碼規(guī)范、項(xiàng)目架構(gòu)說明、測(cè)試流程、UI 設(shè)計(jì)規(guī)范、代碼審查標(biāo)準(zhǔn)?？寺№?xiàng)目的人自動(dòng)獲得同一套規(guī)則。

Windows 下個(gè)人 Skill 在 C:/Users/<your-user>/.claude/skills。

七、Skill 怎么自動(dòng)生效

Claude Code 啟動(dòng)時(shí)掃描所有 Skill，但不會(huì)一次性全讀進(jìn)去。它先只看 Skill 的 name 和 description。

當(dāng)你發(fā)請(qǐng)求（比如"幫我寫個(gè) PR 描述"），Claude 拿這句話去匹配所有 Skill 的 description。命中后，才加載完整的 SKILL.md，按規(guī)則執(zhí)行。

好處很明顯：平時(shí)不占上下文，需要時(shí)再加載，不需要你手動(dòng)敲一大段提示詞。

就像手機(jī)通訊錄。你不會(huì)每次打電話前把所有聯(lián)系人詳情看一遍，而是搜個(gè)名字，找到匹配的，再點(diǎn)進(jìn)去看詳情。

八、Skill 和 CLAUDE.md 的區(qū)別

很多人剛開始容易搞混這兩個(gè)東西。

CLAUDE.md 是"每次都要看的總規(guī)則"——比如你希望所有任務(wù)都默認(rèn)用 TypeScript 嚴(yán)格模式，寫進(jìn) CLAUDE.md。

Skill 是"碰到特定任務(wù)才看的專項(xiàng)說明"——比如你只希望寫 PR 描述時(shí)用某個(gè)模板，寫成 Skill。

簡(jiǎn)單說：全局習(xí)慣放 CLAUDE.md，局部規(guī)則放 Skill。別把所有東西都塞進(jìn) CLAUDE.md。

九、什么時(shí)候該寫 Skill

判斷標(biāo)準(zhǔn)就是一句話：這件事我是不是經(jīng)常重復(fù)解釋？

比如你經(jīng)常說"幫我 review 代碼，先找風(fēng)險(xiǎn)，再給建議，最后總結(jié)"——寫個(gè) code-review Skill。

你經(jīng)常說"幫我寫 commit message，格式用 type(scope): summary"——寫個(gè) commit-message Skill。

Skill 的意義不是讓你寫更多配置，是讓你以后少說重復(fù)的話。當(dāng)你腦子里冒出"以后都按這個(gè)格式來"的念頭時(shí)，就該動(dòng)手寫了。

十、怎么寫一個(gè)好 Skill

不需要復(fù)雜，但需要清楚。

1. 名字具體。

別叫 review，叫 frontend-review、backend-review、security-review。

2. description 回答兩個(gè)問題：

這個(gè) Skill 做什么？用戶說什么時(shí)該觸發(fā)？

3. 指令要可執(zhí)行。

"請(qǐng)寫得好一點(diǎn)"沒用。寫"先總結(jié)主要變化，再列出風(fēng)險(xiǎn)，最后給出修改建議"——Claude 能執(zhí)行具體動(dòng)作。

4. 用固定格式。

比如固定的 ## Summary / ## Risks / ## Suggestions 結(jié)構(gòu)。輸出穩(wěn)定，你復(fù)制粘貼也方便。

5. 從小開始。

先寫一個(gè) PR 描述 Skill，用順了再擴(kuò)展。別想著一步到位。

寫 Skill 跟整理房間一樣——別一上來就全屋翻新。先收拾一個(gè)抽屜，把最常用最亂的東西理好，效果立竿見影。

十一、進(jìn)階：allowed-tools

Skill 可以限制 Claude 能用的工具：

name: codebase-onboarding
description: Helps new developers understand how the system works.
allowed-tools: Read, Grep, Glob, Bash
model: sonnet

allowed-tools 表示這個(gè) Skill 只能用指定工具。適合只讀場(chǎng)景——你只想讓 Claude 看代碼、搜文件、解釋結(jié)構(gòu)，不想讓它改任何東西。

新手可以先忽略這個(gè)字段，等需要做更安全的 Skill 時(shí)再撿起來。

十二、進(jìn)階：漸進(jìn)式披露

Skill 內(nèi)容越來越多的時(shí)候，別全部堆在 SKILL.md 里。文件太長(zhǎng)，Claude 每次讀取都占更多上下文，維護(hù)也麻煩。

拆開：

my-skill/
? SKILL.md ? ? ? ? ?← 核心說明
? references/ ? ? ? ← 詳細(xì)參考資料
? ? architecture-guide.md
? ? review-checklist.md
? scripts/ ? ? ? ? ?← 可執(zhí)行腳本
? ? validate-env.sh
? assets/ ? ? ? ? ? ← 模板、圖片、示例
? ? template.md

就像一本書：SKILL.md 是目錄和重點(diǎn)摘要，references/ 是詳細(xì)章節(jié)，scripts/ 是自動(dòng)化工具，assets/ 是配套素材。Claude 先看最重要的，需要時(shí)才翻到對(duì)應(yīng)部分。

一個(gè)實(shí)用建議：盡量把 SKILL.md 控制在 500 行以內(nèi)，超過就考慮拆分。

十三、Skill 的優(yōu)先級(jí)

不同位置有同名 Skill 時(shí)，Claude 按優(yōu)先級(jí)選：企業(yè)級(jí) > 個(gè)人 > 項(xiàng)目 > 插件。

對(duì)個(gè)人用戶來說，別用太泛的名字一般不會(huì)沖突。別叫 review、doc、test，叫 team-code-review、api-doc-writing、frontend-test-checklist。命名越具體越安全。

十四、怎么測(cè)試 Skill

建好 Skill 后，重啟 Claude Code 讓它重新掃描。

測(cè)試流程：建文件夾 → 寫 SKILL.md → 重啟 → 看 Skill 是否出現(xiàn)在可用列表 → 用真實(shí)任務(wù)觸發(fā)。

比如建了 pr-description Skill，直接說"幫我給當(dāng)前分支寫個(gè) PR 描述"。如果正確觸發(fā)，Claude 會(huì)按你寫的模板輸出。

沒觸發(fā)的話，檢查兩件事：description 是不是太模糊；你的措辭跟 description 差得是不是太遠(yuǎn)。description 寫"Helps write documents"但你想在"寫 PR 描述"時(shí)觸發(fā)——這就太不準(zhǔn)了。

十五、一個(gè)入門示例

下面是最簡(jiǎn)單的 PR 描述 Skill，可以直接用：

name: pr-description
description: Writes pull request descriptions. Use when the user asks to write a PR description or summarize branch changes for a PR.


When writing a PR description, use this structure:

## What
Briefly explain what this PR changes.

## Why
Explain why this change is needed.

## Changes
- List the main changes
- Keep each bullet clear and short
- Group related changes together

## Testing
Mention how the changes were tested. If there were no tests, say so clearly.

特點(diǎn)：名字清楚、description 容易匹配、輸出結(jié)構(gòu)固定、指令簡(jiǎn)單。新手也能改。

熟悉之后，可以繼續(xù)做 commit-message、code-review、doc-writing、bug-debugging、architecture-explainer 等等。不用一開始就追求完美——先用起來，邊用邊改。

十六、總結(jié)

Skill 不是什么復(fù)雜的功能，它就是讓你少說重復(fù)話的方法。

如果普通提示詞是"這次請(qǐng)你這樣做"，那 Skill 就是"以后遇到這類事，都請(qǐng)你這樣做"。

它適合個(gè)人沉淀工作習(xí)慣，也適合團(tuán)隊(duì)統(tǒng)一規(guī)范和流程。但更重要的是：不用一上來就寫很復(fù)雜的 Skill。從你最常重復(fù)的任務(wù)開始——PR 描述、commit message、代碼審查——寫個(gè)簡(jiǎn)單版，用起來，慢慢迭代。

等你腦子里又冒出那句"以后都按這個(gè)格式來"，那會(huì)兒就已經(jīng)知道該怎么辦了

以上就是Claude Code Skill的入門與進(jìn)階實(shí)踐指南的詳細(xì)內(nèi)容，更多關(guān)于Claude Code Skill教學(xué)的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論