---
name: prompt-to-skill
description: 把一個效果很好的提示詞或對話，轉成團隊可以共用、可重複使用的 SKILL.md：合格的名稱、說明用途與使用時機的描述、輸入、附判斷規則的編號步驟、輸出範本、完整範例與檢查項目，遵循 Agent Skills 格式。適用於有人說「把這個存成技能」「讓這個可以重複使用」「把我的提示詞變成技能」、想和團隊分享提示詞，或問怎麼為 Claude、ChatGPT 或程式設計代理撰寫 SKILL.md 時。
---

# 提示詞轉技能

好的提示詞只存在某個人的對話紀錄裡；技能則讓整個團隊都能得到相同的結果。Agent Skills 格式是一個含 SKILL.md 的資料夾：開頭是含 `name` 與 `description` 的 front matter，接著是指令。在任務符合之前，AI 只會讀名稱與描述，所以描述決定了這個技能會不會被用到，而本文只需要寫 AI 預設不會做的事。

## 適用情境

- 某個提示詞或對話產出了有人想再次得到的結果。
- 團隊裡好幾個人各自寫著同一個提示詞的不同版本。
- 把一份很長的「提示詞範本」文件，轉成 AI 能自行取用的形式。
- 不適用於一次性的問題，或 AI 用一行請求就已經做得很好的任務。

## 需要準備

- 提示詞，或效果很好的那段對話，包括過程中你給的修正。修正才是最有價值的部分。
- 1 到 2 個你滿意的輸出範例。
- 誰會使用這個技能、在哪些工具裡用。不知道的話，寫成任何 AI 都能用的版本，避免特定工具的功能。

## 步驟

1. **找出可重複使用的部分。** 把固定的部分（流程、格式、規則、你給過的修正）和每次都會變的部分（輸入）分開。會變的部分就成為「需要準備」。
2. **取名字。** 英文小寫字母、數字與連字號，64 個字元以內，與資料夾名稱相同；不含「claude」或「anthropic」。優先用它做的事命名：`weekly-client-report`、`processing-invoices`。避免含糊的名稱（`helper`、`utils`）。
3. **寫描述。** 用第三人稱，1,024 個字元以內，不用 XML 標籤。先說它做什麼，再寫「適用於……」（英文技能寫「Use when...」），並用使用者實際會輸入的詞（「會議重點」「後續追蹤」「會議紀錄」）。AI 就是拿這段文字來比對；含糊的描述（「協助處理文件」）永遠不會被觸發。
4. **寫步驟。** 編號，每步都有簡短名稱與具體規則。只保留會改變輸出的指令：你在對話中做的修正、門檻值、「如果 X，就做 Y」的判斷。刪掉 AI 本來就知道的說明。
5. **加上輸出範本與一個範例。** 一個用程式碼區塊包起來、含 [預留位置] 的範本，再加一組真實的輸入與完整輸出。一個具體範例教格式，比好幾段描述更有效。
6. **加上檢查項目。** 4 到 7 項 AI 回答前會執行、可以驗證的檢查（「每個待辦事項都有負責人」），而不是願望（「品質要高」）。
7. **用新的輸入測試。** 在新的對話中，用 3 個不同的真實輸入執行，其中一個是棘手的情況。把出錯的地方修進技能裡，再執行一次。本文控制在 500 行以內；此技能庫的技能以遠低於 200 行為目標。

## 輸出格式

````markdown
---
name: [lowercase-hyphenated-name]
description: [它做什麼，第三人稱]。適用於[情境與使用者會輸入的詞]時。
---

# [標題]

[1–3 句：好的輸出能達成什麼，以及背後的原則。]

## 適用情境
- [情境]
- 不適用於[它不該處理的相近任務]。

## 需要準備
- [輸入] — 缺少時，[問一次／繼續進行並標註「[假設]」]。

## 步驟
1. **[步驟名稱]。** [附判斷規則的具體指令。]

## 輸出格式
```markdown
[含 [預留位置] 的範本]
```

## 範例
**輸入：**[真實的輸入]
**輸出：**[完整輸出]

## 寄出前檢查
- [ ] [可驗證的檢查]
````

## 範例

**輸入：**「我一直把這段貼進 ChatGPT：『這是我和客戶通話的筆記。寫一封後續追蹤信：感謝對方、整理我們談定的事、列出附日期的下一步，400 字以內，不要用流行語，最後只問一個清楚的問題。』我通常還得提醒它用客戶自己的說法，而且不要自己編日期。」

**輸出：**

````markdown
---
name: call-follow-up-email
description: 根據零散的筆記，在客戶通話後撰寫簡短的後續追蹤信：致謝、整理談定的事、附負責人與日期的下一步，以及一個收尾問題，400 字以內。適用於有人提供通話筆記，要求寫後續追蹤信、重點整理信，或「寄一份摘要給他們」時。
---

# 通話後續追蹤信

後續追蹤信趁通話記憶猶新時確認談定的事，避免任何事走樣。內容要短，用客戶自己的說法，最後用一個推動進度的問題收尾。

## 適用情境
- 業務或客戶通話後，根據筆記或逐字稿撰寫。
- 不適用於寄給還沒談過話的人的開發信。

## 需要準備
- 通話筆記。如果下一步缺少日期，就寫「日期待確認」，不要自己編。
- 客戶的姓名與公司。

## 步驟
1. **只整理談定的事。** 對方的目標與用語，用客戶自己的說法。
2. **列出下一步。** 每一項附負責人與筆記中的日期，或寫「日期待確認」。
3. **用一個問題收尾。** 推動進度所需要的那一個答案。
4. **刪減到 400 字以內。** 不用流行語；一句話只講一件事。

## 輸出格式
```markdown
主旨：[公司] — [日期]通話後的下一步

[姓名] 您好：

謝謝您[具體的事]。整理一下，我們談定[1–2 行]。

下一步：
- [負責人]：[日期或「日期待確認」]前[事項]

[一個問題]？

[署名]
```

## 範例
**輸入：**「和港威的郭雅文通話。他們想縮短新客戶導入時間。談定進行 2 週的試行。我週五寄試行計畫。需要知道他們的管理員是誰。」
**輸出：**
主旨：港威 — 今天通話後的下一步
郭小姐您好：謝謝您為我說明貴公司的導入流程。整理一下，我們談定進行 2 週的試行，重點是縮短導入時間。
下一步：
- 我：週五前寄出試行計畫
- 港威：指定試行的管理員，日期待確認
請問我該把誰設為貴公司的管理員呢？

## 寄出前檢查
- [ ] 400 字以內。
- [ ] 每個日期都來自筆記，或寫「日期待確認」。
- [ ] 最後只有一個問題。
- [ ] 用的是客戶的說法，而不是我們的。
````

## 寄出前檢查

- [ ] 名稱是英文小寫加連字號，64 個字元以內，不含「claude」或「anthropic」。
- [ ] 描述使用第三人稱、說明它做什麼、包含「適用於」（英文技能為「Use when」），在 1,024 個字元以內且不含 XML 標籤。
- [ ] 原本對話中的每一項修正，都成為一個步驟或檢查項目。
- [ ] 技能有輸出範本與一個完整範例。
- [ ] 已用 3 個新的輸入測試，修正也已寫進技能。

## 常見錯誤

- 把提示詞原封不動複製進去。把你不得不給的提醒（「不要自己編日期」）變成步驟；這正是技能多出來的價值。
- 解釋 AI 早就知道的事（「電子郵件是一種訊息……」）。每一行都會占用脈絡；只留下會改變輸出的部分。
- 描述只說做什麼，沒說何時用。AI 無法挑選一個它對不上請求的技能。