編譯｜冷貓

你還在為你的龍蝦笨笨的而煩惱嗎？

你還在為找不到合適的 Skills 安裝而焦頭爛額嗎？

你還在為網(wǎng)上找到的 Skills 可能不安全而心驚膽戰(zhàn)嗎？

養(yǎng)了這么久龍蝦，是時(shí)候開始構(gòu)建自己的 Skills 了。這時(shí)候，一篇來自 Anthropic 團(tuán)隊(duì)的 Skills 秘籍在外網(wǎng)廣為流傳，為想要構(gòu)建 Skills 的開發(fā)者和智能體用戶提供了絕佳的參考資料。

• 博客標(biāo)題：Lessons from Building Claude Code: How We Use Skills
• 博客鏈接：https://x.com/trq212/status/2033949937936085378

這篇文章來自于 Anthropic 的 Claude Code 團(tuán)隊(duì)工程師，Skills 功能核心參與者 Thariq Shihipar。內(nèi)容大多是 Anthropic 內(nèi)部使用 Skills 的實(shí)戰(zhàn)經(jīng)驗(yàn)和總結(jié)。

我們對(duì)該博客進(jìn)行了全文編譯，希望讀者從中獲取關(guān)于 Skills 制作、使用和推廣分發(fā)相關(guān)的經(jīng)驗(yàn)。

以下是博客全文：

Skills 已經(jīng)成為 Claude Code 中使用最廣泛的擴(kuò)展方式之一。它們靈活、易于創(chuàng)建，也方便分發(fā)。

但這種靈活性也帶來了一個(gè)問題：很難判斷什么才是最佳實(shí)踐。什么類型的 Skills 值得開發(fā)？寫出一個(gè)優(yōu)秀 Skill 的秘訣是什么？又應(yīng)該在什么時(shí)候?qū)⑺鼈兎窒斫o他人？

在 Anthropic 內(nèi)部，我們已經(jīng)在 Claude Code 中廣泛使用 Skills，目前有數(shù)百個(gè) Skills 在實(shí)際運(yùn)行中。

這些是我們?cè)谑褂?Skills 來加速開發(fā)過程中總結(jié)的一些經(jīng)驗(yàn)。

什么是 Skills ？

如果你剛接觸 Skills，建議先閱讀我們的文檔：

相關(guān)鏈接：https://code.claude.com/docs/en/skills

本文默認(rèn)你已經(jīng)對(duì) Skills 有一定了解。

我們經(jīng)常聽到一個(gè)常見的誤解：認(rèn)為 Skills「只是一些 Markdown 文件」。但實(shí)際上，Skills 最有趣的地方在于 —— 它們并不僅僅是文本文件，而是一個(gè)文件夾，里面可以包含腳本、資源、數(shù)據(jù)等內(nèi)容，供智能體進(jìn)行發(fā)現(xiàn)、探索和操作。

在 Claude Code 中，Skills 還具備多種配置選項(xiàng)，包括注冊(cè)動(dòng)態(tài)鉤子（hooks）等。

相關(guān)鏈接：https://code.claude.com/docs/en/skills#frontmatter-reference

我們發(fā)現(xiàn)，一些最有意思的 Skills，正是通過巧妙利用這些配置選項(xiàng)和文件結(jié)構(gòu)來實(shí)現(xiàn)的。

Skills 類型

在整理我們所有 Skills 之后，我們發(fā)現(xiàn)它們大致可以分為幾個(gè)常見的類別。

最好的 Skills 通常能夠清晰地歸類到一個(gè)類別中，而那些更為復(fù)雜或難以理解的 Skills，則可能跨越多個(gè)類別。這并不是一個(gè)權(quán)威的分類列表，但它為你判斷在你的組織中是否缺少某些類型的 Skills 提供了一個(gè)很好的思路。

1. 庫(kù)與 API 參考

這些 Skills 解釋如何正確使用庫(kù)、CLI 或 SDK。這些 Skills 可以是針對(duì)內(nèi)部庫(kù)，也可以是針對(duì) Claude Code 在使用常見庫(kù)時(shí)遇到困難的庫(kù)。它們通常包含一組參考代碼片段，以及 Claude 在編寫腳本時(shí)應(yīng)避免的一些常見問題。

示例：

• billing-lib — 你的內(nèi)部賬單庫(kù)：邊緣情況、常見陷阱等
• internal-platform-cli — 你內(nèi)部 CLI 包裝器的每個(gè)子命令，并提供何時(shí)使用它們的示例
• frontend-design — 使 Claude 更好地理解你的設(shè)計(jì)系統(tǒng)

