建一個真正能用的 Claude Skill，從概念到部署完整指南

你的 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