與其做個提示詞收藏家不如做技能建造者

作者：AI街溜子
日期：2026年1月6日 下午1:21
來源：WeChat 原文

✦整理版優先睇

速讀 5 個重點 高亮

文章教人從提示詞收藏家轉型為技能建造者，用Claude Code Skills將一次性提示詞變成可自動觸發嘅能力模組，並提供完整嘅SKILL.md編寫指南。

整理版摘要

呢篇文章係由CY-CHENYUE分享嘅自身經驗，佢曾經係一個狂熱嘅提示詞收藏家，收藏咗好多提示詞但係真正用過嘅唔超過3條。佢發現提示詞係一次性嘅，用完即棄，每次都要手動複製貼上，好唔方便。直到佢發現Claude Code嘅Skills功能，可以先將提示詞轉換成自動觸發嘅技能，唔使再複製貼上，講句話就觸發。佢提出咗3步轉換法：加元數據、結構化、放對位置。

文章後半部分係一份詳盡嘅Claude Code Skills編寫指南，涵蓋核心概念、SKILL.md基本結構、description優化方法（將激活率從20%提升到80%以上）、四種骨架模式、漸進式披露、高級技巧、工作流同反饋循環，同埋CLAUDE.md同SKILL.md嘅區別。整體結論係：與其做提示詞收藏家，不如做技能建造者，將收藏嘅提示詞轉換成技能，沉澱成專屬AI能力庫。

  • 提示詞收藏家嘅困境：收藏多、使用少，因為揾唔到、格式唔啱、懶得貼，解決方法係將提示詞轉成永久複用嘅Skill。
  • 3步轉換法：加元數據（name+description，description要包含觸發詞）、結構化（用標題拆成有層級嘅內容）、放對位置（.claude/skills/技能名/SKILL.md）。
  • 提升激活率嘅關鍵：description寫具體觸發詞，用第三人稱，加入強制評估Hook（激活率可由20%升到84%）。
  • 四種Skill骨架模式：流程型、任務菜單型、規範型、能力清單型，按任務類型選擇。
  • 漸進式披露：主文件控制在500行以內，詳細內容拆分到REFERENCE.md或EXAMPLES.md，避免嵌套過深。
值得記低
連結 docs.claude.com

官方Skills最佳實踐

Anthropic官方文檔，提供Skills最佳實踐指南。

開啟
連結 github.com

官方Skills示例

Anthropic官方GitHub倉庫，包含多個Skills示例。

開啟
連結 github.com

Awesome Claude Skills

社羣維護嘅Claude Skills合集。

開啟
連結 scottspence.com

激活率提升方案

Scott Spence嘅文章，詳細講解點樣令Claude Code Skills可靠激活。

開啟
整理重點

由收藏家轉型做建造者

作者CY-CHENYEE分享佢以前係個提示詞收藏家，見到啲靚提示詞就收藏，但係真正用過嘅唔超過3條。佢發現問題在於：揾唔到、格式唔啱、懶得貼。提示詞係一次性嘅，用完即棄，次次都要從頭嚟。

作者提出3步轉換法：加元數據、結構化、放對位置。具體做法係喺提示詞最前面加name同description，description要包含觸發詞；然後用標題將內容拆成結構化格式；最後保存到.claude/skills/技能名/SKILL.md。

  1. 1 Step 1：加元數據 — name係技能名稱（小寫字母加連字符），description係做咩同幾時用，重點係寫埋觸發詞。
  2. 2 Step 2：結構化 — 將一大段提示詞用標題拆成有層級、有步驟嘅內容，AI理解得清楚啲。
  3. 3 Step 3：放對位置 — 保存到指定路徑，一個技能一個文件夾，方便管理。
整理重點

激活率提升秘訣同骨架模式

好多Skill默認激活率得20%左右，關鍵在於description點寫。壞寫法係「處理文檔」，好寫法係「從PDF提取文本同表格，填充表單，合併文檔。當用戶提到PDF、表單、文檔提取時使用。」越具體，AI越容易匹配。

文章仲介紹咗四種Skill骨架模式：流程型、任務菜單型、規範型、能力清單型。按任務類型揀適合嘅結構。例如有固定順序嘅任務用流程型，同一領域多種操作就用任務菜單型。

  • 流程型（Workflow-based）：Overview → 決策樹 → Step 1 → Step 2 — 適合有固定順序嘅任務。
  • 任務菜單型（Task-based）：Overview → Quick start → Task 1 → Task 2 — 適合同一領域多種操作。
  • 規範型（Reference/Guidelines）：Overview → Guidelines → Specifications → Usage — 適合品牌規範、代碼風格。
  • 能力清單型（Capabilities-based）：Overview → Core capabilities → 1, 2, 3 — 適合綜合性系統能力。
