133 lines
4.7 KiB
Markdown
133 lines
4.7 KiB
Markdown
# Claude Code 工具箱
|
||
|
||
用 Claude Code 從零到一打造產品的完整工作環境。包含 23 個 AI Agent、45 個指令、66 個技能知識庫。
|
||
|
||
---
|
||
|
||
## 目錄
|
||
|
||
- [前置需求](#前置需求)
|
||
- [快速開始](#快速開始)
|
||
- [專案結構](#專案結構)
|
||
- [指令總覽](#指令總覽)
|
||
- [從零到一：打造產品的完整流程](#從零到一打造產品的完整流程)
|
||
- [常用工作流程](#常用工作流程)
|
||
- [如何追加與擴充](#如何追加與擴充)
|
||
- [MCP Server 說明](#mcp-server-說明)
|
||
- [FAQ](#faq)
|
||
|
||
---
|
||
|
||
## 前置需求
|
||
|
||
| 工具 | 用途 | 安裝方式 |
|
||
|------|------|----------|
|
||
| **Claude Code CLI** | 核心 AI 助手 | `npm install -g @anthropic-ai/claude-code` |
|
||
| **Node.js ≥ 18** | 執行 MCP server 與腳本 | [nodejs.org](https://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`） |
|
||
|
||
## 快速開始
|
||
|
||
```bash
|
||
# 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、型別提示、安全、慣用寫法） |
|
||
|