zenbu-powers

全棧 Claude Code Plugin：內建 SessionStart hook 注入 orchestrator 心法，搭配完整的 Agent、Skill 與 MCP Server 設定。涵蓋 WordPress（外掛 / 主題 / Gutenberg / WooCommerce / REST API / Interactivity API / 效能優化）、React（Refine / Ant Design / TanStack Query）、Node.js / NestJS / TypeORM / Drizzle / Better Auth 後端、AIBDD（Cucumber / Gherkin / TDD）測試流程、Milestone Tracker（專案級任務追蹤管理 + UserPromptSubmit hook 自動注入 STATUS dashboard）。

zenbu-powers — Claude Code Plugin

為 zenbu org 量身打造的 Claude Code Plugin。內建 Orchestrator 心法注入、21 個全域 Agent、59 個全域 Skill，外加 agent-sets/ / skill-sets/ 條件載入資源（含 WordPress 全棧），覆蓋 WordPress、React / NestJS / Node.js 現代應用、AIBDD 行為驅動開發三大領域，讓 AI 工程師團隊從第一個 session 就知道如何分工。

兩層 Hook 架構：SessionStart 注心法、UserPromptSubmit 注 reflex（10 條交接規則）+ AIBDD 條件式 + Milestone Status 條件式注入。主窗口完成後直接交付用戶。AIBDD 三語言整合測試（TypeScript / PHP / C#）完整覆蓋。內建 Milestone Tracker 專案級任務追蹤管理，AI 開工前自動知道當前進度與下一步。

設計哲學

你（使用者）
    │
    ▼
Orchestrator（Claude 主窗口）
    │  分析需求、拆解子任務、整合報告
    ├──► Agent Team（平行或序列委派）
    │        ├── react-master          ← React / TSX 實作
    │        ├── nestjs-master         ← NestJS / TypeScript 實作
    │        ├── *-reviewer / security-reviewer ← 深度審查（opt-in：用戶喚醒）
    │        ├── ...（全域共 21 個）
    │        └── wordpress-master / wordpress-reviewer ← 經 /copy-sets 條件載入
    │
    └──► Skills（流程 / 知識 / Library 參考）
             ├── /brainstorming     ← 設計精進
             ├── /tdd-workflow      ← Red→Green→Refactor
             ├── /aibdd-*           ← AIBDD 全自動 BDD 套件
             └── ...（全域共 59 個，另有 skill-sets 條件載入）

兩層 Hook 架構讓「協調紀律」在第一輪 prompt 之前就到位：

SessionStart hook — session 啟動 / /clear / /compact 時注入 using-zenbu-powers 的完整 Orchestrator 心法（Agent 索引、Skill 快取、Red Flags、全域一致性守則）
UserPromptSubmit hook — 每次送 prompt 注入 reflex-dictionary 10 條反射規則；命中 BDD/TDD/AIBDD 觸發詞時加注 AIBDD dispatch 路由；cwd 內 specs/milestones/STATUS.md 存在時加注 Milestone Status dashboard

整套機制由 ZENBU_HOOKS_ENABLED=1 環境變數顯式啟用（opt-in，避免干擾未準備好的 user）。

整體運作流程