整理重點

進階技巧：漸進式披露同CLAUDE.md區別

為咗避免文件過長，建議用漸進式披露：主文件SKILL.md控制在500行以內，詳細內容如參考資料、使用示例拆分到REFERENCE.md同EXAMPLES.md，工具腳本放scripts文件夾。引用保持一層深度，避免嵌套。

文件組織結構示例 text 
my-skill/
├── SKILL.md          # 主文件：概覽同導航（≤500行）
├── REFERENCE.md      # 詳細參考（按需加載）
├── EXAMPLES.md       # 使用示例（按需加載）
└── scripts/
    ├── helper.py     # 工具腳本（執行，唔讀取）
    └── validate.py   # 驗證腳本

文章亦釐清咗CLAUDE.md同SKILL.md嘅分別：CLAUDE.md係每次對話都加載，記錄項目規範同約束，係項目嘅「憲法」；SKILL.md係按需激活，包含專業能力同工作流，係專業嘅「能力模組」。寫CLAUDE.md要由護欄開始，只喺Claude容易出錯嘅地方添加說明，避免用@引用詳細文檔，避免純否定約束。

整理重點

Skill模板同快速創建流程

文章提供咗一個可直接套用嘅Skill模板，包含元數據、核心理念、核心原則、工作流程、質量檢查、常見誤區同觸發場景。仲有快速創建流程，由需求澄清開始，揀骨架模式，編寫元數據同正文，建立文件，最後驗證。

通用Skill模板 markdown 
---
name: [skill-name]
description: [做咩嘅技能]。當用戶[觸發場景1]、[觸發場景2]或提到[關鍵詞]時使用。[補充說明核心特點]。
---
# [Skill 名稱]
## 核心理念
[1-3句說明呢個Skill嘅核心價值同設計哲學]

## 核心原則
1. [原則1]: [簡要說明]
2. [原則2]: [簡要說明]
3. [原則3]: [簡要說明]

## 工作流程
### Step 1: [步驟名]
[具體做咩，需要咩輸入，產生咩輸出]
### Step 2: [步驟名]
[具體做咩，需要咩輸入，產生咩輸出]
### Step 3: [步驟名]
[具體做咩，需要咩輸入，產生咩輸出]

## 質量檢查
完成前必須驗證:
- [檢查項1]
- [檢查項2]
- [檢查項3]

## 常見誤區與正確做法
- [誤區1] → [正確做法1]
- [誤區2] → [正確做法2]

## 觸發場景
當用戶有以下需求時使用呢個技能:
- [場景1]
- [場景2]
- [場景3]

快速創建流程仲包括驗證檢查清單：name要符合規範、description要包含觸發詞同用第三人稱、正文用Markdown結構、控制在500行以內、包含質量檢查或驗證步驟。透過呢個流程，用戶可以將網上收藏嘅提示詞快速轉化為高質素、高激活率嘅Skill。


Hello阿，我係CY-CHENYUE
你有冇試過呢種體驗：
睇到一條超正嘅提示詞，
好激動就收藏咗，
心諗"下次一定要用"。
然後……就冇然後啦。
三個月之後，
你個收藏夾入面收埋咗 N 條提示詞。
真正用過嘅，唔超過 3 條。

提示詞收藏家嘅困境


我曾經係一個狂熱嘅提示詞收藏家。
見到"叫 AI 寫出爆款文案"嘅提示詞，就收藏。
見到"一鍵生成週報"嘅提示詞，就收藏。
見到"模擬頂級產品經理思考"嘅提示詞，就收藏收藏收藏。
然後呢？

等我要真係用嘅時候，問題就嚟喇：
第一，揾唔到。
存咗喺邊？
筆記？收藏夾？聊天記錄？
定係嗰個"稍後先睇"嘅文件夾？
第二，格式唔啱。
好辛苦先揾返出嚟，
發現原來係畀 ChatGPT 寫嘅，
Claude 用起上嚟效果唔同。
或者係英文嘅，仲要自己翻譯調整。
第三，懶得去貼。
最關鍵嘅係，
每次都要打開筆記，複製，切換視窗，貼上。
麻煩。算啦，下次先用啦。
於是"下次"就變成咗"永遠都唔"。
提示詞係一次過嘅，用完好就丟，下次仲要由頭嚟過。

提示詞可以變成技能


