我的知識庫

用 Claude 做開發輔助：機制層全景

閱讀時間約 8 分鐘

把 Claude 當開發輔助工具，有六個獨立機制可以組合：CLAUDE.md（永久規則層）、Skills（可重用工作流程）、MCP connectors（外部工具整合）、Subagents（平行代理）、Hooks（生命週期自動化）、Plugins（打包與分發）。每個機制有獨立的作用範圍；搞清楚分工，才能在「現在這個問題用哪個工具」時不靠直覺猜。

六個機制的分工

CLAUDE.md — 永久規則層

每次 session 開始，Claude Code 會從當前目錄往上走訪整個目錄樹，把所有 CLAUDE.md 串接起來，作為對話的起點。它放的是長期靜態、每次都該遵守的東西：tech stack、build/test/lint 指令、命名慣例、絕對不能碰的邊界（「Never commit .env」）、project-specific 假設。

放得好的 CLAUDE.md 讓 AI 不需要每次重掃 codebase 就能輸出符合慣例的程式碼。放得差的（塞滿歷史決策、changelog、每個 bug 的修法）只是把 context 填滿低密度噪音。原則：只放「以後每次都要遵守」的規則，不放「曾經發生過的事」。

Skills（SKILL.md）— 可重用工作流程

Skills 是存放在 ~/.claude/skills/<name>/SKILL.md 的 Markdown 檔案，以斜線指令（/spec-driven-development、/planning-and-task-breakdown 等）調用。每個 skill 封裝一套特定工作流程的步驟與驗證清單：它不是一般的 prompt，而是「這個情境下，按照這個順序做這些事」的可重用程序。

目前本機已安裝約 36 個 skills，涵蓋從 Define（/interview-me、/spec-driven-development）到 Ship（/shipping-and-launch、/deprecation-and-migration）的完整開發生命週期。你不需要每次都記憶工作流程的每一步——skill 幫你記，你只需要知道「現在要用哪個」。

agent-skills-taste 群組 是一個把多個 skills 打包在一起的 plugin（見下節），其中的每個條目（如 agent-skills-taste:spec-driven-development）是指向對應 skill 的可調用入口。

MCP（Model Context Protocol）— 外部工具整合

MCP 是 Anthropic 在 2024 年 11 月推出的標準化工具整合協定，讓 AI 可以存取外部服務：資料庫、GitHub API、瀏覽器 DevTools、雲端儲存等。類比是「AI 的 USB-C」——統一介面，不同工具只要實作這個協定就能接進來。

在開發輔助的脈絡下，MCP 最常用於：

  • 直接查 DB schema（PostgreSQL MCP）：不需要貼 schema 給 AI，它自己查
  • 讀 GitHub issues/PRs（GitHub MCP）：把 issue 脈絡帶進 session
  • 即時 browser state（Chrome DevTools MCP）：看到 console error、network request，而不只是靜態程式碼

Subagents / Agent Teams — 平行代理與脈絡隔離

Subagent 是主 session 可以派發工作給它的子代理（2025 年 7 月上線），Agent Teams 是多個 subagent 並行的協作模式（2026 年 2 月）。

Subagent 最重要的兩個用途：

1. 防止 context 污染：用 Explore subagent 做大範圍 codebase 搜索，結果不直接塞進主 context，主 session 只拿到摘要。長 session 的 context 越來越滿是常見的 AI 品質下滑原因，subagent 是對抗這個的結構性解法。

2. 真正的平行工作：backend API 和 frontend 型別定義可以由兩個 subagent 同時進行，前提是先把 API contract（interface 定義）在 Specify 階段就確定好——這也是為什麼 api-and-interface-design 和 spec-driven-development 要在前面先跑。

Subagent 可以配合 isolation: 'worktree' 在獨立 git worktree 工作，避免並行 file edit 衝突。

Hooks — 生命週期自動化

Hooks 是在 Claude Code 事件觸發點自動執行的 shell script（2025 年 9 月上線）。事件點包括：

Hook 類型觸發時機典型用途
PreToolUse每次 Claude 執行工具前驗證閘門（拒絕危險操作）
PostToolUse每次工具執行後自動跑 lint / tsc / 測試
SessionStartsession 開始載入額外 context
SessionEndsession 結束記錄 session 摘要、trigger CI

Hooks 讓品質門從「希望 Claude 記得做」變成「機器強制執行」。例如：每次 Claude 修改 .ts 檔後，PostToolUse hook 自動跑 tsc --noEmit；型別錯誤立刻打回來，不會累積到 PR review 才發現。

Plugins — 打包與分發

Plugin 是把 skills + MCP server + hooks + subagent 定義打包成一個可安裝單元的機制（2025 年 10 月公測）。本機安裝的 agent-skills-taste 就是一個 plugin 範例：它把三十幾個 skills 整組發布，用 ccpi（Claude Code Plugin Installer）這類套件管理工具安裝。

對個人開發者而言，plugin 的主要用途是：

  • 把自己的 skill 組合分享給團隊
  • 安裝社群現成的工具組合（如全棧開發、Cloudflare Workers 開發的特定 skill 包）

Scheduled Tasks — 雲端 cron 代理

Scheduled Tasks 讓 Claude 在 Anthropic 的雲端基礎設施上，按 cron 排程自動執行 session。適合：每週 dependency audit、每天 security scan、定期生成報告。Prompt 應清楚定義「成功的樣子是什麼」和「結果放在哪」，因為這個模式沒有人在旁邊互動。

層次關係：誰先於誰

CLAUDE.md（永久規則）
    └── 每次 session 都載入，是所有機制的底層脈絡

Skills（可重用工作流程）
    └── 在 session 內調用，依賴 CLAUDE.md 提供的專案脈絡

MCP（外部工具）
    └── 讓 Skills 能存取外部資料（DB、GitHub、browser）

Subagents（平行 / 隔離）
    └── 主 session 派發工作，隔離 context，可並行

Hooks（自動執行）
    └── 在工具執行前後觸發，把品質門從手動變自動

Plugins（打包分發）
    └── 把上述全部打包，方便安裝與共享

可佐證事實 vs 主張

可佐證：

  • MCP 協定由 Anthropic 在 2024 年 11 月公開發布，有官方規格文件
  • Subagents、Hooks、Plugins 各有明確上線時間（Jul/Sep/Oct 2025），有 changelog 記錄
  • Skills 以 SKILL.md 格式存在本機 ~/.claude/skills/ 可直接驗證
  • agent-skills-taste plugin 包含本機可見的 skills，行為可實測

方法論主張（難以量化）：

  • 「CLAUDE.md 讓輸出品質提升 X%」沒有通用數字，效益高度依賴 CLAUDE.md 的寫法與任務類型
  • Hooks 的投資回報率因 repo 複雜度差異大，不是所有 repo 都值得設

延伸

關係圖譜

反向連結