AI software team for Claude Code - 138 agents, 295 skills, 73 hooks. Self-learning, multi-agent swarm, autonomous skill evolution.

vibecosystem – 基於 Claude Code 建構的 AI 軟體團隊

是什麼 – vibecosystem 是一個打包集合，將單一助手的 Claude Code 環境轉變為由 138 個專業代理、296 個可重用的「技能」、74 個 TypeScript 鈎子和 20 條行為規則組成的 自我組織團隊。一行安裝後，代理將跨五個開發階段（規劃 → 程式碼 → 審查 → 測試 → 學習）協作，您只需向 Claude Code 提出「新增功能」請求，系統便會自動處理設計、實作、安全審查、測試與事後學習，無需進一步設定。

核心概念

概念	作用
代理	以 Markdown 定義的提示，擔任專業角色（如 `frontend-dev`、`security-reviewer`、`graphql-expert`）。共提供 138 個代理。
技能	提示片段（共 296 個），用於捕獲可重用的知識，如 TDD 模式、Kubernetes 清單、合規檢查、行銷策略等。
鈎子	74 個 TypeScript 傳感器，用於觀察 Claude Code 工具呼叫、注入上下文並觸發代理（如 compiler-in-loop、error-broadcast）。根據所選設定檔自適應載入。
規則	20 個 Markdown 規則，用於定義輸出風格、安全限制與 QA 政策。錯誤會自動產生新規則。
自我學習流程	錯誤記錄於 `error-ledger.jsonl` 中，聚合為技能矩陣，並在多個專案中重複出現後，升級為永久的 `.md` 規則檔案。
設定檔	預先定義的套件，啟用部分代理/技能以降低令牌使用量（如 `core`、`frontend`、`full`）。切換設定檔會改變活躍元件集與上下文預算。
儀表板與 CLI	`vibeco` 命令提供統計、健康檢查、設定檔切換功能，以及可視化代理活動與令牌/成本使用的 Web UI。

快速開始（npm – 推薦）

npx vibecosystem init            # 安裝、註冊鈎子、建立 ~/.claude 布局
vibeco profile core             # 加載最小的「core」套件（12 個代理，32 個技能）
vibeco dashboard                # 開啟監控 UI

您也可以使用單行命令：

curl -fsSL https://raw.githubusercontent.com/vibeeval/vibecosystem/main/install-remote.sh | bash

或克隆倉儲並執行 ./install.sh --profile core。

典型工作流程

您：「新增一個新功能」
 → 意圖分類器
 → 階段 1（探索）：探查員 + 架構師 + 專案經理
 → 階段 2（開發）：後端開發 + 前端開發 + DevOps + 領域專家
 → 階段 3（審查）：程式碼審查員 + 安全審查員 + QA 工程師
 → 階段 4（QA 循環）：驗證者 + TDD 指南（最多重試 3 次）
 → 階段 5（學習）：若任務反覆失敗，自我學習者將撰寫規則
結果：功能程式碼合併、文件化，錯誤記錄用於未來專案。

所有協調透過 上下文注入 實現——代理讀寫共享的 Markdown 檔案（PLAN.md、PROGRESS.md、CONTEXT.md），而非 RPC 呼叫。

設定檔（節省令牌的套件）

設定檔	代理	技能	典型用途
`core`（預設）	12	32	有限實作與驗證（4k/12k 令牌預算）
`quality`	12	32	Core + 預設編輯/驗證檢查
`frontend`	~30	~60	React/Next.js、CSS、可存取性
`backend`	~44	~74	API、資料庫、安全
`full`	138	296	所有功能，更大令牌預算
`all`	138	296	`full` 的別名

使用 vibeco profile <名稱> 切換。

多 CLI 支援

CLI	安裝指令碼	你將獲得
Claude Code	`./install.sh`	全部代理、技能、鈎子、規則
Cursor IDE	`./install-cursor.sh /path/to/project`	6 個 MDC 規則 + 代理清單 + 技能
Codex CLI (OpenAI)	`./install-codex.sh --profile core --install-luna-worker`	Core 允許清單（32 個技能）或完整集，單一 `luna_worker` 模型權限
OpenCode	手動複製 `AGENTS.md`	僅技能

最近顯著功能（v3.4）

輕量級 core 執行時 – 預設運行最小執行時以提升速度與令牌效率。
Claude 適配器模型路由 – 根據任務自動選擇 Opus、Sonnet 或 Haiku。
知識圖譜整合 – 建構程式碼結構圖，使上下文重用節省 6–71 倍令牌。
儀表板 v2 – 每個代理的即時令牌與成本追蹤。
商業化堆疊 – 用於付費牆最佳化、RevenueCat 模式、Codex 協調的代理/技能。
文件生成與網站克隆 – 可生成 PDF/文件/XLSX 並像素級完美克隆網站的代理。

架構快照

Claude Code
 ├─ 鈎子 (74 個 TS 模組) → 注入上下文
 ├─ 代理 (138 個 Markdown 提示) ← 讀寫 PLAN/PROGRESS/CONTEXT
 ├─ 技能 (296 個提示片段)
 ├─ 規則 (20 個 Markdown 檔案，自動產生)
 └─ 內存 (PostgreSQL + pgvector) – 每個代理的持久記憶體，智能召回

自我學習流程持續運行：錯誤 → 直覺 → 整合器 → 規則 → 全域提升。

資料與隱私

所有資產均儲存在本地機器的 ~/.claude/ 中。
無出站網路呼叫、無遙測、無雲同步。
學習規則儲存在本地 ~/.claude/rules/ 中。

貢獻方式

歡迎新增以下內容：

面向特定領域的新代理定義（如 Flutter、Rails）。
面向額外框架或合規制度的技能模式。
更智能上下文注入的改進鈎子。
文件、教學、翻譯。

總結 – vibecosystem 是為 Claude Code（及相容 CLI）打造的即用型「AI 軟體團隊」層，捆綁了數百個專業代理、技能與鈎子，提供自我學習反饋迴路，並配備 CLI/儀表板用於監控。其目標是讓開發者將 Claude Code 視為全棧開發夥伴，而非單一、手動引導的助手。

vibeeval/vibecosystem