Skill(技能)
又稱:技能 · agent skill · 技能包 · SKILL.md
一份打包好、可重複使用的能力:指示文件(這類任務怎麼做),加上選配的腳本與資源,Agent 需要時才載入。
你會在什麼時候遇到它
當你希望 Agent 學會「一套你自己的做事方法」,而不是每次重新解釋,就會用到它。新手卡住的地方幾乎從不是「怎麼寫技能」—— 寫一份 Markdown 誰都會;卡住的是「裝了兩百個技能,一個都沒被觸發」。發現與觸發才是難題,撰寫不是。
打個比方
像公司的操作手冊架:新人不用背,但要知道「做這類任務時去架上拿哪一本」。手冊寫得再好,書脊上的字看不懂、或根本不知道架上有這本,對他就等於不存在。
最小範例
skills/hk-stock-dd/
SKILL.md ← 何時用我(description)+ 怎麼做(正文)
scripts/ ← 選配:可執行腳本
references/ ← 選配:模板、檢查清單
載入方式(示意):
平常:上下文裡只有每個技能的一行 description(省 token)
命中:Agent 判斷任務相關 → 讀入整份 SKILL.md → 照著做注意兩段式:description 決定「會不會被想起」,正文決定「做得好不好」。多數失敗發生在第一段 —— description 裡沒有用戶會說的詞(尤其非英文),技能就永遠不會被觸發。
最常搞錯的地方
- 以為技能難在寫。難在觸發:Agent 靠 description 跟任務描述做匹配,你用自己的術語寫、用戶用他們的話說,兩邊對不上,寫得再好也不會被載入。
- 把技能當 prompt 模板全塞進系統提示。兩百個技能全文常駐會吃光上下文;技能的本質是延遲載入 —— 預設在場的只有一行簡介。