08 · 迭代與維護
Skill 發出去只是開始。這一章講三件事：怎麼改、什麼時候拆、怎麼在團隊裡活下來。
讓 AI 幫你寫 Skill（正確姿勢）
模型很懂 Skill 該怎麼寫——它自己就是讀這個的。但"幫我寫個 Skill"這種要法效果一般，正確的做法是用兩個對話：
對話 A（教練）：幫你設計和改 Skill
對話 B（學生）：裝著這個 Skill，幹真實的活流程：
1. 先在對話 A 裡，用普通提示詞把一件事做對。
一來一回的過程中，你會自然地補充背景、糾正方向、說明偏好。注意你重複說了哪些話——那些就是該進 Skill 的東西。
2. 讓對話 A 把剛才這一段打包。
把我們剛才整理紀要的這套做法，寫成一個 Skill。
要包含：輸出結構、人名不補全的規則、拿不準標「待確認」的規則、
以及跑題內容怎麼歸類。
description 要覆蓋這幾種說法：整理紀要、理一下會議記錄、提取會議待辦。3. 讓它刪掉廢話。
把解釋性的內容全刪掉——不要解釋什麼是會議紀要、不要解釋為什麼要寫待辦。
只保留"我們這兒和別人不一樣"的部分。這一步很重要，AI 寫 Skill 最大的毛病就是太囉嗦：它會認真給你科普一遍常識。
4. 拿到對話 B 去用。 裝上 Skill，做真實的活，觀察它的行為。
5. 帶著觀察回到對話 A。
這是當前的 SKILL.md：【貼】
我用它處理一份記錄時，它還是把"劉總監"補成了全名。
Skill 裡明明寫了"人名沿用原文稱呼"。
分析：為什麼這條沒生效？給出最小的修改。它可能會建議：把這條挪到更靠前的位置、語氣改硬（"必須"而不是"儘量"）、或者在示例里加一個專門演示這一點的例子。
6. 改完再測，重複。
為什麼必須是兩個對話
在同一個對話裡"寫完 Skill 順便測一下"是無效的——它剛寫完，內容還在上下文裡，當然做得對。
必須開一個乾淨的對話，只裝 Skill，才能測出真實效果。這跟"自己出題自己判卷"是同一個道理。
三種典型的改法
觀察到問題之後，按這個順序試：
症狀：從來不觸發
改 description。 九成的情況都是這一條，見 04 章。
具體做法：把你實際說的那句話，原樣加進 description 的關鍵詞裡。
症狀：觸發了，但某條規矩總不生效
三個改法，從輕到重：
| 改法 | 怎麼做 |
|---|---|
| 挪位置 | 把這條規矩從"規則"列表的中間挪到最前面，或者挪到流程步驟裡 |
| 加硬度 | "儘量" → "必須"；"注意" → "不得" |
| 給例子 | 加一組 ❌/✅ 專門演示這一條。這個最有效 |
例子最有效的原因在提示詞篇 03 章：它模仿的是形，比理解規則更可靠。
症狀：不該觸發的時候觸發了
在 description 里加排除條款，並指明該用哪個：
description: ……仅用于会议类材料；整理个人工作流水用 weekly-report。什麼時候該拆
三個訊號：
訊號 1：正文超過幾百行。 常見建議是控制在 500 行以內。超了就往附件拆。
訊號 2：一個 Skill 在處理兩類不同的活。 比如"文件助手"既管紀要又管週報——那就該是兩個 Skill。一個 Skill 一件事，觸發才準，維護才清楚。
訊號 3：不同分支之間基本沒有重疊。 三種會議類型的模板完全不同，就把模板拆進附件，主檔案只留導航。
反過來也要警惕：拆太碎
五個 Skill 各自只有十行，而且經常要一起用——那就該合成一個。
判斷標準：你能不能一句話說清"什麼時候用這個"。 說不清就是切得不對。
別讓 Skill 過期
Skill 會爛掉，主要有三種爛法：
一、寫了會過期的內容
❌ 2026 年 6 月之前用舊模板，之後用新模板。三個月後沒人記得這句話還在。正確做法是只寫當前的做法，舊的收進一個摺疊的"歷史"小節，或者乾脆刪掉：
## 當前模板
【新模板】
<details>
<summary>舊模板（2026-06 起停用）</summary>
【舊模板】
</details>二、術語前後不一致
同一個東西，一會兒叫"待辦"，一會兒叫"任務"，一會兒叫"action item"。挑一個，全文統一。 不一致會讓它在解析你的規則時猶豫。
三、越改越長
每次出問題就往裡加一條規矩，半年後正文變成三十條。加規矩的同時要刪規矩——定期回頭看，從來沒生效過的、和別的重複的，刪掉。
每季度花二十分鐘做一次體檢：
- 跑一遍三個測試用例，看還過不過；
- 把正文從頭讀一遍，刪掉從沒起過作用的規矩；
- 檢查有沒有過期內容（舊模板、舊流程、舊的人名）；
- 術語掃一遍，統一。
比"等到有人抱怨了再改"省事得多。
在團隊裡怎麼活下來
一、放到能被 review 的地方。 跟程式碼放一起、或者放團隊共享盤裡。微信發一段文字過去，三個月後就是四個版本。
二、寫清楚"誰負責"。 每個 Skill 指定一個 owner。沒有 owner 的 Skill 一定會爛。
三、改動要有記錄。 至少在檔案末尾留一行"最近改了什麼、為什麼"。半年後你自己也想不起來某條奇怪的規矩是為了防什麼。
四、裝之前先看一眼。 這一條是安全提醒：
Skill 是可以指揮 AI 行動的
一個 Skill 裡的文字，就是給 AI 的指令。來路不明的 Skill，可能讓 AI 做出你沒預期的事——尤其是當 AI 手上有檔案讀寫、命令執行、外部連線這些能力的時候。
所以：只用你自己寫的，或者來源可信的。 從網上拿來的 Skill，裝之前把裡面所有檔案（包括附件和腳本）從頭讀一遍，看有沒有跟它宣稱的用途對不上的操作——比如一個"整理紀要"的 Skill 裡出現了往外發資料的步驟。
把它當成"在自己電腦上裝一個軟體"來對待，而不是"複製一段文本"。