一套開箱即用的 Claude Code 開發配置模板 — 13 個 MECE Skills、5-Gate Git 品質管線、Tesla StatusLine。 複製到新專案,像駕駛員進倉一樣,直接啟動。
# 1. 複製到新專案
cp -r claude-Godzilla-z/.claude your-project/.claude
# 2. 設定 MCP(填入 API keys)
cp .mcp.json.linux.example .mcp.json # Linux
cp .mcp.json.windows.example .mcp.json # Windows
# 3. 啟動
claude預設 skills 只在當前專案內可用。若想讓所有專案都能呼叫某個 skill,可建立全域 symlink:
# 範例:把 sunnydata-architecture-review 開放給所有專案
ln -s "$(pwd)/.claude/skills/sunnydata-architecture-review" \
~/.claude/skills/sunnydata-architecture-review優點:檔案實體只在專案內(git 追得到、可隨專案版控),全域目錄只放捷徑 — 改一處兩邊同步。Windows 使用 mklink /D。
.claude/
├── rules/ (8) # 永遠生效的規則
├── skills/ (13) # 按需載入的領域知識(sunnydata-*)
├── agents/ (13) # 專業 Agent
├── commands/ (17) # Slash Commands
├── output-styles/ (16) # 產出格式
├── settings.json # 主設定
├── CLAUDE.md # 專案指令
├── statusline.sh # StatusLine(Windows)
└── statusline-linux.sh # StatusLine(Linux/WSL2)
每次對話自動生效,不需手動觸發。
| 規則 | 核心內容 |
|---|---|
| development-workflow | 先開分支再動 code、研究 → 規劃 → TDD → 審查 → 提交 |
| git-workflow | WHY/WHAT/IMPACT commit body、分支保護、PR 前置條件與品質標準、merge 策略 |
| coding-style | 不可變性、檔案 < 800 行、函式 < 50 行、命名慣例 |
| security | commit 前安全 checklist、秘密管理、依賴安全 |
| testing | 80%+ 覆蓋率、TDD 強制(RED-GREEN-IMPROVE) |
| performance | 模型選擇策略、Context Window 管理、平行任務 |
| patterns | Repository Pattern、API 信封格式、骨架專案策略 |
| subagent-context | 子代理產出持久化至 .claude/context/ |
依開發生命週期組織,統一 sunnydata- 前綴。按需載入。
| 階段 | Skill | 用途 |
|---|---|---|
| THINK+PLAN+DO | sunnydata-design | 探索意圖 → 撰寫計畫 → 依檢查點執行 |
| BUILD (API) | sunnydata-api-design | REST API 設計規範 |
| BUILD (UI) | sunnydata-shadcn-ui | shadcn/ui 元件管理 |
| BUILD+TEST | sunnydata-testing | TDD + Unit/Integration/E2E (Playwright) |
| VERIFY (安全) | sunnydata-security | OWASP 分類 + checklist + 語言特定實踐 |
| VERIFY (審查) | sunnydata-code-review | 驗證 → 發起 review → 消化回饋 |
| VERIFY (架構) | sunnydata-architecture-review | 三階段 smells → principles → fixes 架構級審查 |
| SHIP (基礎設施) | sunnydata-infrastructure | Docker + CI/CD + 部署策略 |
| SHIP (分支) | sunnydata-branch-lifecycle | worktree 建立 → commit 審計 → PR/merge 收尾 |
| DEBUG | sunnydata-debugging | 四階段結構化除錯 |
| RESEARCH | sunnydata-deep-research | 多來源深度研究 |
| ORCHESTRATE | sunnydata-parallel-agents | 獨立任務平行派發 |
| META | sunnydata-skill-authoring | 撰寫/驗證 SKILL.md |
本模板強制嚴謹的 git 協作流程,適用於開源專案和團隊協作。
GATE 1 分支確認 在 main 上?停。dirty?停。沒指定分支?停。
↓
GATE 2 Commit 品質 WHY/WHAT/IMPACT body、72 字元 subject、一 commit 一事
↓
GATE 3 歷史審計 merge 前逐條檢查 commit 品質
↓
GATE 4 PR Pre-flight 測試通過、self-review、無 debug 殘留、< 400 行
↓
GATE 5 PR 品質 Background/Changes/Impact/Test Plan
↓
Merge → 刪除遠端分支 → Done
main ──┬── feat/xxx ──── PR ──→ main
├── fix/yyy ──── PR ──→ main
└── chore/zzz ─── PR ──→ main
分支確認 → 研究 → 規劃 → TDD → 審查 → 提交 → PR
| 指令 | 用途 |
|---|---|
/task-init |
建立 WBS、分析複雜度 |
/task-next |
取下一個任務 |
/plan |
規劃實作步驟 |
/tdd |
Red-Green-Refactor |
/review-code |
程式碼審查 |
/verify |
全面驗證 |
/e2e |
Playwright E2E |
/build-fix |
修復建置錯誤 |
/task-status |
進度總覽 |
/time-log |
開發時間報表 |
/save-session |
儲存 session 狀態 |
🦁 Opus 4.6 │ ❄️ 26% │ project (main*) │ 15m │ $12.50
Tesla High-Contrast 主題。Linux 使用 statusline-linux.sh。
| 版本 | 日期 | 變更 |
|---|---|---|
| v5.1 | 2026-05-10 | 新增 sunnydata-architecture-review skill(三階段 smells/principles/fixes 流程+100 條行話分類索引)、README 加入全域 symlink 共用說明 |
| v5.0 | 2026-04-06 | MECE 重構 skills (23→12, sunnydata-)、Git 5-gate 工作流、WHY/WHAT/IMPACT commit 標準、PR pre-flight |
| v4.3 | 2026-03-24 | 時間追蹤、/time-log、StatusLine 持久化 |
| v4.2 | 2026-03-16 | 跨平台(Windows/Linux)、Agent 全 opus |
| v4.1 | 2026-03-16 | rules(7)、skills(8)、MCP(+2) |
| v4.0 | 2026-03-16 | 13 Agent、16 Commands、StatusLine |
MIT