直到我發現咗 Claude Code 嘅 Skills 功能。
提示詞係"講一次"嘅話，Skill 係"教識 AI"嘅能力。
即係點解？
普通提示詞，
你每次都要自己手動輸入。
就好似每次見面都要重新自我介紹咁。
而 Skill，
係你提前"訓練"好嘅能力模塊。
AI 記住咗，下次你一講相關嘅說話，佢就會自動調用。
唔使複製，唔使貼，講一句話就觸發。
更妙嘅係：
網上嗰啲你收藏嘅提示詞，都可以轉換成 Skill。
一次轉換，永久重複使用。


3 步轉換法


將一條提示詞變成 Skill，只需要 3 步。

Step 1：加元數據

喺提示詞最前面，加幾行描述信息：
插入圖片：元數據示例截圖
兩個欄位：
name：技能名稱，小寫字母加連字符
description：做乜 + 幾時用
重點係 description。
呢個決定咗 AI 可唔可以"認出"應該用呢個技能。
秘訣：將觸發詞寫入去。
例如你個技能係寫週報嘅，description 就寫：
"生成工作週報。當用戶講'寫週報''總結本週工作''週報模板'時使用。"
咁樣一嚟，你以後只要講"幫我寫週報"，AI 就會自動調用呢個技能。

Step 2：結構化

網上嘅提示詞，通常係一大段說話。
呢啲一嚿嚿文字，AI 讀起上嚟好容易"走神"。
轉換嘅時候，用標題將內容拆分成結構：
有標題、有層級、有步驟。
AI 理解起上嚟清晰好多。

Step 3：放啱位置

將寫好嘅文件，儲存到指定路徑：
.claude/skills/你嘅技能名/SKILL.md
一個技能一個文件夾，方便管理。
搞定。
你可能會問：AI 真係可以識別出應該用邊個技能咩？
講真，預設激活率得 20% 左右。

一個提升激活率嘅小技巧


可以提高到 80% 以上：
喺 description 入面寫清楚觸發詞
差嘅寫法：
"處理文檔"
好嘅寫法：
"從 PDF 提取文本同表格，填充表單，合併文檔。當用戶提到 PDF、表單、文檔提取時使用。"
越具體，AI 就越容易匹配到。

提示詞用一次就冇咗，但係技能會沉澱落嚟。
與其做一個"提示詞收藏家"，
不如做一個"技能建造者"。
下次見到好嘅提示詞，唔好齋收藏。
用 5 分鐘，將佢變成 Skill。

你會擁有一個專屬嘅 AI 能力庫。
嗰啲收藏夾入面嘅 N 條提示詞？
係時候要佢哋真正發揮作用喇。

