Claude Code Buddy：將 AI 轉化為具備專案記憶的隊友

Claude Code Buddy (CCB) 是一個開源項目，旨在解決大型語言模型 (LLM) 在軟體開發中最深層的痛點：無狀態的遺忘。透過外掛架構，CCB 為 Claude Code 注入了持久記憶、智能任務路由與安全性引導，將其從單次對話的助手升級為具備長期專案意識的 AI 隊友。

「我們不需要一個每次都從零開始解釋專案架構的聊天機器人，我們需要的是一個記得上次會議決策、熟悉團隊程式碼風格的資深工程師。」

一、安全性設計與「Vibe Coding」體驗

在當前的「Vibe Coding」(直覺式編碼) 浪潮中，開發者追求的是流暢、無阻礙的開發體驗。然而，這種快速迭代往往容易犧牲安全性與品質。CCB 的設計哲學在於將安全性內化於工作流之中，而非外加的阻礙。

CCB 並未強調顯性的「安全掃描按鈕」，而是透過專門的 Agent 與工作流引導來實現安全性：

Agent 分工與隔離：系統內建 security-auditor (安全稽核員) Agent。當開發者進行敏感操作或程式碼提交時，CCB 能感知上下文並建議切換至此模式進行審查，確保在 Commit 前發現潛在漏洞。
工作流引導 (Workflow Guidance)：CCB 的核心 DevelopmentButler Agent 會監控開發歷程。當偵測到大量程式碼變更卻無測試執行紀錄時，它會主動建議「執行測試」或「檢查程式碼品質」，這是一種「右移」的心理安全機制，促使開發者在舒適的節奏下保持紀律。
隱私優先的架構：CCB 堅持本地優先 (Local-First)。所有的記憶索引、Git 操作皆在本地執行。即便是選用的 RAG 功能，也支援使用 Ollama 等本地 Embedding 模型，確保敏感的專案知識不需要離開開發者的機器。

CCB 的大腦核心是其 AgentRegistry，它管理著 36 個高度專業化的 Agent，這些 Agent 依據實作層次分為三大類：

Real Implementation Agents (9個)：這是系統中最強大的 Agent，具備實際的 MCP 工具整合能力。
- development-butler：工作流的總指揮，負責監控狀態與提供建議。
- test-writer：專精於生成與執行測試套件。
- devops-engineer：處理部署腳本與 CI/CD 配置。
- workflow-orchestrator：協調多步驟的複雜任務。
Enhanced Prompt Agents (26個)：透過精心設計的 System Prompt 來模擬特定角色的專家視角，例如 frontend-developer 或 code-reviewer。它們不直接操作特殊工具，但能提供極具深度的領域知識建議。
Optional Feature Agents (1個)：如 rag-agent，需要額外的外部依賴 (如 Vector DB) 才能啟用。

使用者無需手動選擇 Agent。CCB 會分析使用者的自然語言指令，自動將任務路由給最適合的專家。例如，當您說「幫我看看這段 Code 有沒有 SQL Injection 風險」時，系統會自動切換至 security-auditor 模式，並調用相關的安全檢查知識庫。

CCB 最具創新性的功能是其「演化」能力。這並非指訓練模型，而是指系統層級的記憶累積：

Knowledge Graph (知識圖譜)：系統會記錄架構決策、技術權衡 (Trade-offs) 與替代方案。當未來遇到類似問題時，CCB 能調閱過去的決策脈絡，避免重蹈覆徹。
Project Context (專案上下文)：自動索引專案的 coding style、常用模式與組件庫。這意味著隨著專案開發的時間越長，CCB 生成的程式碼會越像團隊原生的風格。
RAG (檢索增強生成)：開發者可以將技術文件、API 規格書直接丟入 ~/Documents/claude-code-buddy-knowledge/，CCB 會自動索引並在需要時檢索，無需重複貼上文件內容。

除了智慧，CCB 還懂得精打細算。透過動態模型選擇 (Dynamic Model Selection) 機制，CCB 能判斷任務的複雜度：

根據我們的實測，這種分流機制平均能為專案節省約 40% 的 Token 成本，同時保持了高水準的產出品質。

Claude Code Buddy 代表了 AI 輔助開發的下一個階段：從單純的「問答」走向深度的「協作」。它不只是一個工具，而是一個會隨著專案與團隊一同成長的數位隊友，在保持「Vibe Coding」流暢體驗的同時，默默地為程式碼品質與安全性把關。