裝了 Skill 不會用？話術和拆任務這篇講透
整理版優先睇
學會點名、拆任務、用觸發詞，讓 Agent 穩定執行 Skill 流程
呢篇文章係畀已經裝咗 Skill 嘅用家，教你點樣用好佢。作者發現好多人裝完唔識用，或者用落成日出錯，所以集中講「點樣開口」同「點樣拆任務」。假設你識用 npx skills add，直接 focus 喺使用技巧——點名、觸發詞、拆對話、俾素材、用 @文件 錨定上下文呢啲實戰方法。
作者整理咗 12 條高頻技巧，涵蓋點名、觸發詞、拆對話、先約束輸出、俾素材、用 @文件、項目 Skill 優先、用戶規則寫「先讀 Skill」、長任務階段確認、腳本型 Skill、槽位思維、自檢清單。仲有四類話術模板同 Cursor、Claude Code 嘅平台特有用法。文章強調，Skill 用得順唔順，七成在於你點開口——點名、觸發詞、拆任務、@範例、階段確認。唔好囤積太多 Skill，活躍 5-8 個就夠，其餘需要時再開。
結論係：先揀 3 個最高頻場景練熟，比囤積 20 個 Skill 更有用。附錄有安裝指令同延伸閲讀，但重點始終係溝通技巧。
- 點名 Skill 比暗示更穩，直接講「用 xxx skill 做 yyy」，必要時手動附加。
- 拆任務：一次對話一條工作流，避免多個 Skill 搶上下文或中途漏步驟。
- 先約束輸出格式同路徑，再讓 Agent 發揮，例如指定輸出 Markdown、唔好 commit。
- 用 @文件 錨定項目規範（如 style-guide.md、SKILL.md），避免模型用泛化知識代替約定。
- 長任務用階段確認，每步 check 再繼續，避免中間崩潰要全盤重來。
強制走 Skill 話術模板
請使用 [skill 名] 完成以下任務，並嚴格按 SKILL.md 步驟執行：[具體需求]
Anthropic Skills 官方示例
包含 skill-creator、pdf、frontend-design 等官方 Skill 範例
Vercel find-skills 檢索工具
用 npx skills find 關鍵詞 搜尋同安裝 Skill
使用前提：兩件事決定成敗
先搞清楚兩點：description 決定「會不會加載」，模型睇 YAML 嘅 name + description，覺得相關先讀 SKILL.md 正文；正文決定「做得對不對」，觸發後按步驟、路徑、禁止項執行。
核心技巧：12 條實戰心法
以下係最常用嘅技巧，幫你穩定執行 Skill：
- 點名 Skill：直接講「用 technical-writer 寫 API 文檔」，比暗示更穩，Cursor 仲可以手動附加。
- 抄 Skill 裏嘅觸發詞：打開 SKILL.md 睇 description 同正文首段，用原文嘅 opt-in 詞（例如「PDF」「E2E」「落地頁」）提高命中率。
- 拆任務：一次對話只做一條工作流，例如文檔、畫圖、提交分開三個對話。
- 先約束輸出：喺 prompt 重複關鍵約束，例如「輸出 Markdown，放 docs/api/，唔好 commit」。
- 俾素材唔好淨俾題目：貼定大綱、接口定義、錯誤日誌，指明結構同語氣。
- 用 @文件 錨定上下文：喺 Cursor @docs/style-guide.md，將範圍同規範釘死。
- 項目 Skill 優先於個人：倉庫內 .cursor/skills/ 嘅規範，換機器都一致。
- 用戶規則寫「先讀 Skill」：例如「提到部署時，必須先讀 Deploy SKILL.md 再執行」。
話術與平台實戰技巧
唔同平台有唔同玩法，以下係對應嘅話術同技巧：
- Cursor 技巧：手動附加 Skill 到對話，適合重要交付；仲可以 @Skill 路徑、用 Rules 管通用原則、多 Agent 時分工唔帶多餘 Skill。
- Claude Code 技巧：更依賴 description 自動匹配，觸發詞要更明確；自然語言 + 技能名（例如「用 webapp-testing 寫 Playwright E2E」）；換 Skill 組合時開新 session。
常見踩坑同實例示範
好多問題其實係使用習慣搞出嚟，唔係安裝問題。以下係常見現象同解決方法：
- 「說了需求冇反應」→ 話太泛，未命中 description；解決：點名 Skill + 抄觸發詞。
- 「只做一半」→ 一輪任務塞太多；解決：拆對話，階段確認。
- 「輸出格式錯」→ 冇聲明模式分支；解決：寫明輸出格式、路徑、禁止項。
- 「同上次唔一樣」→ 冇 @ 範例或 Skill；解決：@ 標杆文檔或 SKILL.md。
- 「亂 commit」→ 禁止項被忽略；解決：prompt 再寫「唔好 commit」。
- 「腳本冇執行」→ 模型手寫代替；解決：明確要求按 scripts/ 執行。
三個實用示例：
- 1 技術文檔：用 technical-writer 寫 Webhook 接入指南，指定輸出到 docs/guides/webhook.md。
- 2 PDF 批處理：用 pdf skill 批量提取 invoices/ 下所有 PDF 嘅金額同日期，彙總 CSV。
- 3 工程交付：用 test-driven-development 先寫 failing test，再實現 parseToken()。
Skill 使用技巧：令 Agent 穩定跟你想要嘅流程
Skill 裝好咗，最難嘅通常係 用起來：講咗需求但係唔觸發、觸發咗又淨係做一半、多個 Skill 爭同一條對話。
這篇偏使用技巧——假設你已經識 npx skills add，重點講點樣講嘢、點樣拆任務、點樣喺 Cursor / Claude Code 入面將 Skill 用穩。搜索安裝淨係放喺文末附錄。
一、使用前淨係需要知道嘅兩件事
description 決定「會唔會加載」
模型會先睇 YAML 入面嘅name+description，覺得相關先會讀SKILL.md正文。你講嘢要對應呢啲關鍵詞。正文決定「做唔做得啱」
觸發之後跟住 Skill 入面嘅步驟、路徑、禁止項執行。Skill 寫得越具體，你就越省事。
裝太多 Skill，剩係元數據就佔曬上下文——日常活躍 5 至 8 個就夠，其餘需要嗰陣先開。
二、12 條高頻使用技巧
1. 指名道姓叫個 Skill，比暗示更穩陣
自動匹配會漏。直接講：
用 technical-writer 寫這份 API 文檔用 drawio skill 畫架構圖走 skill-creator 幫我封裝流程
喺 Cursor 入面仲可以 手動附加 Skill 到當前對話，等於強制行呢套 SOP。
2. 抄 Skill 入面嘅觸發詞
打開 SKILL.md 的 description 同埋正文第一段，入面通常會寫咗 opt-in 詞：
原話越接近 Skill 文檔，命中率越高。
3. 一次對話一條工作流程
一個 Skill 大概等於一條流水線。同一輪入面又要「寫文檔 + 畫架構圖 + 提交 PR + 修 CI」，模型好多時只係加載一個 Skill 或者中途漏咗步驟。
推薦拆法：
對話 A：technical-writer → 出 README / API 文檔
對話 B：git-commit skill → 單獨提交
對話 C：requesting-code-review → 單獨過一遍
4. 先約束輸出，再俾 Agent 發揮
Skill 通常會規定落盤路徑同格式。你喺 prompt 入面 重複關鍵約束，減少走偏：
按 technical-writer：
- 輸出 Markdown，放 docs/api/
- 含請求/響應示例表
- 不要 git commit
「唔好 commit」呢類否定約束同 Skill 入面嘅禁止項疊加，特別有用。
5. 俾素材，唔好淨係俾題目
Skill 流程入面成日有「讀素材 → 定結構 → 輸出」。你俾多一層，就少啲來回確認：
貼大綱、接口定義、錯誤日誌 指明「跟 docs/guides/onboarding.md同樣結構」講清楚讀者係邊個、篇幅、語氣
6. 用 @文件 錨定上下文
喺 Cursor 入面 @docs/style-guide.md、@.cursor/skills/team-deploy/SKILL.md 將範圍同規範釘死，避免模型用泛化知識代替項目約定。
7. 項目 Skill 覆蓋全局習慣
倉庫內 .cursor/skills/（例如團隊統一嘅 api-review、release-checklist）應該優先於個人全局 Skill。規範寫入倉庫，換機器、換同事都一致。
8. 用戶規則入面寫一句「先讀 Skill」
喺 Cursor Rules 或者 Claude 用戶規則加：
用戶提到部署 / 發佈 / 數據庫遷移時，必須先讀取對應嘅 SKILL.md 再執行，唔可以靠記憶省略步驟。
專治 undertrigger（應該用但係冇用）。
9. 長任務用「階段確認」
複雜 Skill（多步發佈、批量文檔）可以喺每階段收尾嗰陣講：
大綱 OK，繼續寫正文正文好了，再補代碼示例
避免一次過做到尾中間某步質量崩咗但係要成個重頭嚟過。
10. 腳本型 Skill：俾 Agent 行腳本，唔好重新寫
Skill 嘅 scripts/ 入面如果係校驗、打包、截圖，直接講：
按 Skill 跑 scripts/validate.sh，不要手寫替代命令
確定性步驟交俾腳本，比模型即興寫命令穩陣得多。
11. 槽位思維：同類淨係留一個
同類裝太多個，description 重疊 → 觸發錯亂或者上下文浪費。
12. 用完睇一眼「自檢清單」
成熟 Skill 文末通常有 checkbox（前置條件、輸出路徑、禁止項）。你可以主動講：
按 Skill 自檢清單過一遍再交付
比起事後自己 check 漏嘢更加省時間。
三、點樣講嘢：四類話術模板
A. 強制行 Skill
請使用 [skill 名] 完成以下任務，並嚴格按 SKILL.md 步驟執行：
[具體需求]
B. 指定輸出模式（Skill 入面成日有分支）
用 pdf skill：
- 任務：從這份合同 PDF 提取表格
- 輸出：Markdown 表格
- 不要改動原 PDF 文件
C. 參照範例
按 docs/templates/postmortem.md 的結構和語氣，
用 technical-writer 寫一份關於本次故障的覆盤。
D. 糾正偏差（中途走偏嘅時候）
停。重新讀取 .cursor/skills/xxx/SKILL.md，
從「運行驗證腳本」那一步繼續，前面生成的不要刪。
四、Cursor 使用技巧
| 手動附加 | |
| @Skill 路徑 | @.cursor/skills/webapp-testing/SKILL.md |
| Rules + Skill | |
| 多 Agent 嗰陣分工 | |
| 子流程點名 |
Cursor 最大嘅優勢係 可以強制附加——拿唔準自動匹配嗰陣，直接掛上。
五、Claude Code 使用技巧
| 自然語言 + 技能名 | 用 webapp-testing 給登錄頁寫 Playwright E2E |
| 新開對話 | |
| 驗證觸發 | SKILL.md 再動手 |
| 全局 vs 項目 | -g；團隊規範提交到倉庫 Skill 目錄 |
Claude Code 更加依賴 description 自動匹配，觸發詞要比 Cursor 更加明確。
六、使用中嘅踩坑（同安裝冇關）
@ | ||
scripts/ | ||
七、三個用法示例
示例 1：技術文檔
用 technical-writer：
主題：新版 Webhook 接入指南
讀者：已有 REST 經驗的後端
輸出：docs/guides/webhook.md，含鑑權與重試說明
示例 2：PDF 批處理
用 pdf skill 批量提取 invoices/ 下所有 PDF 的金額和日期，
彙總成 CSV，不要修改原文件。
示例 3：工程交付
用 test-driven-development：
先寫 failing test，再實現 parseToken()，
不要改無關文件。
寫喺最後
Skill 用得順唔順，七成在於你點樣開口：點名、觸發詞、拆任務、@ 範例、階段確認。
先揀 3 個最高頻場景練熟，比囤積 20 個 Skill 更加有用。裝同寫嘅嘢，需要嗰陣先查附錄。
覺得有用可以收藏；你有邊啲「一講就觸發」嘅句式，留言區分享。
附錄：搜索同安裝（需要嗰陣先睇）
npx skills find <關鍵詞>
npx skills add <owner/repo>@<skill-name> -y -g
裝完用 Skill 文檔入面嘅例句驗證一次。自己寫 Skill 可以睇 Anthropic Skills 倉庫。
延伸閲讀
Anthropic Skills（skill-creator、pdf、frontend-design 等官方示例） Vercel find-skills（技能檢索同安裝）
Skill 使用技巧：讓 Agent 穩定走你想要的流程
Skill 裝好了，最難的往往是 用起來：說了需求卻不觸發、觸發了又只做一半、多個 Skill 搶同一條對話。
這篇偏使用技巧——假設你已經會 npx skills add，重點講怎麼說話、怎麼拆任務、怎麼在 Cursor / Claude Code 裏把 Skill 用穩。搜索安裝只放在文末附錄。
一、使用前只需知道的兩件事
description 決定「會不會加載」
模型先看 YAML 裏的name+description，覺得相關才讀SKILL.md正文。你說話要對上這些關鍵詞。正文決定「做得對不對」
觸發後按 Skill 裏的步驟、路徑、禁止項執行。Skill 寫得越具體，你越省事。
裝太多 Skill，光元數據就占上下文——日常活躍 5～8 個足夠，其餘需要時再開。
二、12 條高頻使用技巧
1. 點名 Skill，比暗示更穩
自動匹配會漏。直接說：
用 technical-writer 寫這份 API 文檔用 drawio skill 畫架構圖走 skill-creator 幫我封裝流程
在 Cursor 裏還可以 手動附加 Skill 到當前對話，等於強制走這套 SOP。
2. 抄 Skill 裏的觸發詞
打開 SKILL.md 的 description 和正文首段，裏面往往寫了 opt-in 詞：
原話越接近 Skill 文檔，命中率越高。
3. 一次對話一條工作流
一個 Skill ≈ 一條流水線。同一輪裏又要「寫文檔 + 畫架構圖 + 提交 PR + 修 CI」，模型往往只加載一個 Skill 或中途丟步驟。
推薦拆法：
對話 A：technical-writer → 出 README / API 文檔
對話 B：git-commit skill → 單獨提交
對話 C：requesting-code-review → 單獨過一遍
4. 先約束輸出，再讓 Agent 發揮
Skill 常規定落盤路徑和格式。你在 prompt 裏 重複關鍵約束，減少跑偏：
按 technical-writer：
- 輸出 Markdown，放 docs/api/
- 含請求/響應示例表
- 不要 git commit
「不要 commit」這類否定約束和 Skill 裏的禁止項疊加，特別管用。
5. 給素材，別隻給題目
Skill 流程裏常有「讀素材 → 定結構 → 輸出」。你多給一層，少來回確認：
粘貼大綱、接口定義、錯誤日誌 指明「按 docs/guides/onboarding.md同樣結構」說清讀者是誰、篇幅、語氣
6. 用 @文件 錨定上下文
在 Cursor 裏 @docs/style-guide.md、@.cursor/skills/team-deploy/SKILL.md 把範圍和規範釘死，避免模型用泛化知識代替項目約定。
7. 項目 Skill 覆蓋全局習慣
倉庫內 .cursor/skills/（如團隊統一的 api-review、release-checklist）應優先於個人全局 Skill。規範寫進倉庫，換機器、換同事都一致。
8. 用戶規則裏寫一句「先讀 Skill」
在 Cursor Rules 或 Claude 用戶規則加：
用戶提到部署 / 發佈 / 數據庫遷移時，必須先讀取對應 SKILL.md 再執行，不得憑記憶省略步驟。
專治 undertrigger（該用不用）。
9. 長任務用「階段確認」
複雜 Skill（多步發佈、批量文檔）可在每階段收尾時說：
大綱 OK，繼續寫正文正文好了，再補代碼示例
避免一口氣到底中間某步質量崩了卻要全盤重來。
10. 腳本型 Skill：讓 Agent 跑腳本，別重寫
Skill 的 scripts/ 裏若是校驗、打包、截圖，直接說：
按 Skill 跑 scripts/validate.sh，不要手寫替代命令
確定性步驟交給腳本，比模型即興寫命令穩得多。
11. 槽位思維：同類只留一個
同類裝多個，description 重疊 → 觸發錯亂或上下文浪費。
12. 用完看一眼「自檢清單」
成熟 Skill 文末常有 checkbox（前置條件、輸出路徑、禁止項）。你可以主動說：
按 Skill 自檢清單過一遍再交付
比事後自己查漏省時間。
三、怎麼說話：四類話術模板
A. 強制走 Skill
請使用 [skill 名] 完成以下任務，並嚴格按 SKILL.md 步驟執行：
[具體需求]
B. 指定輸出模式（Skill 內常有分支）
用 pdf skill：
- 任務：從這份合同 PDF 提取表格
- 輸出：Markdown 表格
- 不要改動原 PDF 文件
C. 參照範例
按 docs/templates/postmortem.md 的結構和語氣，
用 technical-writer 寫一份關於本次故障的覆盤。
D. 糾偏（中途跑偏時）
停。重新讀取 .cursor/skills/xxx/SKILL.md，
從「運行驗證腳本」那一步繼續，前面生成的不要刪。
四、Cursor 使用技巧
| 手動附加 | |
| @Skill 路徑 | @.cursor/skills/webapp-testing/SKILL.md |
| Rules + Skill | |
| 多 Agent 時分工 | |
| 子流程點名 |
Cursor 的最大優勢是 可強制附加——拿不準自動匹配時，直接掛上。
五、Claude Code 使用技巧
| 自然語言 + 技能名 | 用 webapp-testing 給登錄頁寫 Playwright E2E |
| 新開對話 | |
| 驗證觸發 | SKILL.md 再動手 |
| 全局 vs 項目 | -g；團隊規範提交到倉庫 Skill 目錄 |
Claude Code 更依賴 description 自動匹配，觸發詞要比 Cursor 更明確。
六、使用中的踩坑（與安裝無關）
@ | ||
scripts/ | ||
七、三個用法示例
示例 1：技術文檔
用 technical-writer：
主題：新版 Webhook 接入指南
讀者：已有 REST 經驗的後端
輸出：docs/guides/webhook.md，含鑑權與重試說明
示例 2：PDF 批處理
用 pdf skill 批量提取 invoices/ 下所有 PDF 的金額和日期，
彙總成 CSV，不要修改原文件。
示例 3：工程交付
用 test-driven-development：
先寫 failing test，再實現 parseToken()，
不要改無關文件。
寫在最後
Skill 用得順不順，七成在你怎麼開口：點名、觸發詞、拆任務、@ 範例、階段確認。
先挑 3 個最高頻場景練熟，比囤積 20 個 Skill 更有用。裝和寫的事，需要時再查附錄。
覺得有用可以收藏；你有哪些「一說就觸發」的句式，留言區分享。
附錄：搜索與安裝（需要時再看）
npx skills find <關鍵詞>
npx skills add <owner/repo>@<skill-name> -y -g
裝完用 Skill 文檔裏的例句驗證一輪。自寫 Skill 見 Anthropic Skills 倉庫。
延伸閲讀
Anthropic Skills（skill-creator、pdf、frontend-design 等官方示例） Vercel find-skills（技能檢索與安裝）