Episode Details

你的 Claude Skill 為什麼不觸發？本文從 Skills vs Projects vs MCP 三工具定位出發，完整解說 description 的 pushy 寫法、5 種失敗診斷框架，以及跨對話 (session) 狀態管理。

⭐ 文章深度讀
整理了 description 三大規則、5 種失敗模式與完整診斷框架 → https://heymaibao.com/claude-skill-complete-guide/

⚡ 章節重點
開場：你的 Skill 為什麼沒有動 00:00
Skills、Projects、MCP，先搞清楚定位 01:00
Description 寫法：3 個規則讓它真的觸發 02:06
5 種失敗模式，學會這個等於學會除錯 02:59
從零建立：5 步驟走完整流程 05:27
Claude Code vs Desktop，先搞懂環境再動手 06:15

📝 懶人包
∙ Skills 不是知識庫，是指令手冊，讓 Claude 變成「訓練好的員工」。只要重複輸入同一段指令超過 3 次，就是建 Skill 的時機。

∙ Skill 的核心只有一個資料夾 + 一個 SKILL.md，但 description 欄位是最重要的一行，它決定 Skill 能否在對的時機觸發。

∙ 每個壞掉的 Skill 都屬於 5 種失敗模式之一 (不觸發、亂觸發、輸出偏移、邊緣案例崩潰、輸出過多)，學會診斷分類，修法就清楚了。

∙ 我的觀察：文章沒有強調的一件事是，Claude Code 和 Claude Desktop 的 Skill 部署體驗差異很大，選錯環境，Skill 寫得再好也可能跑不起來。非開發者建議先從 skill-creator meta-skill 入手。

📚 參考資料
hooeem，X 貼文 Claude Skills 完整課程
→ https://x.com/hooeem/status/2031755971265974632