我整理咗一份 Skill 轉換模板，包含：
標準 SKILL.md 文件結構
4 種常用骨架模式
description 高激活率寫法示例
發佈前自查清單
---
name: claude-code-skills-guide
description: Claude Code Skills 編寫完整指南。當需要創建、優化或調試 Skill 文件時使用。包含元數據規範、激活率優化、骨架模式、漸進式披露等最佳實踐。
---
# Claude Code Skills 編寫完整指南
基於 Anthropic 官方文檔 + Twitter/Reddit/Hacker News/中文社區高質量討論整理
## 一、Skills 核心概念
### Skills 是什麼
Skills 不是一次性 Prompt，而是"打包好的能力模塊"。它等待被模型發現、讀取並複用，解決"以後遇到這類事情該怎麼做"的問題。
### 三者區別
- Prompt: 一次性聊天指令，用完即棄
- Command: 常用的代碼片段，需要手動調用
- Skill: SOP 加工具包，可以自動激活並複用
## 二、SKILL.md 基本結構
文件開頭需要包含元數據塊，包括 name 和 description，然後是具體指令內容。
### 元數據規則
- name: 必需，限制 64 字符以內，只能用小寫字母、數字、連字符
- description: 必需，限制 1024 字符以內，必須說明"做什麼"和"什麼時候用"
- allowed-tools: 可選，用於限制可用工具
### 格式原則
SKILL.md 文件本身應使用 Markdown 結構（標題、列表）幫助 Claude 理解。Claude 對 XML 標籤有特殊識別能力，可用於包裹數據和指令。避免純文本長指令，會導致"指令漂移"（模型逐漸忽略前面的約束）。
### 格式要求
推薦使用:
- 標題標記（# ## ###）建立層級結構
- 列表符號（-）表示並列項
- 縮進表示層級關係
- 箭頭符號（→）表示流程或映射關係
- 冒號（:）表示鍵值對
- 代碼塊僅用於命令示例或配置示例
避免使用:
- 過多的加粗或斜體標記
- 表情符號
- 純裝飾性的分隔線
- 複雜的表格（簡單列表更易解析）
原則: 用 Markdown 建立結構幫助 AI 理解，但保持簡潔，不過度裝飾
## 三、description 是最關鍵的（決定激活率）
### 問題
Skills 默認激活率只有 20%（社區測試數據）
### 解決方案
**第一，具體加觸發詞**
- 壞的寫法: "處理文檔"
- 好的寫法: "從 PDF 提取文本和表格，填充表單，合併文檔。當處理 PDF 文件或用戶提到 PDF、表單、文檔提取時使用。"
**第二，用第三人稱**
因為 description 會注入系統提示。
- 好的寫法: Processes Excel files and generates reports
- 避免寫成: I can help you process Excel files
**第三，使用強制評估 Hook**
可以把激活率從 20% 提升到 84%。具體做法是在指令中加入強制評估序列:
- Step 1 EVALUATE: 對每個 skill 說明 YES/NO 及原因
- Step 2 ACTIVATE: 立即使用 Skill 工具
- Step 3 IMPLEMENT: 只在激活後執行
強調: 評估如果不激活就毫無價值。
## 四、四種 Skill 骨架模式
### 流程型 Workflow-based
- 結構: Overview → 決策樹 → Step 1 → Step 2
- 適用: 有固定順序的任務
### 任務菜單型 Task-based
- 結構: Overview → Quick start → Task 1 → Task 2
- 適用: 同一領域多種操作
### 規範型 Reference/Guidelines
- 結構: Overview → Guidelines → Specifications → Usage
- 適用: 品牌規範、代碼風格
### 能力清單型 Capabilities-based
- 結構: Overview → Core capabilities → 1, 2, 3
- 適用: 綜合性系統能力
## 五、漸進式披露（Progressive Disclosure）
### 核心原則
主文件控制在 500 行以內，詳細內容按需加載。
### 文件組織
```
my-skill/
├── SKILL.md          # 主文件：概覽和導航（≤500行）
├── REFERENCE.md      # 詳細參考（按需加載）
├── EXAMPLES.md       # 使用示例（按需加載）
└── scripts/
    ├── helper.py     # 工具腳本（執行，不讀取）
    └── validate.py   # 驗證腳本
```
### 重要規則
- 引用保持一層深度，避免嵌套
- 超過 100 行的參考文件要加目錄
- 腳本用於執行，不用於閲讀
## 六、高級技巧（來自官方設計類 Skill 拆解）
### 提高天花板
不是"完成任務"，而是"創建體系"。不要說幫我畫一張圖，而是說創建一個美學流派加對應的算法體系。
### 雙階段結構，理念先行
- 階段 1: Philosophy/Design（用 md 文件）
- 階段 2: Implementation（用代碼或輸出）
強制抽象層在前，避免模型直接掉進"調參數"的局部最優。
### 用問句或維度約束內容
比如 "To capture the ESSENCE, express how this manifests through" 然後列出:
- Computational processes and mathematical relationships
- Noise functions and randomness patterns
- Particle behaviors and field dynamics
每個點都是美學語言加技術對象，方便映射成代碼。
### 把"匠心審美"寫成 checklist
比如 CRITICAL GUIDELINES 包含:
- 必須使用 seed 保證可復現
- 參數以"物理屬性"為中心（數量、尺度、概率）
- 不要 overlap、保留邊距、檢查所有對齊
把抽象審美拆成具象行為。
### 最後一輪精修做減法不做加法
如果下一步的本能是"多加一個 icon 或多加一層特效"，請暫停。問自己有沒有可以刪掉的東西。只允許修改已有元素的位置、間距、權重和顏色。
## 七、工作流和反饋循環
### 複雜任務使用檢查清單
列出每個步驟:
- Step 1 Analyze: 運行 analyze.py
- Step 2 Create mapping: 編輯 config.json
- Step 3 Validate: 運行 validate.py
- Step 4 Execute: 運行 main.py
- Step 5 Verify output
### 實現反饋循環
1. 執行操作
2. 立即驗證: 運行 python scripts/validate.py
3. 如果驗證失敗: 查看錯誤信息 → 修復問題 → 再次驗證
4. 只有驗證通過後才繼續
## 八、CLAUDE.md vs SKILL.md
### 加載時機
- CLAUDE.md: 每次對話都加載
- SKILL.md: 按需激活
### 內容
- CLAUDE.md: 項目規範、命令、約束
- SKILL.md: 專業能力、工作流
### 長度
- CLAUDE.md: 保持精簡（只寫必要的護欄和規範）
- SKILL.md: 主文件控制在 500 行以內
### 定位
- CLAUDE.md: 項目的"憲法"
- SKILL.md: 專業的"能力模塊"
### 寫 CLAUDE.md 的技巧（來自社區經驗）
- 從護欄開始不是說明書，只在 Claude 容易出錯的地方添加說明
- 不要用 @ 引用詳細文檔，會使上下文臃腫
- 避免純否定約束，應該寫成"禁止 X，改用 Y"
- 只記錄 30% 以上工程師會用到的內容
## 九、常見問題
### Skill 不觸發怎麼辦
- 優化 description 加入具體觸發詞
- 使用強制評估 Hook（激活率 20% → 84%）
- 確保 description 用第三人稱
### 多個 Skill 衝突怎麼辦
讓每個 description 更具體，用不同的觸發詞區分。
### Skill 太長怎麼辦
使用漸進式披露，主文件控制在 500 行以內，詳細內容拆分到單獨文件。
## 十、快速創建流程
當用戶要求創建新 Skill 時，按以下步驟執行:
### Step 1: 需求澄清
向用戶確認:
- 這個 Skill 要解決什麼問題
- 典型使用場景是什麼
- 用戶會說什麼話來觸發它
- 期望的輸出是什麼
### Step 2: 選擇骨架模式
根據任務類型選擇:
- 有固定順序的任務 → 流程型 Workflow-based
- 同一領域多種操作 → 任務菜單型 Task-based
- 品牌規範或代碼風格 → 規範型 Reference/Guidelines
- 綜合性系統能力 → 能力清單型 Capabilities-based
### Step 3: 編寫元數據
- name: 小寫字母+連字符，簡短明確，反映核心功能
- description: 包含具體觸發詞，用第三人稱，說明"做什麼"+"什麼時候用"
### Step 4: 編寫正文
按選定的骨架模式組織內容:
- 使用 Markdown 標題建立層級結構
- 控制在 500 行以內
- 包含核心理念和原則
- 包含具體工作流程或步驟
- 包含質量檢查清單
- 包含觸發場景說明
### Step 5: 創建文件
創建目錄和文件:
- 路徑: .claude/skills/[skill-name]/SKILL.md
- 如果內容超過 500 行，拆分到 REFERENCE.md 或 EXAMPLES.md
### Step 6: 驗證
檢查清單:
- name 是否符合規範（小寫、連字符、64字符內）
- description 是否包含觸發詞
- description 是否用第三人稱
- 正文是否使用 Markdown 結構
- 正文是否控制在 500 行以內
- 是否包含質量檢查或驗證步驟
## 十一、Skill 模板
可直接套用的標準模板:
```
---
name: [skill-name]
description: [做什麼的技能]。當用戶[觸發場景1]、[觸發場景2]或提到[關鍵詞]時使用。[補充說明核心特點]。
---
# [Skill 名稱]
## 核心理念
[1-3 句話說明這個 Skill 的核心價值和設計哲學]
## 核心原則
1. [原則 1]: [簡要說明]
2. [原則 2]: [簡要說明]
3. [原則 3]: [簡要說明]
## 工作流程
### Step 1: [步驟名]
[具體做什麼，需要什麼輸入，產生什麼輸出]
### Step 2: [步驟名]
[具體做什麼，需要什麼輸入，產生什麼輸出]
### Step 3: [步驟名]
[具體做什麼，需要什麼輸入，產生什麼輸出]
## 質量檢查
完成前必須驗證:
- [檢查項 1]
- [檢查項 2]
- [檢查項 3]
## 常見誤區與正確做法
- [誤區 1] → [正確做法 1]
- [誤區 2] → [正確做法 2]
## 觸發場景
當用戶有以下需求時使用此技能:
- [場景 1]
- [場景 2]
- [場景 3]
```
## 十二、資源集合
- 官方最佳實踐: https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices
- 官方 Skills 示例: https://github.com/anthropics/skills
- Awesome Claude Skills: https://github.com/travisvn/awesome-claude-skills
- 激活率提升方案: https://scottspence.com/posts/how-to-make-claude-code-skills-activate-reliably
- 中文深度拆解: https://www.53ai.com/news/tishicikuangjia/2025120729304.html


