The Claude Skills Folder That Automates 90% of Workflow (Claude Skills 資料夾:自動化 90% 工作流的完整指令集)
原始來源與檔名:10個Claude自動化Skills.md
來源:[[@zodchiii]] / X (Twitter) — 2026-05-04
原始檔名:2026-05-05T093858+0800-The Claude Skills Folder That Automates 90% of Workflow (All Commands Included).md
NAPKIN | 餐巾紙
餐巾紙公式
Claude Code Custom Skill =
name+description+allowed-tools+ Prompt (YAML Frontmatter + Markdown)
不要再每次都手打 50 個字的 Prompt 了。透過在 .claude/skills/ 建立自訂指令,你可以將常用的程式碼審查、測試撰寫、PR 產生等工作流程封裝成 /review 這樣的一鍵指令,且 Claude 會根據上下文自動觸發它們。
一句話
這是一份極具實戰價值的 Claude Code 工具箱指南。作者分享了 10 個可以直接複製貼上的自訂指令 (Skills),涵蓋了從 Debug、重構、寫測試到安全掃描的完整開發生命週期。透過將這些 Markdown 檔案存入專案的
.claude/skills/資料夾,團隊可以瞬間統一同儕審查與代碼生成的標準。
餐巾紙草圖
[The Developer's Agentic Workflow]
Write Code
↓
/debug (Investigate issues without mutating)
↓
/test (Generate & run Vitest/Jest)
↓
/refactor (Clean up code, ensure tests pass)
↓
/security (Audit for secrets & vulnerabilities)
↓
/review (Lint & style check before PR)
↓
/commit (Generate Conventional Commits from git diff)
↓
/pr (Generate structured PR description)
ROUND 1: SKELETON | 骨架掃描
“這篇文章在說什麼”
- 核心問題: 多數開發者只會使用 Claude Code 內建的幾個基礎指令 (如
/compact,/clear),卻不知道如何利用自訂 Skills 來將繁瑣的日常工作流自動化。 - 核心答案: 透過在特定目錄中建立帶有 YAML Frontmatter 的 Markdown 檔案,可以自訂強大的 Slash Commands。作者提供了 10 個覆蓋日常開發的實戰指令碼。
- 論證結構: 教學與清單型 — 先解釋架構 (Commands vs Skills) 與實作方法,接著直接給出 10 個立即可用的 Prompt 範本,最後總結日常工作流的組合技。
章節骨架
- How custom commands work: 介紹
.claude/skills/的路徑規則與 YAML Frontmatter 設定。 - commands/ vs skills/: 解釋 2026 年 4 月更新後,Skills 為何取代了舊版的 Commands(支援自動觸發與工具限制)。
- The 10 commands: 提供 10 個指令的完整 Prompt (Review, Test, Commit, PR, Debug, Refactor, Docs, Migrate, Deploy-check, Security)。
- How to install: 說明如何透過 Git 將這套工具箱分享給整個團隊。
- The workflow: 展示如何將這 10 個指令串聯成一個完整的「Agentic 開發生命週期」。
ROUND 2: DISSECTION | 血肉解剖
“憑什麼這麼說”
核心論證鏈
- Prompt as Code (提示詞即代碼): 將 Prompt 寫在 Markdown 檔並進行版本控制,是保證 AI 輸出一致性的關鍵。透過
description欄位,Claude 甚至能在你未輸入/review時,主動提議執行 Review,這將 AI 從「被動工具」升級為「主動助理」。 - 最小權限原則 (Least Privilege): 舊版的 Custom Commands 沒有工具限制。新版的 Skills 透過
allowed-tools: Read, Grep, Glob, Bash(git diff *)限制了 Agent 只能讀取和比對,避免它在 Review 階段自作主張修改代碼。 - 流程的標準化: 將「如何寫 PR 描述」與「如何做 Security Scan」寫成 Skill,意味著整個工程團隊將自動遵守同一套最高標準的 SOP,徹底消除了人工 Review 的盲點與疲勞。
關鍵證據
- 指令設計的細節:
- 在
/test指令中,強制要求 “Find existing test directory, read 1-2 existing tests” 以確保風格一致。 - 在
/refactor中,強制要求 “Run tests after EACH step” 並禁止改變函式簽章。 - 這些都不是隨意的 prompt,而是資深工程師的血淚經驗總結。
- 在
隱形假設
- 假設專案已經具備了完善的自動化測試環境 (如
npm test) 與靜態分析工具。如果專案連跑測試的腳本都沒有,/test和/refactor的價值將大打折扣。 - 這些 Skills 的有效性高度依賴於底層 Claude 模型的理解與工具調用 (Tool calling) 能力的穩定性。
邊界條件
- 對於極度大型的 Monorepo,
/security或/review如果直接執行全域掃描,可能會耗盡 Context Window 或是產生過高 Token 費用。這時需要依賴命令列參數 (如$ARGUMENTS) 來限定掃描範圍。
ROUND 3: SOUL | 靈魂提取
“還能怎麼用”
- 知識連結: 本文具體展示了《What Apple’s Leaked CLAUDE.md Teaches Us》以及《Anatomy of Agent SKILLS》中的實踐。將團隊的最佳實踐 (Best Practices) 封裝為可執行的 Agent Skills,是 Software 3.0 時代工程團隊的標準配備。
- 深層洞見: 開發者不再只是寫代碼,而是在編排 Agent 的工作流。 從敲打數百行代碼,到連續輸入
/debug -> /test -> /refactor -> /commit,程式設計的抽象層級再次被拉高了。 - 行動呼籲:
- 不要遲疑,立刻在你的主機上建立
~/.claude/skills/目錄,並把/commit和/pr這兩個最不傷腦筋卻最耗時的指令加進去。 - 下次團隊內有人抱怨「PR 描述寫得很隨便」時,不要去修改規範文件,去修改
.claude/skills/pr/SKILL.md,然後 Push 到 Repo 裡。
- 不要遲疑,立刻在你的主機上建立
Agent Skills Automation (Architectural Deep Dive)
前言/背景
隨著 Claude Code 將 Custom Commands 升級為 Skills 系統,Agentic CLI 的實用性迎來了爆發。本文作者分享了 10 個精心設計的實戰 Skills,將程式碼開發中除錯、測試、重構到提交的繁瑣流程完全自動化。這不僅是一份工具清單,更是「如何撰寫高品質 Agent Prompt」的最佳範本。
章節詳細總結
The Architecture of a Skill
一個合格的 Skill 包含三個要素:
- 觸發器 (
description): 寫給 LLM 看的敘述,讓模型知道「何時應該自動推薦這個技能」。 - 邊界控制 (
allowed-tools): 強制約束模型只能使用特定工具(例如只准讀取與執行git,不准修改檔案),確保安全性。 - 執行邏輯 (Markdown Body): 採用條列式的標準作業程序 (SOP),例如要求在重構前必先跑測試。
10 個核心實踐 (The 10 Commands)
/review: 限定讀取權限,專注尋找 Bug、資安與效能問題。/test: 強制模型先閱讀既有測試以模仿風格,並在生成後自動執行。/commit: 自動從git diff生成符合 Conventional Commits 規範的訊息。/pr: 讀取 commits 與 diff,自動產生具備 What/Why/Changes 的標準 PR 描述。/debug: 調查模式。強制要求「先診斷、不修改」,找出 Root Cause。/refactor: 安全重構。嚴格限制「每改一步跑一次測試」,禁止改變外部行為。/docs: 根據檔案類型自動生成 JSDoc 或 README。/migrate: 確保資料庫遷移檔包含 UP/DOWN 邏輯,並遵守專案命名規範。/deploy-check: 部署前檢查清單(Type check, Lint, Test, 檢查是否殘留 console.log)。/security: 資安稽核。掃描 Hardcoded secrets 與常見漏洞 (OWASP)。
總結與結論
- 架構洞察 1 (Skills as Executable Culture): 過去,團隊的 Coding Standard 寫在沒人看的 Wiki 裡。現在,透過將
.claude/skills/納入 Git 版控,團隊的標準變成了「可執行的強制約束」。 - 架構洞察 2 (State Machine via Commands): 這 10 個指令實質上建構了一個開發狀態機 (State Machine)。工程師只需負責定義初始狀態與審核,其餘的狀態轉換(開發 -> 測試 -> 審查 -> 提交)皆由對應的 Agent Skill 自動推進。
- 架構洞察 3 (Context-Aware Auto-invocation): 新版 Skills 最強大的設計在於
description的運用。模型會持續背景掃描使用者的意圖,當發現你在查閱 git log 時,主動推薦/pr。這種「隱形助理」的體驗,是 Agent Native CLI 未來發展的黃金標準。