flowchart TD
    subgraph 啟動階段[Session 啟動]
        A[Session Start / /clear / /compact] --> B{ZENBU_HOOKS_<br>ENABLED=1?}
        B -- No --> C[Plugin 靜默：skill/agent 可用<br>但 hook 不注入]
        B -- Yes --> D[SessionStart hook]
        D --> E[注入 using-zenbu-powers<br>Orchestrator 心法]
    end

    subgraph 每輪Prompt[每輪 User Prompt]
        F[User 送出 prompt] --> G{Hook 啟用?}
        G -- Yes --> H[UserPromptSubmit hook]
        H --> I[注入 reflex-dictionary<br>10 條反射規則]
        I --> J{prompt 含 BDD/<br>TDD/AIBDD?}
        J -- Yes --> K[加注 AIBDD<br>dispatch 路由表]
        J -- No --> M{cwd 有 specs/<br>milestones/STATUS.md?}
        K --> M
        M -- Yes --> N[加注 MILESTONE_STATUS<br>head -40 + active doing/]
        M -- No --> L[Orchestrator 接手]
        N --> L
        G -- No --> L
    end

    subgraph 協調分派[Orchestrator 分派]
        L --> M{任務匹配<br>agent / skill?}
        M -- agent --> N[派 sub-agent<br>＠zenbu-powers:xxx]
        M -- skill --> O[呼叫 Skill<br>zenbu-powers:xxx]
        M -- 微小直接做 --> P[orchestrator 親處理]
        N --> Q[整合 sub-agent 回報]
        O --> Q
        P --> Q
        Q --> R{Hand-off 欄位<br>指定下一位?}
        R -- Yes --> N
        R -- No --> Z[完成 → 直接交付用戶]
    end

    style D fill:#e1f5ff
    style H fill:#e1f5ff

安裝方式

從 Marketplace 安裝

claude plugin marketplace add zenbuapps/zenbu-powers
claude plugin install zenbu-powers

從本地目錄安裝

claude plugin install ./zenbu-powers

更新 / 移除

claude plugin update zenbu-powers@zenbu-powers
claude plugin uninstall zenbu-powers

驗證安裝

claude plugin list   # 列出已安裝的 Plugin
/skills list         # 列出可用的 Skill
/agent               # 列出可用的 Agent

啟用 Hook（必要）

zenbu-powers 的核心紀律仰賴 hook 注入，預設不啟用。在 ~/.claude/settings.json 加：

{
  "env": {
    "ZENBU_HOOKS_ENABLED": "1"
  }
}

設定後重啟 session 即可。未啟用時，agents / skills 仍可手動呼叫，但 SessionStart / UserPromptSubmit hook 不會注入心法與 reflex。

Agents（21 個全域 + WordPress agent-set）

WordPress agent（wordpress-master、wordpress-reviewer）不在 plugin 全域常駐，已移至 agent-sets/wordpress/。偵測到 WordPress 專案時由 /copy-sets 條件複製進專案 .claude/agents/，複製後以無前綴名稱（@wordpress-master）調用。

React / Frontend

Agent	說明
`react-master`	React 18 / TypeScript，Refine、Ant Design、TanStack Query
`react-reviewer`	React 程式碼審查（opt-in：用戶顯式喚醒才上場；不在自動流程中）

NestJS / Node.js

Agent	說明
`nestjs-master`	NestJS 10+ / TypeScript，模組化架構、DI、Guards、TypeORM/Prisma
`nestjs-reviewer`	NestJS 程式碼審查（opt-in：用戶顯式喚醒才上場；不在自動流程中）
`nodejs-master`	Node.js 20+ / TypeScript，RESTful API、BullMQ、Zod、Prisma

架構 / 設計

Agent	說明
`planner`	複雜功能與重構的實作計畫設計師
`clarifier`	結構化需求訪談，輸出使用者故事與驗收標準
`ddd-architect`	DDD 重構規劃，識別 Code Smell、排序重構步驟
`tdd-coordinator`	接收 planner 計畫，強制執行 Red→Green→Refactor 迴圈

測試 / 品質 / 驗收

Agent	說明
`browser-tester`	git diff 驅動的瀏覽器模擬測試，錄製影片與截圖
`test-creator`	通用測試工程師，E2E + 整合測試完整覆蓋
`security-reviewer`	OWASP Top 10、WordPress XSS/SQL Injection/CSRF、依賴漏洞（opt-in：用戶顯式喚醒才上場；不在自動流程中。涉及 auth / payment / external-api 時強烈建議補派）

DevOps / CI

Agent	說明
`workflow-master`	GitHub Actions 製作、除錯、優化，支援 act 本地驗證
`conflict-resolver`	分析衝突分支意圖，規劃最佳解法後推回各分支

文件 / 知識管理

zenbu-powers — Claude Code Plugin

