# 好技能的標準

好技能每次都給出同樣正確的結果，不管是誰在用。下面這些習慣能幫你做到。

## 重複的工作才做成技能

一件事做過不止一次、以後還會做，步驟每次都應該一樣，或者別人也要照你的方式做，就值得做成技能。

一次性的問題、每天都在變的資訊，不要做成技能。一次性的事，把要求說清楚就夠了。見 [把要求說清楚](https://docs.micromeet.ai/zh-tw/guides/clear-instructions.md)。

## 一個技能只做一件事

只做一件事的技能，更容易描述、測試和修改。描述裡寫出「另外還……」時，考慮拆成兩個。

| 太寬 | 更好 |
|---|---|
| `finance` | `check-invoices`、`monthly-expense-report` |
| `website-helper` | `export-orders`、`update-stock-levels` |

## 描述寫給要求看，不是寫給技能看

AI 只靠描述來選技能。寫清楚做什麼、什麼時候用，用大家實際會打的字：

| 弱 | 強 |
|---|---|
| 「發票工具。」 | 「把供應商發票和約定價格表對一遍，列出對不上的專案。在要核對、檢查或對賬發票時使用。」 |
| 「做週報。」 | 「根據本週的工單和訂單寫運營週報。在要週報、每週更新或本週資料時使用。」 |

## 說清楚做完是什麼樣子

寫明產出、格式和存放位置。「一張表」太含糊；「一個 CSV，列為 date、supplier、amount、difference，存為 mismatches.csv」就清楚了。

## 把限制寫下來

告訴 AI 什麼不能做、什麼時候必須停下來問：

- 「只讀，絕不修改網站上的記錄。」
- 「超過 20 條失敗就停下彙報，不要繼續。」
- 「發給團隊以外的人之前先問。」

## 帶上檢查

給一個代表性的輸入和你預期的結果，再加一條 AI 能驗證的規則：「每個合計都等於各行之和」「輸出裡的每個編號都能在輸入裡找到」。AI 彙報前會用它自查，你也能用它判斷改動有沒有把技能改壞。

## 必須一模一樣的部分寫成腳本

計算、格式轉換、固定的一串呼叫，這些每次都必須完全相同的部分，寫進腳本。AI 的判斷力留給需要判斷的地方。見 [技能怎麼寫](https://docs.micromeet.ai/zh-tw/skills/skill-anatomy.md#腳本)。

## 保持簡短，細節移出去

`SKILL.md` 只寫做法。價格表、寫作規範、欄位清單這類長資料，放進技能資料夾裡的單獨檔案，在做法裡提一句（「用 references/prices.csv」）。AI 需要時會開啟。

## 放在工作發生的地方

- 某個專案的技能放進這個專案的工作區（`.agents/skills/`），開啟這個資料夾的人都用同一個技能。
- 個人習慣放在這臺電腦的技能裡
- 全機構通用的做法可以由機構發布，所有人都能用，更新自動送達

## 每次出錯都改進它

結果不對時，先在對話裡改對，再讓 AI 把這次糾正更新進技能。久而久之，技能會積累所有使用者的判斷。

## 檢查清單

- [ ] 只做一件事
- [ ] 描述寫了做什麼、什麼時候用，用的是使用者的話
- [ ] 寫明瞭產出、格式和位置
- [ ] 寫下了限制和停止條件
- [ ] 有代表性檢查
- [ ] 必須精確的步驟寫成了腳本
- [ ] 存在需要它的人找得到的地方
- [ ] 在新會話裡不提技能名測過