feature-workflow

CREW — Claude Code Plugins

整合 Notion 與 Claude Code 的自訂 Plugin 集合，涵蓋 Bug 處理與功能開發的完整工作流。

快速安裝

# 安裝 Notion MCP Server（提供 Notion 讀寫能力）
claude plugin install notion

# 加入 Marketplace → 安裝（安裝後自動啟用）
claude plugin marketplace add mark22013333/crew && \
claude plugin install bug-workflow && \
claude plugin install feature-workflow

安裝後 Plugin 會自動啟用，重啟 Claude Code 後在專案目錄下執行 /bug-setup 和 /plan-setup 進行初始化。

可用 claude plugin list 確認狀態，確保 Plugin 顯示為 ✔ enabled。 若未自動啟用：claude plugin enable bug-workflow && claude plugin enable feature-workflow

---

完整工作流

從安裝到日常使用的完整流程：

flowchart TD
    subgraph Phase0["🔧 Phase 0：安裝（一次性）"]
        direction TB
        notion["claude plugin install notion"]
        crew["claude plugin marketplace add mark22013333/crew"]
        setup_bug["/bug-setup<br/><i>偵測/建立 Notion 資料庫</i>"]
        setup_plan["/plan-setup<br/><i>匯入共用 ID + Agent 安裝</i>"]
        notion --> crew --> setup_bug --> setup_plan
    end

    subgraph Phase1["📂 Phase 1：進入專案（每個新專案一次）"]
        direction TB
        cd["cd ~/project"]
        init["/init<br/><i>建立 CLAUDE.md</i>"]
        projAdd["/project-add<br/><i>偵測架構 + Notion + DB MCP</i>"]
        stack["/plan-stack<br/><i>自訂技術棧掃描規則</i>"]
        cd --> init --> projAdd --> stack

        style stack fill:#fff3cd,stroke:#ffc107
    end

    subgraph Phase2["🚀 Phase 2：日常使用"]
        direction TB
        bugFlow["/bug-start → /bug-update → /bug-close"]
        planFlow["/plan-start → /plan-spec → /plan-db → /plan-arch<br/>→ /plan-build → /plan-verify → /plan-review → /plan-close"]
    end

    Phase0 --> Phase1 --> Phase2

    style Phase0 fill:#e8f5e9,stroke:#4caf50
    style Phase1 fill:#e3f2fd,stroke:#2196f3
    style Phase2 fill:#fff3e0,stroke:#ff9800

/plan-stack 為可選步驟 — 若 /project-add 偵測到的技術棧屬於內建（如 spring-boot-jpa），可跳過。若專案使用非標準分層結構或內建定義不夠精確，建議執行。

---

Plugin 一覽

Bug Workflow

自動化 Bug 生命週期管理 — 建立、調查、結案、搜尋、復發處理。

flowchart TD
    discover["發現 Bug"]
    start["/bug-start<br/><i>建立 Notion 條目</i>"]
    update["/bug-update<br/><i>補充 Log、SQL、判斷</i>"]
    fix["修復並 commit"]
    close["/bug-close<br/><i>結案（diff → Notion → 知識庫）</i>"]
    reopen{上線後復發？}
    reopenCmd["/bug-update reopen<br/><i>重新開啟</i>"]

    discover --> start --> update --> fix --> close --> reopen
    reopen -- "是" --> reopenCmd --> update
    reopen -- "否" --> done(["完成"])

    style discover fill:#fee,stroke:#f66
    style done fill:#efe,stroke:#6c6

指令	說明
/bug-setup	首次設定引導
/bug-start <問題簡述>	建立 Bug 條目
/bug-update <內容>	更新調查資訊（Log、SQL、判斷）
/bug-update reopen <Bug>	重新開啟已結案 Bug
/bug-close	結案 + 同步知識庫
/project-add	偵測專案架構 + Notion 註冊 + DB MCP 安裝

詳細說明見 plugins/bug-workflow/README.md

Feature Workflow

功能開發全生命週期管理 — 本地規劃、Agent Teams 產生程式碼與審查、Chrome DevTools 驗收驗證、結案同步 Notion。

含 4 個 Opus Agent，在規格、DB、架構、程式碼產生階段提供專家級輸出。

flowchart TD
    setup["/plan-setup<br/><i>首次設定</i>"]
    stack["/plan-stack<br/><i>自訂技術棧（可選）</i>"]
    start["/plan-start<br/><i>建立 Notion + .spec/ + Git branch</i>"]
    plan["/plan-spec → /plan-db → /plan-arch<br/><i>本地規劃</i>"]
    build["/plan-build<br/><i>Agent Teams 產生程式碼</i>"]
    ide(["IDE 啟動 + Chrome 開啟頁面"])
    verify["/plan-verify<br/><i>chrome-cdp 驗收驗證</i>"]
    review["/plan-review<br/><i>Agent Teams 3 人審查</i>"]
    close["/plan-close<br/><i>批次同步 Notion</i>"]

    setup --> stack -.-> start --> plan --> build --> ide --> verify --> review --> close
    verify -- "❌ FAIL" --> build
    review -- "🔴 嚴重" --> build

    style setup fill:#f0f0f0,stroke:#999
    style stack fill:#fff3cd,stroke:#ffc107
    style ide fill:#fff3cd,stroke:#ffc107

指令	說明	Notion 呼叫
/plan-setup	首次設定引導（Notion 偵測 + Agent 安裝）	一次性
/plan-stack	偵測專案分層結構，建立自訂技術棧	0 次
/plan-start <任務簡述>	建立 Notion 條目 + .spec/ 目錄 + Git branch	2-3 次
/plan	完整規劃串接（自動依序 spec→db→arch）	0 次
/plan-spec	技術規格書	0 次
/plan-db	資料庫設計	0 次
/plan-arch	架構設計	0 次
/plan-build [--dry-run]	Agent Teams 最多 5 人產生程式碼（含 DB Engineer）	0 次
/plan-verify [--api-only]	chrome-devtools-mcp 或 cdp.mjs 驗證驗收條件	0 次
/plan-review [--quick]	Agent Teams 3 人審查（邏輯/品質/安全）	0 次
/plan-close	一次性批次同步到 Notion + 知識庫 + Git 提交	3-5 次
/plan-sync	手動中途同步（按需）	2-3 次
/plan-status	列出所有活躍任務	0 次

詳細說明見 plugins/feature-workflow/README.md

---

專案註冊（/project-add）

/project-add 是進入新專案的關鍵步驟，自動偵測專案架構並同步到 Notion。

專案類型自動偵測

flowchart LR
    scan["掃描專案結構"]
    check{{"kernel/ 存在？<br/>Gradle 多模組？<br/>中介軟體設定？"}}
    simple["🟢 簡單型<br/><i>單 WAR/JAR</i>"]
    product["🟠 產品型<br/><i>多模組 + kernel</i>"]

    scan --> check
    check -- "否" --> simple
    check -- "是" --> product