2. 產(chǎn)品驗(yàn)證

這些 Skills 描述了如何測(cè)試或驗(yàn)證代碼是否正常工作。它們通常與外部工具（如 Playwright、tmux 等）配合使用，以進(jìn)行驗(yàn)證。

驗(yàn)證 Skills 對(duì)確保 Claude 輸出正確非常有用?？赡苤档米尮こ處熁ㄒ恢軙r(shí)間，專注于提高驗(yàn)證 Skills 的質(zhì)量。

考慮使用技術(shù)，例如讓 Claude 記錄它的輸出視頻，這樣你就可以準(zhǔn)確看到它測(cè)試了什么，或者在每個(gè)步驟上強(qiáng)制進(jìn)行狀態(tài)的程序化斷言。這些通常通過在 Skills 中包含各種腳本來實(shí)現(xiàn)。

示例：

• signup-flow-driver — 在無頭瀏覽器中運(yùn)行注冊(cè) → 郵件驗(yàn)證 → 入職流程，并在每個(gè)步驟上進(jìn)行狀態(tài)斷言
• checkout-verifier — 使用 Stripe 測(cè)試卡驅(qū)動(dòng)結(jié)賬界面，驗(yàn)證發(fā)票是否真正落入正確的狀態(tài)
• tmux-cli-driver — 用于需要 TTY 的交互式 CLI 測(cè)試

3. 數(shù)據(jù)抓取與分析

這些 Skills 連接到你的數(shù)據(jù)和監(jiān)控系統(tǒng)。這些 Skills 可能包括庫(kù)，用于通過憑證、特定的儀表盤 ID 等抓取數(shù)據(jù)，以及常見工作流或獲取數(shù)據(jù)的方式說明。

示例：

• funnel-query — "我需要哪些事件來查看注冊(cè) → 激活 → 付費(fèi)" 以及實(shí)際包含標(biāo)準(zhǔn) user_id 的表
• cohort-compare — 比較兩個(gè)群體的留存率或轉(zhuǎn)化率，標(biāo)記統(tǒng)計(jì)顯著的差異，鏈接到細(xì)分定義
• grafana — 數(shù)據(jù)源 UID、集群名稱、問題 → 儀表盤查找表

4. 業(yè)務(wù)流程與團(tuán)隊(duì)自動(dòng)化

這些 Skills 將重復(fù)的工作流自動(dòng)化為一個(gè)命令。雖然這些 Skills 通常是相對(duì)簡(jiǎn)單的指令，但可能有更復(fù)雜的依賴關(guān)系，涉及其他 Skills 或 MCP（多控制點(diǎn)）。

對(duì)于這些 Skills，將先前的結(jié)果保存在日志文件中有助于保持模型的一致性，并反映工作流的前期執(zhí)行。

示例：

• standup-post — 匯總你的任務(wù)追蹤器、GitHub 活動(dòng)和 Slack 內(nèi)容 → 格式化的站立會(huì)議，僅顯示增量變化
• create--ticket — 強(qiáng)制執(zhí)行模式（有效的枚舉值、必填字段）以及創(chuàng)建后工作流（通知審閱者、在 Slack 中鏈接）
• weekly-recap — 合并的 PR + 關(guān)閉的票據(jù) + 部署 → 格式化的周報(bào)

5. 代碼腳手架與模板

這些 Skills 用于生成代碼庫(kù)中特定功能的框架模板。你可以將這些 Skills 與可組合的腳本結(jié)合使用。它們?cè)谀愕哪_手架有自然語(yǔ)言要求，而這些要求無法僅通過代碼覆蓋時(shí)尤為有用。

示例：

• new--workflow — 使用你的注釋腳手架一個(gè)新的服務(wù) / 工作流 / 處理器
• new-migration — 你的遷移文件模板以及常見的坑
• create-app — 新的內(nèi)部應(yīng)用，預(yù)先配置你的認(rèn)證、日志記錄和部署

6. 代碼質(zhì)量與審核

這些 Skills 強(qiáng)制執(zhí)行你組織中的代碼質(zhì)量并幫助審查代碼。它們可以包括確定性的腳本或工具，以確保最大程度的穩(wěn)健性。你可能希望將這些 Skills 自動(dòng)運(yùn)行，作為鉤子的一部分或 GitHub Actions 中的一部分。

示例：

