10 · 十個坑
按"踩的人多少"排序。前三個佔了新手問題的一大半。
1. description 只寫了"做什麼"，沒寫"什麼時候用"
症狀：Skill 從來不觸發，你每次都得手動說"用那個紀要的規矩"。
原因：系統判斷要不要用它，看的就是這一句。少了"什麼時候用"，它沒有匹配依據。
修法：把你和同事真會說的那幾句話裡的關鍵詞全塞進去。測法見 04 章那個自測。
2. 把"這一次的材料"寫進了 Skill
症狀：做 B 專案的紀要，輸出裡冒出 A 專案的客戶名。
原因：你直接把調好的那條提示詞整個複製進去了，裡面還留著"明遠地產""會員小程式改版"。
修法：Skill 裡只留每次都一樣的東西。判斷方法在 05 章第 1 步：兩支筆圈一遍。
3. 正文里科普常識
症狀：正文寫了三頁，效果還不如你原來那條提示詞。
原因：一半篇幅在解釋"會議紀要是什麼""為什麼要寫待辦"。它知道。這些字擠掉了真正有用的內容。
修法：只寫"我們這兒和別人不一樣"的部分。寫完自問每一段："這句刪掉會怎樣？"沒影響就刪。
4. 只有禁止，沒有出路
症狀：寫了"不要編造人名"，它還是編。
原因：跟提示詞篇 06 章是同一個問題——你堵死了一條路，沒給新路。
修法：每個"不要"後面配一個動作。"不要補全人名" → "人名沿用原文稱呼；原文沒提到的人，寫「待確認」"。
5. 一個 Skill 幹兩件事
症狀：你的"文件助手"既管紀要又管週報，結果兩邊都觸發得不準，寫週報時套上了紀要的三塊結構。
原因：description 必須同時描述兩類活，就只能寫得很寬，寬了就誤觸發。
修法：一個 Skill 一件事。 判斷標準：你能不能用一句話說清"什麼時候用這個"。
6. 規矩堆到二十條
症狀：前幾條生效，中間幾條時靈時不靈。
原因：長列表裡靠中間的最容易被忽略——跟長材料讀漏是同一個機制。
修法：正文裡留最重要的五到八條；剩下的要麼刪，要麼移到附件，要麼想想是不是該拆成兩個 Skill。
7. 附件套附件
症狀：Skill 裡有一份很詳細的規範文件，但它明顯沒讀全。
原因：SKILL.md → A.md → B.md 這種巢狀引用，它可能只掃一眼 B 就走了，拿到的是殘缺資訊。
修法：所有附件都從主檔案直接指過去，只能一層深。 超過一百行的附件，開頭加一份小目錄。
8. 寫了會過期的內容
症狀：半年後 Skill 裡還寫著"7 月之前用舊模板"。
修法：只寫當前的做法。舊的收進摺疊區，或者刪掉。見 08 章。
9. 在同一個對話裡"寫完順便測一下"
症狀：自己測都過，一到真實使用就不行。
原因：剛寫完的內容還在上下文裡，它當然照做——這是自己出題自己判卷。
修法：開一個乾淨的新對話，只裝 Skill，用一句平常會說的話去觸發。這才是真實情況。
10. 裝來路不明的 Skill
症狀：AI 做了你沒預期的事。
原因：Skill 裡的文字就是給 AI 的指令。當 AI 手上有檔案讀寫、執行命令、連外部系統這些能力時，一個不懷好意的 Skill 能指揮它做很多事。
修法：只用自己寫的，或者來源可信的。第三方的 Skill，裝之前把所有檔案（正文、附件、腳本）從頭讀一遍，看有沒有跟宣稱用途對不上的操作。
把它當成在自己電腦上裝軟體來對待，而不是複製一段文本。
快速自檢
釋出一個新 Skill 之前，對著這張表過一遍：
- [ ] description 裡有"做什麼" 和 "什麼時候用"
- [ ] description 覆蓋了至少三種不同的說法
- [ ] （裝了三個以上 Skill 的話）有排除條款
- [ ] 正文裡沒有具體的客戶名 / 專案名 / 日期
- [ ] 正文裡沒有對常識的解釋
- [ ] 每條"不要"後面都跟了"那就……"
- [ ] 規矩不超過八條
- [ ] 附件引用只有一層深
- [ ] 有至少一組示例，且包含一個邊界情況
- [ ] 有一份可勾選的檢查清單
- [ ] 在新開的乾淨對話裡跑過三個用例
- [ ] 三個用例包括"不該觸發"那一個
這一篇的收口
十章可以壓成三句：
description 決定它會不會被用上——一半的功夫花這兒。
正文只寫"我們這兒不一樣"的部分——常識一個字都別寫。
先測出它會錯在哪，再寫剛好能修好的內容——不要憑想像寫說明書。
然後呢
你現在走完了三步：
| 你會了什麼 | |
|---|---|
| 入門篇 | 知道它是什麼、為什麼會忘會編、怎麼把一件事說清楚 |
| 提示詞篇 | 讓一條提示詞穩定、可驗收、能交接 |
| Skill 篇 | 把跑通的東西打包，一次寫好、反覆觸發、團隊共用 |
下一格是 Workflow——真實的活很少只有一步，你需要把幾個已經跑通的步驟串成一條流水線：每步能驗收、錯了知道停在哪。你現在寫的每一個 Skill，都是那條流水線上的一個節點。
不過別急著去。先把手上那一個 Skill 用滿兩週，觀察它在哪兒不聽話——那兩週學到的東西，比再讀十章都多。