12 KiB

Raw Blame History

Claude Code 工具箱

用 Claude Code 從零到一打造產品的完整工作環境。包含 23 個 AI Agent、45 個指令、66 個技能知識庫。

前置需求

工具	用途	安裝方式
Claude Code CLI	核心 AI 助手	`npm install -g @anthropic-ai/claude-code`
Node.js ≥ 18	執行 MCP server 與腳本	nodejs.org 或 `brew install node`
Git	版本控制	`brew install git`（macOS 通常已內建）

以下為選用，依你的開發語言安裝：

工具	用途
Go	使用 `/go-build`、`/go-review`、`/go-test` 指令
Python 3	使用 `/python-review` 指令
PM2	使用 `/pm2` 服務管理指令（`npm install -g pm2`）

快速開始

# 1. 複製這個工具箱到你的專案
cp -r claude/ 你的專案/claude/

# 2. 安裝所有依賴（MCP server 等）
make install

# 3. 進入你的專案，啟動 Claude Code
cd 你的專案
claude

# 4. 在 Claude Code 裡輸入斜線指令開始工作
#    輸入 / 會看到所有可用指令

提示：第一次使用請先跑 make install，它會幫你裝好所有 MCP server 需要的 npm 套件。

專案結構

.claude/
├── CLAUDE.md              # 總開發規範（Claude 自動讀取）
├── agents/                # 23 個 AI Agent 定義
│   ├── architect.md       #   架構師
│   ├── planner.md         #   規劃師
│   ├── code-reviewer.md   #   程式碼審查
│   ├── tdd-guide.md       #   TDD 引導
│   ├── security-reviewer.md #  安全審查
│   ├── fin-*.md           #   金融分析系列（5 個）
│   └── pm-*.md            #   產品經理系列（4 個）
├── commands/              # 45 個斜線指令
│   ├── plan.md            #   /plan — 規劃
│   ├── tdd.md             #   /tdd — 測試驅動開發
│   ├── code-review.md     #   /code-review — 程式碼審查
│   ├── fin-*.md           #   /fin-* — 金融分析系列
│   ├── pm-*.md            #   /pm-* — 產品經理系列
│   └── ...                #   更多指令見下方總覽
├── skills/                # 66 個技能知識庫（Claude 自動參考）
│   ├── golang-clean-arch/ #   Go Clean Architecture
│   ├── tdd-workflow/      #   TDD 工作流程
│   └── ...                #   各語言/框架的最佳實踐
├── rules/                 # 各語言的編碼規範
│   ├── common/            #   通用規範
│   ├── golang/            #   Go 規範
│   ├── python/            #   Python 規範
│   ├── typescript/        #   TypeScript 規範
│   └── swift/             #   Swift 規範
└── mcp-configs/           # MCP Server 設定範本
    └── mcp-servers.json   #   可用的 MCP server 清單

Skills 不會出現在 / 選單裡，它們是背景知識，Claude 會在需要時自動參考。

指令總覽

在 Claude Code 裡輸入 / 就能看到所有指令。以下依用途分類：

🏗️ 規劃與架構

指令	說明
`/plan`	重述需求 → 風險評估 → 分步計劃。不會動程式碼，等你確認才開始
`/orchestrate`	串接多個 Agent 執行複雜任務（feature / bugfix / refactor / security）

💻 開發與測試

指令	說明
`/tdd`	測試驅動開發：先寫測試 → 實作 → 重構 → 確保 80%+ 覆蓋率
`/build-fix`	逐一修復建置/型別錯誤，一次一個，最小改動
`/code-review`	全面程式碼審查（安全、品質、效能）
`/verify`	一鍵驗證：建置 → 型別 → Lint → 測試 → 安全掃描
`/test-coverage`	分析覆蓋率缺口，自動補測試到 80%+
`/refactor-clean`	安全移除死碼，每步都跑測試驗證
`/e2e`	用 Playwright 產生並執行端對端測試

🐹 Go 專用