• adversarial-review — 啟動(dòng)一個(gè)新鮮眼光的子智能體進(jìn)行批評(píng)，實(shí)施修復(fù)，迭代直到反饋降級(jí)為小瑕疵
• code-style — 強(qiáng)制執(zhí)行代碼風(fēng)格，特別是 Claude 默認(rèn)處理不好的一些風(fēng)格
• testing-practices — 關(guān)于如何編寫測(cè)試以及需要測(cè)試什么的說明

7. CI/CD 與部署

這些 Skills 幫助你在代碼庫(kù)內(nèi)獲取、推送和部署代碼。這些 Skills 可能引用其他 Skills 以收集數(shù)據(jù)。

示例：

• babysit-pr — 監(jiān)控 PR → 重試不穩(wěn)定的 CI → 解決合并沖突 → 啟用自動(dòng)合并
• deploy- — 構(gòu)建 → 煙霧測(cè)試 → 漸進(jìn)式流量發(fā)布與錯(cuò)誤率比較 → 回滾回退
• cherry-pick-prod — 隔離工作樹 → 衍生選擇 → 沖突解決 → 帶模板的 PR

8. 運(yùn)行手冊(cè)

這些 Skills 通過癥狀（如 Slack 線程、警報(bào)或錯(cuò)誤簽名），進(jìn)行多工具調(diào)查，并生成結(jié)構(gòu)化報(bào)告。

示例：

• -debugging — 映射癥狀 → 工具 → 查詢模式，適用于你最高流量的服務(wù)
• oncall-runner — 獲取警報(bào) → 檢查常見問題 → 格式化結(jié)果
• log-correlator — 給定請(qǐng)求 ID，從可能涉及的所有系統(tǒng)中提取匹配的日志

9. 基礎(chǔ)設(shè)施操作

這些 Skills 執(zhí)行常規(guī)的維護(hù)和操作程序，其中一些涉及需要有防護(hù)措施的破壞性操作。它們使工程師更容易遵循最佳實(shí)踐，在關(guān)鍵操作中避免出錯(cuò)。

示例：

• -orphans — 查找孤立的 pods/volumes → 發(fā)布到 Slack → 浸泡期 → 用戶確認(rèn) → 級(jí)聯(lián)清理
• dependency-management — 你組織的依賴審批工作流
• cost-investigation — "為什么我們的存儲(chǔ) / 出站流量賬單突然飆升"，并提供具體的存儲(chǔ)桶和查詢模式

制作 Skills 的技巧

一旦你決定要制作某個(gè) Skills，如何編寫它呢？以下是我們總結(jié)的一些最佳實(shí)踐、技巧和竅門。

我們最近還發(fā)布了 Skill Creator，使得在 Claude Code 中創(chuàng)建 Skills 變得更加容易。

相關(guān)鏈接：https://claude.com/blog/improving-skill-creator-test-measure-and-refine-agent-skills

不要陳述顯而易見的內(nèi)容

Claude Code 已經(jīng)了解很多關(guān)于你的代碼庫(kù)的信息，也了解很多編碼的基礎(chǔ)知識(shí)，包括許多默認(rèn)的觀點(diǎn)。如果你發(fā)布的 Skills 主要是關(guān)于知識(shí)的，嘗試專注于那些能夠讓 Claude 脫離正常思維方式的信息。

示例：

前端設(shè)計(jì) Skills就是一個(gè)很好的例子 —— 它是由 Anthropic 的一位工程師通過與客戶反復(fù)迭代，旨在提升 Claude 的設(shè)計(jì)品味，避免使用經(jīng)典的設(shè)計(jì)模式（例如 Inter 字體和紫色漸變）。

相關(guān)鏈接：https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md

構(gòu)建陷阱部分

在任何 Skills 中，Gotchas（常見陷阱）部分是最有價(jià)值的內(nèi)容。這些部分應(yīng)該基于 Claude 在使用 Skills 時(shí)遇到的常見失敗點(diǎn)來構(gòu)建。理想情況下，你應(yīng)該隨著時(shí)間的推移更新你的 Skills，捕捉這些常見問題，以確保 Skills 的有效性和準(zhǔn)確性。

使用文件系統(tǒng)和漸進(jìn)式披露

正如我們之前提到的，Skills 是一個(gè)文件夾，而不僅僅是一個(gè) Markdown 文件。你應(yīng)該將整個(gè)文件系統(tǒng)視為一種上下文工程和漸進(jìn)式披露的方式。告訴 Claude 你的 Skills 包含哪些文件，它將在適當(dāng)?shù)臅r(shí)候讀取它們。

