你已經會做一張會觸發的卡了。這單元再上一層:讓 skill 不偏題、不塞爆、不死掉,外加官方最佳實踐。每招都附一個能直接照抄的範例。
AI 很聰明,聰明會讓它自作主張。專業 skill 先畫好界線,再放它做事。
把不准做的事,寫在最前面
AI 常熱心過頭:你只要它整理資料,它順手寫了段程式、又回頭問你三個問題。禁令放最前面,它就直接動手。
只准用這幾樣工具
禁令列不完,白名單一翻就清楚。當任務「只該」做某幾件事,就把那幾件圈起來,其他一律不碰。
AI 的注意力像一張桌子,就那麼大。堆越多越分心、越容易漏。專業 skill 的功夫,一半在少放東西上桌。
給它地址,讓它自己去拿
長文整段貼進指令,那些字就永久佔住桌面。只給路徑,它要用才去讀,桌子留乾淨。
結果寫檔,只報一行狀態
整份成果原封不動回報,等於又把東西堆回桌上。寫進檔案、只回一行狀態,桌子就省下來。
模板與資料分開放
每次都把完整指令重抄一遍,又長又容易錯。固定的話寫成模板、會變的地方挖成洞,每次只填洞。
長流程最怕跑到一半斷掉,前功盡棄。專業 skill 做好兩件保命的事:斷了接得回去,壞了知道壞在哪。
情境 · 一口氣檢查 100 頁網站
叫 AI 一口氣檢查 100 頁網站,跑很久。跑到一半斷掉怎麼辦?專業 skill 靠這兩件事撐住。
每頁都用同一種說法回報「這頁過了沒」,主流程一看就懂,知道該往下還是重試。
把「做到第幾頁」記進一個檔。第 70 頁斷了,下次從 71 頁接,前面不用重來。
一句話記住:會報進度、進度存得住。這兩件事到齊,長任務才真的「斷得起、續得回」。其實還有第三招「先備份再覆寫」,你在 baoyu 負向防呆③ 已經學過,原理一樣,這裡不重複。
兩件事之一 · 每一步都用同一種說法回報
每頁回報的話都不一樣、夾雜雜訊,主流程根本看不懂哪頁過、哪頁掛了。約好「每頁回同一種說法」,它一眼就知道該繼續還是重試。
exit 0 代表成功、1 代表失敗。學員記觀念就夠。兩件事之二 · 記下做到哪,斷了能接回去
檢查到第 70 頁斷電,沒存檔就得整盤重來,前面 70 頁全白做。每頁更新一個進度檔,AI 讀它一眼就知道從 71 頁接著跑。
progress.json,也可記每步是完成、進行中還是還沒做。學員記觀念就夠。前面是實戰經驗,這段直接搬官方規範來掛保證。description、工具宣告、命名都有官方明文,照著做最安心。
官方掛保證的貼紙寫法
官方把 description 定位成「選卡成敗的關鍵」,並給了公式:前半句講功能,後半句用「Use when」帶出使用者真會說的情境,一律第三人稱。
進階用法 · 真實 frontmatter
這是 SearchFit 那支 SEO 稽核 agent 真實的開頭,用 tools 列出它只准動的工具。其實 skill 自己也能限制工具,只是欄位叫 allowed-tools。
allowed-tools、agent 用 tools。最小 skill 只要 name+description,要鎖工具再加欄位。兩種都能限制,別以為只有 agent。seo-audit、keyword-clustering,小寫、連字號、一看就知道在幹嘛。別叫 helper、utils、tools 這種看不出用途的名字。上線前對著抄一遍,帶得走
拿你手上的卡對著這張清單逐條打勾。前四組是實戰心法,最後一組是官方明文的硬規格。
helper/utils{{變數}} 分開