好技能的標準

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

重複的工作才做成技能

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

一次性的問題、每天都在變的資訊，不要做成技能。一次性的事，把要求說清楚就夠了。見 把要求說清楚。

一個技能只做一件事

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

太寬	更好
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 的判斷力留給需要判斷的地方。見 技能怎麼寫。

保持簡短，細節移出去

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

放在工作發生的地方

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

每次出錯都改進它

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

檢查清單

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