Hello阿，我是CY-CHENYUE
你是不是也有過這種體驗：
刷到一條絕妙的提示詞，
激動地收藏，
心想"下次一定用"。
然後……就沒有然後了。
三個月後，
你的收藏夾裏躺着 N 條提示詞。
真正用過的，不超過 3 條。

提示詞收藏家的困境


我曾經是一個狂熱的提示詞收藏家。
看到"讓 AI 寫出爆款文案"的提示詞，收藏。
看到"一鍵生成周報"的提示詞，收藏。
看到"模擬頂級產品經理思考"的提示詞，收藏收藏收藏。
然後呢？

等我真正要用的時候，問題來了：
第一，找不到。
存在哪了？
筆記？收藏夾？聊天記錄？
還是那個"稍後再看"的文件夾？
第二，格式不對。
好不容易翻出來，
發現是給 ChatGPT 寫的，
Claude 用起來效果不一樣。
或者是個英文的，還得自己翻譯調整。
第三，懶得粘貼。
最要命的是，
每次都要打開筆記，複製，切換窗口，粘貼。
麻煩。算了，下次再用吧。
於是"下次"就變成了"永遠不"。
提示詞是一次性的，用完即棄，下次還得從頭來。

提示詞可以變成技能


直到我發現了 Claude Code 的 Skills 功能。
提示詞是"說一次"的話，Skill 是"教會 AI"的能力。
什麼意思？
普通提示詞，
你每次都要手動輸入。
就像每次見面都要重新自我介紹。
而 Skill，
是你提前"訓練"好的能力模塊。
AI 記住了，下次你一說相關的話，它自動調用。
不用複製，不用粘貼，說句話就觸發。
更妙的是：
網上那些你收藏的提示詞，都可以轉換成 Skill。
一次轉換，永久複用。