指令	說明
`/go-build`	修復 Go 建置錯誤、go vet 警告
`/go-review`	Go 程式碼審查（慣用寫法、並發安全、錯誤處理）
`/go-test`	Go TDD 工作流程（table-driven tests）

🐍 Python 專用

指令	說明
`/python-review`	Python 審查（PEP 8、型別提示、安全、慣用寫法）

💰 金融分析系列

指令	說明
`/fin-full`	完整金融分析（市場研究 → 估值 → 客戶 → 建模 → 戰略，輸出 7 份報告）
`/fin-research`	市場規模估算 + 競爭格局 + SWOT/波特五力
`/fin-valuation`	DCF 估值 + 可比公司分析 + 目標價推導
`/fin-customer`	客戶 Persona + 細分矩陣 + 旅程地圖
`/fin-model`	定價策略 + 單位經濟 + 3 年財務預測
`/fin-strategy`	GTM 策略 + 90 天行動計劃 + CEO 摘要
`/fin-screen`	量化選股篩選（基本面/技術面/籌碼面）

📋 產品經理系列

指令	說明
`/pm`	完整 PM 流程 → 輸出結構化 PRD
`/pm-research`	只做市場規模與競品研究
`/pm-user`	只做用戶痛點挖掘
`/pm-plan`	功能排序 + 旅程設計 + Roadmap
`/pm-edit`	修改/深化現有 PRD

🤖 多模型協作

指令	說明
`/multi-workflow`	完整多模型協作流程（Research → Plan → Execute → Review）
`/multi-plan`	多模型協作規劃
`/multi-execute`	多模型協作執行
`/multi-frontend`	前端開發（Gemini 主導）
`/multi-backend`	後端開發（Codex 主導）

🧠 學習與進化

指令	說明
`/learn`	從當前 session 提取可重用模式
`/learn-eval`	提取模式 + 品質自評 + 決定存放位置
`/skill-create`	分析 git 歷史，自動產生 SKILL.md
`/evolve`	將學到的 instinct 聚合成 skill/agent
`/instinct-status`	查看所有已學習的 instinct
`/instinct-import`	匯入 instinct
`/instinct-export`	匯出 instinct

🔧 工具與維護

指令	說明
`/update-codemaps`	產生/更新架構文件（token 精簡版）
`/update-docs`	從原始碼同步文件
`/sessions`	管理 session 歷史（列表/載入/別名）
`/checkpoint`	建立工作流程檢查點
`/setup-pm`	設定偏好的套件管理器
`/pm2`	自動偵測專案並產生 PM2 服務管理指令

從零到一：打造產品的完整流程

以下是用這套工具箱從一個想法變成可運行產品的完整步驟：

第一步：市場研究（你還只有一個模糊的想法）

你：/fin-research 我想做一個幫自由工作者管理發票的 SaaS

Claude 會產出市場規模估算、競爭格局分析、SWOT 分析。

第二步：用戶研究（確認真的有人需要）

你：/pm-user 自由工作者在發票管理上的痛點

Claude 會從公開管道挖掘真實用戶聲音，產出痛點清單。

第三步：產品規劃（決定要做什麼）

你：/pm 我想做一個幫自由工作者管理發票的 SaaS，
    目標台灣市場，3 個月 MVP，一人開發

Claude 會跑完整 PM 流程，產出結構化的 PRD（產品需求文件）。

第四步：架構規劃（決定怎麼做）

你：/plan 根據剛才的 PRD，規劃技術架構和實作步驟

planner agent 會產出分階段的實作計劃，等你確認才動手。

第五步：開始開發（寫程式）

你：/tdd 實作用戶註冊功能

Claude 會用 TDD 流程：先寫測試 → 實作 → 重構 → 確保覆蓋率。

第六步：程式碼審查

你：/code-review

全面審查安全性、程式碼品質、效能問題。

第七步：驗證一切正常

你：/verify

一鍵跑完建置、型別檢查、Lint、測試、安全掃描。

完整流程圖

想法 → /fin-research（市場研究）
     → /pm-user（用戶研究）
     → /pm（產品規劃 → PRD）
     → /plan（技術規劃）
     → /tdd（開發）
     → /code-review（審查）
     → /verify（驗證）
     → 部署 🚀