漸進(jìn)式披露的最簡(jiǎn)單形式是指向其他 Markdown 文件供 Claude 使用。例如，你可以將詳細(xì)的函數(shù)簽名和使用示例分離到 references/api.md 中。

另一個(gè)例子：如果你的最終輸出是一個(gè) Markdown 文件，你可以在 assets/ 文件夾中包括一個(gè)模板文件供 Claude 復(fù)制和使用。

你可以有多個(gè)文件夾來存儲(chǔ)參考資料、腳本、示例等，這些都有助于 Claude 更有效地工作。

避免「束縛」 Claude

Claude 通常會(huì)盡量遵循你的指示，然而由于 Skills 的高度可復(fù)用性，你需要小心不要讓指令過于具體。給予 Claude 必要的信息，同時(shí)也要留給它一定的靈活性以適應(yīng)不同的情況。

例如：

思考 Skills 的設(shè)置

有些 Skills 可能需要用戶提供上下文信息來完成設(shè)置。例如，如果你在制作一個(gè)將站立會(huì)議內(nèi)容發(fā)布到 Slack 的 Skills，你可能希望 Claude 詢問要發(fā)布到哪個(gè) Slack 頻道。

一種良好的做法是將這些設(shè)置的信息存儲(chǔ)在 Skills 目錄中的 config.json 文件中，如上例所示。如果配置尚未設(shè)置，智能體可以提示用戶提供必要的信息。

如果你希望智能體呈現(xiàn)結(jié)構(gòu)化的多選問題，可以指示 Claude 使用AskUserQuestion工具。

描述字段是給模型的

當(dāng) Claude Code 啟動(dòng)一個(gè)會(huì)話時(shí)，它會(huì)構(gòu)建一個(gè)包含每個(gè)可用 Skills 及其描述的列表。這份列表是 Claude 用來決定「是否有 Skills 能解決這個(gè)請(qǐng)求？」的依據(jù)。因此，描述字段并不是 Skills 的總結(jié)，而是描述何時(shí)觸發(fā)這個(gè) Skills 的場(chǎng)景。

記憶與存儲(chǔ)數(shù)據(jù)

有些 Skills 可以通過在其內(nèi)部存儲(chǔ)數(shù)據(jù)來實(shí)現(xiàn)一定的記憶功能。你可以將數(shù)據(jù)存儲(chǔ)在簡(jiǎn)單的附加文本日志文件、JSON 文件，或者更復(fù)雜的 SQLite 數(shù)據(jù)庫(kù)中。

例如：

一個(gè) standup-post Skills 可能會(huì)保留一個(gè) standups.log，記錄每次發(fā)布的內(nèi)容。這意味著下次運(yùn)行時(shí)，Claude 可以讀取自己的歷史記錄，并能夠檢測(cè)自昨天以來的變化。

需要注意的是，存儲(chǔ)在 Skills 目錄中的數(shù)據(jù)可能在 Skills 升級(jí)時(shí)被刪除，因此你應(yīng)當(dāng)將數(shù)據(jù)存儲(chǔ)在一個(gè)穩(wěn)定的文件夾中。到目前為止，我們?yōu)槊總€(gè)插件提供了 ${CLAUDE_PLUGIN_DATA} 作為穩(wěn)定存儲(chǔ)數(shù)據(jù)的文件夾。

存儲(chǔ)腳本與生成代碼

提供代碼是給 Claude 最強(qiáng)大的工具之一。將腳本和庫(kù)交給 Claude，可以讓它專注于組合和決策，而不是重新構(gòu)建基礎(chǔ)代碼。

例如：

在你的數(shù)據(jù)科學(xué) Skills 中，你可能有一組用于從事件源抓取數(shù)據(jù)的函數(shù)庫(kù)。為了讓 Claude 執(zhí)行復(fù)雜的分析，你可以為它提供一套像這樣的幫助函數(shù)：

Claude 然后可以動(dòng)態(tài)生成腳本，利用這些功能組合來執(zhí)行更高級(jí)的分析，比如處理類似 「星期二發(fā)生了什么？」 這樣的提示。

按需鉤子（On Demand Hooks）

Skills 可以包括僅在 Skills 被調(diào)用時(shí)激活的鉤子，并且這些鉤子的作用僅持續(xù)到會(huì)話結(jié)束。這對(duì)于一些有強(qiáng)烈意見、但并不希望一直運(yùn)行的鉤子特別有用，它們?cè)谀承┣闆r下會(huì)非常有價(jià)值。

例如：