為 zenbu org 量身打造的 Claude Code Plugin。內建 Orchestrator 心法注入、21 個全域 Agent、59 個全域 Skill，外加 agent-sets/ / skill-sets/ 條件載入資源（含 WordPress 全棧），覆蓋 WordPress、React / NestJS / Node.js 現代應用、AIBDD 行為驅動開發三大領域，讓 AI 工程師團隊從第一個 session 就知道如何分工。

設計哲學

你（使用者）
    │
    ▼
Orchestrator（Claude 主窗口）
    │  分析需求、拆解子任務、整合報告
    ├──► Agent Team（平行或序列委派）
    │        ├── react-master          ← React / TSX 實作
    │        ├── nestjs-master         ← NestJS / TypeScript 實作
    │        ├── *-reviewer / security-reviewer ← 深度審查（opt-in：用戶喚醒）
    │        ├── ...（全域共 21 個）
    │        └── wordpress-master / wordpress-reviewer ← 經 /copy-sets 條件載入
    │
    └──► Skills（流程 / 知識 / Library 參考）
             ├── /brainstorming     ← 設計精進
             ├── /tdd-workflow      ← Red→Green→Refactor
             ├── /aibdd-*           ← AIBDD 全自動 BDD 套件
             └── ...（全域共 59 個，另有 skill-sets 條件載入）

兩層 Hook 架構讓「協調紀律」在第一輪 prompt 之前就到位：

SessionStart hook — session 啟動 / /clear / /compact 時注入 using-zenbu-powers 的完整 Orchestrator 心法（Agent 索引、Skill 快取、Red Flags、全域一致性守則）
UserPromptSubmit hook — 每次送 prompt 注入 reflex-dictionary 10 條反射規則；命中 BDD/TDD/AIBDD 觸發詞時加注 AIBDD dispatch 路由；cwd 內 specs/milestones/STATUS.md 存在時加注 Milestone Status dashboard

整套機制由 ZENBU_HOOKS_ENABLED=1 環境變數顯式啟用（opt-in，避免干擾未準備好的 user）。

整體運作流程

flowchart TD
    subgraph 啟動階段[Session 啟動]
        A[Session Start / /clear / /compact] --> B{ZENBU_HOOKS_<br>ENABLED=1?}
        B -- No --> C[Plugin 靜默：skill/agent 可用<br>但 hook 不注入]
        B -- Yes --> D[SessionStart hook]
        D --> E[注入 using-zenbu-powers<br>Orchestrator 心法]
    end

    subgraph 每輪Prompt[每輪 User Prompt]
        F[User 送出 prompt] --> G{Hook 啟用?}
        G -- Yes --> H[UserPromptSubmit hook]
        H --> I[注入 reflex-dictionary<br>10 條反射規則]
        I --> J{prompt 含 BDD/<br>TDD/AIBDD?}
        J -- Yes --> K[加注 AIBDD<br>dispatch 路由表]
        J -- No --> M{cwd 有 specs/<br>milestones/STATUS.md?}
        K --> M
        M -- Yes --> N[加注 MILESTONE_STATUS<br>head -40 + active doing/]
        M -- No --> L[Orchestrator 接手]
        N --> L
        G -- No --> L
    end

    subgraph 協調分派[Orchestrator 分派]
        L --> M{任務匹配<br>agent / skill?}
        M -- agent --> N[派 sub-agent<br>＠zenbu-powers:xxx]
        M -- skill --> O[呼叫 Skill<br>zenbu-powers:xxx]
        M -- 微小直接做 --> P[orchestrator 親處理]
        N --> Q[整合 sub-agent 回報]
        O --> Q
        P --> Q
        Q --> R{Hand-off 欄位<br>指定下一位?}
        R -- Yes --> N
        R -- No --> Z[完成 → 直接交付用戶]
    end

    style D fill:#e1f5ff
    style H fill:#e1f5ff

安裝方式

從 Marketplace 安裝

claude plugin marketplace add zenbuapps/zenbu-powers
claude plugin install zenbu-powers

從本地目錄安裝