不一定要跑完所有步驟。如果你已經很清楚要做什麼，可以直接從 /plan 開始。

常用工作流程

日常開發

/plan 新增 XXX 功能          # 先規劃
/tdd 實作 XXX               # TDD 開發
/code-review                 # 審查
/verify                      # 驗證

修 Bug

/orchestrate bugfix "描述問題"  # 自動串接 planner → tdd → reviewer

重構

/refactor-clean              # 先清死碼
/orchestrate refactor "重構快取層"  # 架構師 → 審查 → TDD

Go 專案

/go-test 實作 user 模組      # Go TDD（自動套用 Clean Architecture）
/go-review                   # Go 程式碼審查
/go-build                    # 修建置錯誤

如何追加與擴充

新增指令（Command）

在 .claude/commands/ 建立 .md 檔，檔名就是指令名（my-cmd.md → /my-cmd）：

---
description: 這段會顯示在 / 選單裡
---

# 指令名稱

你希望 Claude 做什麼的詳細說明...

⚠️ 不支援子目錄，用前綴分組：fin-、pm-、go- 等。

新增 Agent

在 .claude/agents/ 建立 .md 檔：

---
name: my-agent
description: Agent 的職責描述
tools: ["Read", "Write", "Bash"]
model: sonnet
---

你是一個專精於 XXX 的專家...

新增 Skill（知識庫）

在 .claude/skills/ 建立目錄，裡面放 SKILL.md：

mkdir -p claude/skills/my-skill
# 然後編輯 claude/skills/my-skill/SKILL.md

Skills 支援子目錄，Claude 會自動發現。不會出現在 / 選單。

追加的最佳實踐

命名一致：用前綴分組（fin-、pm-、go-）
先寫 Command，再考慮 Agent：大多數需求用 Command 就夠了
Skill 放通用知識：架構規範、設計模式
Rule 放強制規範：編碼風格、安全要求
用 /learn 自動提取：做完事後跑 /learn，讓 Claude 自己提煉模式

MCP Server 說明

MCP（Model Context Protocol）Server 讓 Claude 能連接外部服務。

安裝

make install          # 安裝所有免費 MCP
make mcp-github       # 或單獨安裝

啟用

安裝後，將需要的 server 設定從 .claude/mcp-configs/mcp-servers.json 複製到 ~/.claude.json 的 mcpServers 區段。

可用清單

Server	用途	需要 API Key
context7	即時查詢最新技術文件	❌
github	GitHub PR/Issue 操作	✅
memory	跨 session 持久記憶	❌
sequential-thinking	鏈式推理	❌
magic	Magic UI 元件	❌
filesystem	檔案系統操作	❌
firecrawl	網頁爬取	✅
supabase	資料庫操作	✅
vercel	部署（HTTP，免安裝）	✅
cloudflare-*	文件/Workers/監控（HTTP，免安裝）	❌
clickhouse	分析查詢（HTTP，免安裝）	✅

建議同時啟用不超過 10 個，以免佔用太多 context window。

FAQ

Q：指令太多記不住？ 輸入 / 就會看到所有指令。最常用：/plan、/tdd、/code-review、/verify。

Q：Skills 和 Commands 差在哪？ Commands 是你主動輸入 /xxx 觸發的動作；Skills 是背景知識，Claude 需要時自動參考。

Q：Agent 和 Command 差在哪？ Agent 定義角色（身份、能力）；Command 定義動作（流程），可能呼叫多個 Agent。

Q：我只寫 Go，不需要其他語言的東西？ 不相關的指令不會影響你。專注用 /go-* 系列 + 通用的 /plan、/tdd、/verify。

Q：怎麼讓 Claude 記住我的偏好？ 編輯 .claude/CLAUDE.md，Claude 每次啟動都會自動讀取。

Q：中文版（.claude-zh）是什麼？ .claude-zh/ 是 .claude/ 的繁體中文翻譯版。想用中文版就把它改名為 .claude/（先備份原版）。

12 KiB Raw Blame History Unescape Escape