前言

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

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

Skill 解決的就是這個問題。

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

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

一、Skill 是什么

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

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

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

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

二、為什么需要 Skill

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

幫我寫個 PR 描述，格式先寫 What，然后 Why，然后列 Changes，語氣簡潔一點，別太長。

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

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

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

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

三、Skill 適合解決什么問題

判斷標準就一條：你有沒有對 Claude 說過三次以上同樣的話？

如果有，就值得寫成 Skill。

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

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

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

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

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

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

一個最簡的 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 這個 Skill 叫什么、什么時候用。
- 下半部分（正文）：告訴 Claude 具體怎么做。

五、name 和 description

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

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

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

description 是觸發(fā)條件。Claude 靠它判斷什么時候該用這個 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 的時候，想象自己在給 Claude 貼標簽：用戶說這些話時，你就該想到這個 Skill。

六、Skill 放哪里

兩個位置：

個人 Skill（~/.claude/skills）：

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

項目 Skill（.claude/skills）：

放在代碼倉庫里，團隊共享。適合放團隊代碼規(guī)范、項目架構(gòu)說明、測試流程、UI 設(shè)計規(guī)范、代碼審查標準。克隆項目的人自動獲得同一套規(guī)則。

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

七、Skill 怎么自動生效

Claude Code 啟動時掃描所有 Skill，但不會一次性全讀進去。它先只看 Skill 的 name 和 description。

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

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

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

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

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

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

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

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

九、什么時候該寫 Skill

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

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

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

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

十、怎么寫一個好 Skill

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

1. 名字具體。

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

2. description 回答兩個問題：

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

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

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

4. 用固定格式。

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

5. 從小開始。

先寫一個 PR 描述 Skill，用順了再擴展。別想著一步到位。

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

十一、進階：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 表示這個 Skill 只能用指定工具。適合只讀場景——你只想讓 Claude 看代碼、搜文件、解釋結(jié)構(gòu)，不想讓它改任何東西。

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

十二、進階：漸進式披露

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

拆開：

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

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

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

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

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

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

十四、怎么測試 Skill

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

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

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

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

十五、一個入門示例

下面是最簡單的 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.

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

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

十六、總結(jié)

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

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

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

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

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

最新評論