• /careful— 通過 Bash 中的PreToolUse匹配器阻止 rm -rf、DROP TABLE、force-push、kubectl delete 等危險(xiǎn)操作。你只希望在知道自己正在操作生產(chǎn)環(huán)境時(shí)才啟用它，常開會(huì)讓你瘋狂。
• /freeze— 阻止在特定目錄外的任何編輯 / 寫入操作。非常有用，特別是當(dāng)你想確保只有在特定文件夾中進(jìn)行更改時(shí)才執(zhí)行代碼時(shí)。
• 調(diào)試時(shí)：「我想加日志，但我總是無意中‘修復(fù)’無關(guān)的內(nèi)容?！?使用按需鉤子，可以防止在不需要的情況下影響其他文件或代碼片段。

這些鉤子可以根據(jù)實(shí)際需要進(jìn)行觸發(fā)，而不是始終保持啟用狀態(tài)，從而避免不必要的干擾，同時(shí)在需要時(shí)提供強(qiáng)有力的功能。

Skills 分發(fā)

Skills 的最大優(yōu)勢(shì)之一是，你可以將它們與團(tuán)隊(duì)中的其他成員共享。

你有兩種方式可以將 Skills 分享給別人：

1. 將 Skills 檢查到你的代碼庫(kù)中（在 ./.claude/skills 下）。

2. 創(chuàng)建插件并擁有一個(gè)Claude Code Plugin市場(chǎng)，用戶可以在其中上傳和安裝插件（有關(guān)更多信息，請(qǐng)參閱文檔 https://code.claude.com/docs/en/plugin-marketplaces）。

對(duì)于在相對(duì)較少的代碼庫(kù)中工作的較小團(tuán)隊(duì)，將 Skills 檢查到代碼庫(kù)中是一個(gè)不錯(cuò)的選擇。但每個(gè)被檢查進(jìn)來的 Skills 都會(huì)增加一些模型的上下文。當(dāng)團(tuán)隊(duì)規(guī)模擴(kuò)大時(shí)，內(nèi)部插件市場(chǎng)可以幫助你分發(fā) Skills，并讓團(tuán)隊(duì)成員決定哪些 Skills 需要安裝。

管理市場(chǎng)

如何決定哪些 Skills 進(jìn)入市場(chǎng)？人們?nèi)绾翁峤凰鼈儯?/p>

我們沒有一個(gè)集中式的團(tuán)隊(duì)來做決定；相反，我們嘗試通過自然的方式找到最有用的 Skills。如果你有一個(gè) Skills 想讓大家嘗試，你可以將它上傳到 GitHub 的沙箱文件夾，并通過 Slack 或其他論壇將鏈接分享給大家。

當(dāng)一個(gè) Skills 獲得一定的關(guān)注度（由 Skills 擁有者決定）后，他們可以提交一個(gè) PR，將其移入市場(chǎng)。

警告：創(chuàng)建不必要的或冗余的 Skills 是非常容易的，因此在發(fā)布之前，確保你有一個(gè)篩選和策劃的方法非常重要。

組合 Skills

你可能希望有一些 Skills 相互依賴。例如，你可能有一個(gè)文件上傳 Skills，它上傳文件；還有一個(gè) CSV 生成 Skills，它生成 CSV 并上傳文件。這類依賴管理目前在市場(chǎng)或 Skills 中并沒有內(nèi)建功能，但你可以直接通過名稱引用其他 Skills，如果它們已被安裝，模型會(huì)調(diào)用它們。

衡量 Skills 的效果

為了了解一個(gè) Skills 的表現(xiàn)，我們使用了PreToolUse鉤子，允許我們記錄公司內(nèi) Skills 的使用情況（代碼鏈接：https://gist.github.com/ThariqS/24defad423d701746e23dc19aace4de5）。

這意味著我們可以發(fā)現(xiàn)哪些 Skills 比較受歡迎，哪些 Skills 的觸發(fā)率低于我們的預(yù)期。

結(jié)論

Skills 是極其強(qiáng)大且靈活的智能體工具，但目前仍處于早期階段，我們還在不斷摸索如何最好地使用它們。

可以將這篇文章看作是我們?cè)谑褂眠^程中積累的一些有用提示，而非權(quán)威指南。理解 Skills 的最佳方式是開始實(shí)踐，進(jìn)行實(shí)驗(yàn)，看看什么最適合你。

我們的大多數(shù) Skills 最初只是一行代碼和一個(gè)「Gotcha」，隨著 Claude 遇到新的邊界情況，大家會(huì)不斷進(jìn)行完善。