daniel.w
/
claude-code
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
claude-code/README.md

4.7 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、型別提示、安全、慣用寫法）