claude plugin install ./zenbu-powers

更新 / 移除

claude plugin update zenbu-powers@zenbu-powers
claude plugin uninstall zenbu-powers

驗證安裝

claude plugin list   # 列出已安裝的 Plugin
/skills list         # 列出可用的 Skill
/agent               # 列出可用的 Agent

啟用 Hook（必要）

zenbu-powers 的核心紀律仰賴 hook 注入，預設不啟用。在 ~/.claude/settings.json 加：

{
  "env": {
    "ZENBU_HOOKS_ENABLED": "1"
  }
}

設定後重啟 session 即可。未啟用時，agents / skills 仍可手動呼叫，但 SessionStart / UserPromptSubmit hook 不會注入心法與 reflex。

Agents（21 個全域 + WordPress agent-set）

WordPress agent（wordpress-master、wordpress-reviewer）不在 plugin 全域常駐，已移至 agent-sets/wordpress/。偵測到 WordPress 專案時由 /copy-sets 條件複製進專案 .claude/agents/，複製後以無前綴名稱（@wordpress-master）調用。

React / Frontend

Agent	說明
`react-master`	React 18 / TypeScript，Refine、Ant Design、TanStack Query
`react-reviewer`	React 程式碼審查（opt-in：用戶顯式喚醒才上場；不在自動流程中）

NestJS / Node.js

Agent	說明
`nestjs-master`	NestJS 10+ / TypeScript，模組化架構、DI、Guards、TypeORM/Prisma
`nestjs-reviewer`	NestJS 程式碼審查（opt-in：用戶顯式喚醒才上場；不在自動流程中）
`nodejs-master`	Node.js 20+ / TypeScript，RESTful API、BullMQ、Zod、Prisma

架構 / 設計

Agent	說明
`planner`	複雜功能與重構的實作計畫設計師
`clarifier`	結構化需求訪談，輸出使用者故事與驗收標準
`ddd-architect`	DDD 重構規劃，識別 Code Smell、排序重構步驟
`tdd-coordinator`	接收 planner 計畫，強制執行 Red→Green→Refactor 迴圈

測試 / 品質 / 驗收

Agent	說明
`browser-tester`	git diff 驅動的瀏覽器模擬測試，錄製影片與截圖
`test-creator`	通用測試工程師，E2E + 整合測試完整覆蓋
`security-reviewer`	OWASP Top 10、WordPress XSS/SQL Injection/CSRF、依賴漏洞（opt-in：用戶顯式喚醒才上場；不在自動流程中。涉及 auth / payment / external-api 時強烈建議補派）

DevOps / CI

Agent	說明
`workflow-master`	GitHub Actions 製作、除錯、優化，支援 act 本地驗證
`conflict-resolver`	分析衝突分支意圖，規劃最佳解法後推回各分支

zenbu-powers

Popularity

Health & Quality

Confidence

What's Inside

README

zenbu-powers — Claude Code Plugin

設計哲學

整體運作流程

安裝方式

從 Marketplace 安裝

從本地目錄安裝

更新 / 移除

驗證安裝

啟用 Hook（必要）

Agents（21 個全域 + WordPress agent-set）

React / Frontend

NestJS / Node.js

架構 / 設計

測試 / 品質 / 驗收

DevOps / CI

文件 / 知識管理

Similar Plugins

wordpress-plugin-core

wordpress-plugin

wordpress-skills

create-wp-site

wordpress

superpowers-sage

zenbu-powers — Claude Code Plugin

設計哲學

整體運作流程

安裝方式

從 Marketplace 安裝

從本地目錄安裝

更新 / 移除

驗證安裝

啟用 Hook（必要）

Agents（21 個全域 + WordPress agent-set）

React / Frontend

NestJS / Node.js

架構 / 設計

測試 / 品質 / 驗收

DevOps / CI

文件 / 知識管理

Popularity

Health & Quality

Similar Plugins

wordpress-plugin-core

wordpress-plugin

wordpress-skills

create-wp-site

wordpress

superpowers-sage