3 步轉換法


把一條提示詞變成 Skill，只需要 3 步。

Step 1：加元數據

在提示詞最前面，加上幾行描述信息：
插入圖片：元數據示例截圖
兩個字段：
name：技能名稱，小寫字母加連字符
description：做什麼 + 什麼時候用
重點是 description。
這決定了 AI 能不能"認出"該用這個技能。
訣竅：把觸發詞寫進去。
比如你的技能是寫週報的，description 就寫：
"生成工作週報。當用戶說'寫週報''總結本週工作''週報模板'時使用。"
這樣一來，你以後只要說"幫我寫週報"，AI 就自動調用這個技能。

Step 2：結構化

網上的提示詞，通常是一大段話。
這種一坨文字，AI 讀起來容易"走神"。
轉換時，用標題把內容拆分成結構：
有標題、有層級、有步驟。
AI 理解起來清晰得多。

Step 3：放對位置

把寫好的文件，保存到指定路徑：
.claude/skills/你的技能名/SKILL.md
一個技能一個文件夾，方便管理。
搞定。
你可能會問：AI 真的能識別出該用哪個技能嗎？
說實話，默認激活率只有 20% 左右。

一個提升激活率的小技巧


可以提到 80% 以上：
在 description 裏寫清楚觸發詞
壞的寫法：
"處理文檔"
好的寫法：
"從 PDF 提取文本和表格，填充表單，合併文檔。當用戶提到 PDF、表單、文檔提取時使用。"
越具體，AI 越容易匹配上。

提示詞用一次就沒了，但技能會沉澱下來。
與其做一個"提示詞收藏家"，
不如做一個"技能建造者"。
下次刷到好的提示詞，別光收藏。
花 5 分鐘，把它變成 Skill。

你會擁有一個專屬的 AI 能力庫。
那些收藏夾裏的N條提示詞？
是時候讓它們真正發揮作用了。

