@nyk_builderz：Claude Code 的 SKILL.md 讓你 15 分鐘內建置首個自動觸發 AI 工作流程。 Claude Code 的「skill」僅是個 Mar…

Claude Code 的 SKILL.md 讓你 15 分鐘內建置首個自動觸發 AI 工作流程。 Claude Code 的「skill」僅是個 Markdown 檔案，就能教會 Claude 處理先前無法完成的工作，或避免重複浪費時間的失敗模式；作者整合官方文件、熱門社群技能（如 96K stars 的 superpowers、20K stars 的 gstack）及自身 x-article-factory pipeline 經驗，彙整此完整指南，讓新手快速上手。 skill 的本質 skill 不是 plugin、框架或 API 整合，而是一個置於資料夾的 Markdown 檔案；當 Claude 遇到匹配 skill 描述的任務時，會自動載入並遵循指示，無需手動呼叫或額外提示。 與 commands 和 agents 的差異： commands 需使用者輸入 /command-name，手動觸發。 Agents 是獨立 context window 的專門子代理人格。 skills 監控對話，任務匹配即自動啟用，如本能反應。 作者強調，這差異關鍵：commands 如按鈕、agents 如專家、skills 如直覺。 SKILL.md 結構 每個 skill 置於專屬目錄，以 SKILL.md 為入口，包含 frontmatter 和指示兩部分。 範例（security-review skill）： ` --- name: security-review description: Comprehensive security audit. Use when reviewing code for vulnerabilities, before deployments, or when the user mentions security. allowed-tools: Read, Grep, Glob --- Analyze the codebase for security vulnerabilities: SQL injection and XSS risks Exposed credentials or secrets Insecure configurations Authentication gaps Report findings with severity ratings and specific fixes. Reference @DETAILED_GUIDE.md for our security standards. ` description 是核心，Claude 據此判斷是否啟用；模糊描述（如 "help with code"）會過度觸發，過窄（如 "only for Python 3.11 FastAPI handlers"）則永不啟用。最佳作法：描述觸發條件，而非 skill 本身，例如 "Use when reviewing code for vulnerabilities" 優於 "security review tool"。 5 分鐘建置首個 skill 作者示範最實用新手 skill：code-review，針對團隊常見問題檢查程式碼。 步驟： 建立目錄：mkdir -p .claude/skills/code-review 撰寫 SKILL.md： ` --- name: code-review description: Expert code reviewer. Use PROACTIVELY when reviewing PRs, checking for bugs, or before merging. allowed-tools: Read, Grep, Glob --- You are a senior code reviewer focused on correctness. When reviewing code: Flag bugs, not style issues Suggest specific fixes, not vague improvements Check for edge cases and error handling gaps Note performance concerns only at scale Output format: Critical (must fix) Warnings (should fix) Notes (consider) ` 重啟 Claude Code 或新開 session。 要求 Claude 審核程式碼，即自動載入 skill。 總計不到 5 分鐘，即有可運作 skill。 自動觸發的魔力（auto-invocation） skill 強大之處在於 Claude 讀取 frontmatter 的 description，自動判斷任務是否匹配，無需輸入 /code-review；例如處理 PR 時，因描述匹配而自動載入。 控制觸發方式： 精準 description："Use when the user asks to review a pull request or when checking code before merging" 只在 PR 審核觸發；"Use for code" 則無所不觸發。 allowed-tools 限制權限：security-review 只允許 Read、Grep、Glob，不得 Write 或 Edit，作為安全網。 paths 欄位範圍限制： ` --- paths: - "src/api/*/.ts" - "src/handlers/*/.ts" --- ` 如此，API conventions skill 只在 API 檔案觸發，test standards skill 只在測試檔案啟用。 附加模板與支援檔案 skill 可捆綁支援檔案，轉化為完整套件，而非單純提示。 目錄結構範例（.claude/skills/security-review/）： ` ├── SKILL.md ├── DETAILED_GUIDE.md 以 @ 參照的詳細指南 ├── templates/ │ └── security-report.md 輸出模板 └── examples/ └── good-review.md 範例輸出 ` 在指示中以 @FILENAME.md 參照，skill 啟用時自動載入。適用時機： SKILL.md 過長需拆分詳細指南。 需一致輸出模板。 提供「好範例」示範期望輸出。 不適用時：SKILL.md 少於 50 行，保持簡潔即可。 5 種新手 skill 類型 作者建議勿一開始建複雜多檔 skill，從以下入手，按日常痛點選擇，今晚即安裝一個。 Review skill：檢查特定程式碼問題，如上述範例。最易建置、立即價值最高。 Debugging skill：強制方法論 "reproduce → isolate → hypothesize → verify"，避免 Claude 的「猜測套用」循環產生新 bug。 Documentation skill：依團隊格式產生文件，提供模板讓 Claude 填入，確保一致性無需手動。 Test-first skill：強制先寫測試再實作，反轉預設「先寫程式碼、再補通過的測試」行為。 Deploy skill：執行部署檢查清單，包括 version bump、changelog、build、test、tag、push，自動化重複手動序列。 常見浪費時間錯誤 作者列出 5 大錯誤，強調避免以確保效率： 描述過廣：如 "help with coding" 匹配一切，造成每場 session 雜訊；須精準觸發條件。 指示過多：200 行 SKILL.md 耗 context 卻無相稱價值；50 行內說不清，拆為 SKILL.md + @DETAILED_GUIDE.md。 無範例：Claude 更遵從範例而非規則；特定輸出格式須示範，而非僅描述。 略過 allowed-tools：無限制，skill 可任意 Read、Write、Edit、執行；總指定最小必要工具。 先建多檔複雜 skill：單檔 skill 未熟練前勿加複雜；先掌握基礎。 結語與實踐建議 skill 非程式碼，而是 Markdown 書寫的行為合約；精準定義觸發、指示、輸出格式，越可靠 Claude 表現越佳。 起步：建一個 skill，測試 5 個真實任務，改善一項，再建下一個。個人 skill 放 ~/.claude…