我整理了一份 Skill 轉換模板，包含：
標準 SKILL.md 文件結構
4 種常用骨架模式
description 高激活率寫法示例
發佈前自查清單
---
name: claude-code-skills-guide
description: Claude Code Skills 編寫完整指南。當需要創建、優化或調試 Skill 文件時使用。包含元數據規範、激活率優化、骨架模式、漸進式披露等最佳實踐。
---
# Claude Code Skills 編寫完整指南
基於 Anthropic 官方文檔 + Twitter/Reddit/Hacker News/中文社區高質量討論整理
## 一、Skills 核心概念
### Skills 是什麼
Skills 不是一次性 Prompt，而是"打包好的能力模塊"。它等待被模型發現、讀取並複用，解決"以後遇到這類事情該怎麼做"的問題。
### 三者區別
- Prompt: 一次性聊天指令，用完即棄
- Command: 常用的代碼片段，需要手動調用
- Skill: SOP 加工具包，可以自動激活並複用
## 二、SKILL.md 基本結構
文件開頭需要包含元數據塊，包括 name 和 description，然後是具體指令內容。
### 元數據規則
- name: 必需，限制 64 字符以內，只能用小寫字母、數字、連字符
- description: 必需，限制 1024 字符以內，必須說明"做什麼"和"什麼時候用"
- allowed-tools: 可選，用於限制可用工具
### 格式原則
SKILL.md 文件本身應使用 Markdown 結構（標題、列表）幫助 Claude 理解。Claude 對 XML 標籤有特殊識別能力，可用於包裹數據和指令。避免純文本長指令，會導致"指令漂移"（模型逐漸忽略前面的約束）。
### 格式要求
推薦使用:
- 標題標記（# ## ###）建立層級結構
- 列表符號（-）表示並列項
- 縮進表示層級關係
- 箭頭符號（→）表示流程或映射關係
- 冒號（:）表示鍵值對
- 代碼塊僅用於命令示例或配置示例
避免使用:
- 過多的加粗或斜體標記
- 表情符號
- 純裝飾性的分隔線
- 複雜的表格（簡單列表更易解析）
原則: 用 Markdown 建立結構幫助 AI 理解，但保持簡潔，不過度裝飾
## 三、description 是最關鍵的（決定激活率）
### 問題
Skills 默認激活率只有 20%（社區測試數據）
### 解決方案
**第一，具體加觸發詞**
- 壞的寫法: "處理文檔"
- 好的寫法: "從 PDF 提取文本和表格，填充表單，合併文檔。當處理 PDF 文件或用戶提到 PDF、表單、文檔提取時使用。"
**第二，用第三人稱**
因為 description 會注入系統提示。
- 好的寫法: Processes Excel files and generates reports
- 避免寫成: I can help you process Excel files
**第三，使用強制評估 Hook**
可以把激活率從 20% 提升到 84%。具體做法是在指令中加入強制評估序列:
- Step 1 EVALUATE: 對每個 skill 說明 YES/NO 及原因
- Step 2 ACTIVATE: 立即使用 Skill 工具
- Step 3 IMPLEMENT: 只在激活後執行
強調: 評估如果不激活就毫無價值。
## 四、四種 Skill 骨架模式
### 流程型 Workflow-based
- 結構: Overview → 決策樹 → Step 1 → Step 2
- 適用: 有固定順序的任務
### 任務菜單型 Task-based
- 結構: Overview → Quick start → Task 1 → Task 2
- 適用: 同一領域多種操作
### 規範型 Reference/Guidelines
- 結構: Overview → Guidelines → Specifications → Usage
- 適用: 品牌規範、代碼風格
### 能力清單型 Capabilities-based
- 結構: Overview → Core capabilities → 1, 2, 3
- 適用: 綜合性系統能力
## 五、漸進式披露（Progressive Disclosure）
### 核心原則
主文件控制在 500 行以內，詳細內容按需加載。
### 文件組織
```
my-skill/
├── SKILL.md          # 主文件：概覽和導航（≤500行）
├── REFERENCE.md      # 詳細參考（按需加載）
├── EXAMPLES.md       # 使用示例（按需加載）
└── scripts/
    ├── helper.py     # 工具腳本（執行，不讀取）
    └── validate.py   # 驗證腳本
```
### 重要規則
- 引用保持一層深度，避免嵌套
- 超過 100 行的參考文件要加目錄
- 腳本用於執行，不用於閲讀
## 六、高級技巧（來自官方設計類 Skill 拆解）
### 提高天花板
不是"完成任務"，而是"創建體系"。不要說幫我畫一張圖，而是說創建一個美學流派加對應的算法體系。
### 雙階段結構，理念先行
- 階段 1: Philosophy/Design（用 md 文件）
- 階段 2: Implementation（用代碼或輸出）
強制抽象層在前，避免模型直接掉進"調參數"的局部最優。
### 用問句或維度約束內容
比如 "To capture the ESSENCE, express how this manifests through" 然後列出:
- Computational processes and mathematical relationships
- Noise functions and randomness patterns
- Particle behaviors and field dynamics
每個點都是美學語言加技術對象，方便映射成代碼。
### 把"匠心審美"寫成 checklist
比如 CRITICAL GUIDELINES 包含:
- 必須使用 seed 保證可復現
- 參數以"物理屬性"為中心（數量、尺度、概率）
- 不要 overlap、保留邊距、檢查所有對齊
把抽象審美拆成具象行為。
### 最後一輪精修做減法不做加法
如果下一步的本能是"多加一個 icon 或多加一層特效"，請暫停。問自己有沒有可以刪掉的東西。只允許修改已有元素的位置、間距、權重和顏色。
## 七、工作流和反饋循環
### 複雜任務使用檢查清單
列出每個步驟:
- Step 1 Analyze: 運行 analyze.py
- Step 2 Create mapping: 編輯 config.json
- Step 3 Validate: 運行 validate.py
- Step 4 Execute: 運行 main.py
- Step 5 Verify output
### 實現反饋循環
1. 執行操作
2. 立即驗證: 運行 python scripts/validate.py
3. 如果驗證失敗: 查看錯誤信息 → 修復問題 → 再次驗證
4. 只有驗證通過後才繼續
## 八、CLAUDE.md vs SKILL.md
### 加載時機
- CLAUDE.md: 每次對話都加載
- SKILL.md: 按需激活
### 內容
- CLAUDE.md: 項目規範、命令、約束
- SKILL.md: 專業能力、工作流
### 長度
- CLAUDE.md: 保持精簡（只寫必要的護欄和規範）
- SKILL.md: 主文件控制在 500 行以內
### 定位
- CLAUDE.md: 項目的"憲法"
- SKILL.md: 專業的"能力模塊"
### 寫 CLAUDE.md 的技巧（來自社區經驗）
- 從護欄開始不是說明書，只在 Claude 容易出錯的地方添加說明
- 不要用 @ 引用詳細文檔，會使上下文臃腫
- 避免純否定約束，應該寫成"禁止 X，改用 Y"
- 只記錄 30% 以上工程師會用到的內容
## 九、常見問題
### Skill 不觸發怎麼辦
- 優化 description 加入具體觸發詞
- 使用強制評估 Hook（激活率 20% → 84%）
- 確保 description 用第三人稱
### 多個 Skill 衝突怎麼辦
讓每個 description 更具體，用不同的觸發詞區分。
### Skill 太長怎麼辦
使用漸進式披露，主文件控制在 500 行以內，詳細內容拆分到單獨文件。
## 十、快速創建流程
當用戶要求創建新 Skill 時，按以下步驟執行:
### Step 1: 需求澄清
向用戶確認:
- 這個 Skill 要解決什麼問題
- 典型使用場景是什麼
- 用戶會說什麼話來觸發它
- 期望的輸出是什麼
### Step 2: 選擇骨架模式
根據任務類型選擇:
- 有固定順序的任務 → 流程型 Workflow-based
- 同一領域多種操作 → 任務菜單型 Task-based
- 品牌規範或代碼風格 → 規範型 Reference/Guidelines
- 綜合性系統能力 → 能力清單型 Capabilities-based
### Step 3: 編寫元數據
- name: 小寫字母+連字符，簡短明確，反映核心功能
- description: 包含具體觸發詞，用第三人稱，說明"做什麼"+"什麼時候用"
### Step 4: 編寫正文
按選定的骨架模式組織內容:
- 使用 Markdown 標題建立層級結構
- 控制在 500 行以內
- 包含核心理念和原則
- 包含具體工作流程或步驟
- 包含質量檢查清單
- 包含觸發場景說明
### Step 5: 創建文件
創建目錄和文件:
- 路徑: .claude/skills/[skill-name]/SKILL.md
- 如果內容超過 500 行，拆分到 REFERENCE.md 或 EXAMPLES.md
### Step 6: 驗證
檢查清單:
- name 是否符合規範（小寫、連字符、64字符內）
- description 是否包含觸發詞
- description 是否用第三人稱
- 正文是否使用 Markdown 結構
- 正文是否控制在 500 行以內
- 是否包含質量檢查或驗證步驟
## 十一、Skill 模板
可直接套用的標準模板:
```
---
name: [skill-name]
description: [做什麼的技能]。當用戶[觸發場景1]、[觸發場景2]或提到[關鍵詞]時使用。[補充說明核心特點]。
---
# [Skill 名稱]
## 核心理念
[1-3 句話說明這個 Skill 的核心價值和設計哲學]
## 核心原則
1. [原則 1]: [簡要說明]
2. [原則 2]: [簡要說明]
3. [原則 3]: [簡要說明]
## 工作流程
### Step 1: [步驟名]
[具體做什麼，需要什麼輸入，產生什麼輸出]
### Step 2: [步驟名]
[具體做什麼，需要什麼輸入，產生什麼輸出]
### Step 3: [步驟名]
[具體做什麼，需要什麼輸入，產生什麼輸出]
## 質量檢查
完成前必須驗證:
- [檢查項 1]
- [檢查項 2]
- [檢查項 3]
## 常見誤區與正確做法
- [誤區 1] → [正確做法 1]
- [誤區 2] → [正確做法 2]
## 觸發場景
當用戶有以下需求時使用此技能:
- [場景 1]
- [場景 2]
- [場景 3]
```
## 十二、資源集合
- 官方最佳實踐: https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices
- 官方 Skills 示例: https://github.com/anthropics/skills
- Awesome Claude Skills: https://github.com/travisvn/awesome-claude-skills
- 激活率提升方案: https://scottspence.com/posts/how-to-make-claude-code-skills-activate-reliably
- 中文深度拆解: https://www.53ai.com/news/tishicikuangjia/2025120729304.html