codeaholicguy/ai-devkit

AI DevKit – AI 程式碼代理的控制平面

是什麼 – 一個本地執行的 npm 套件，提供單一設定檔、終端機 UI 和一組可重複使用的「技能」，用以協調多個 AI 驅動的程式碼助手（Claude Code、Gemini CLI、Codex CLI、Cursor、GitHub Copilot 等）。它不取代底層模型；僅讓它們表現得像一個協調的工程團隊。

為何重要 – 當開發者開始在同一個程式碼庫中使用多個 AI 代理時，工作流程會迅速變得混亂：每個工具都有自己的規則檔、記憶體和終端機視窗。AI DevKit 加入了一層輕量的「作業系統」層，提供以下功能：

• 將所有代理設定集中於一個 .ai-devkit.json 檔案中。
• 在即時 TUI（ai-devkit agent console）中顯示所有執行中的會話。
• 可將提示、日誌或 stdin 路由至任意代理（ai-devkit agent send）。
• 提供本地 SQLite 知識庫（@ai-devkit/memory），讓代理能在不將所有內容塞入提示的情況下查詢專案規範。
• 提供可組合的技能（dev‑lifecycle、verify、tdd、structured‑debug、security‑review 等），強制執行資深工程師的工作流程。

核心概念

概念	功能
.ai-devkit.json	所有代理、其 MCP 端點以及要使用的技能堆疊的單一真相來源。
代理控制台	文字式儀表板，用於列出、檢視和與跨提供者的即時代理互動。
agent send	CLI 命令，用於將提示、stdin 或測試輸出發送到特定代理或命名群組，可選擇等待回應。
記憶體（@ai-devkit/memory）	用於儲存決策、規範和可重複使用的修復方案的本地 SQLite 儲存；代理按需查詢。
技能	可串接的小型外掛。主打的 dev‑lifecycle 會引導代理完成需求 → 設計 → 規劃 → 實作 → 測試 → 審查的流程。其他技能則加入驗證、測試驅動開發、除錯、安全檢查、文件化和程式碼簡化功能。

典型工作流程

1. 執行 npx ai-devkit@latest init – 導覽程式建立 .ai-devkit.json 和各代理資料夾（.claude/、.cursor/…），並產生規則與技能鈎子。
2. 啟動代理（例如：claude-code start …）。
3. 開啟控制台：ai-devkit agent console 以查看所有會話。
4. 使用 ai-devkit agent send "run the tests" --id my‑claude --wait 要求代理執行測試並回報結果。
5. 儲存專案規範：ai-devkit memory store --title "API handlers return DTOs" …。
6. 當需要新功能時，呼叫 dev‑lifecycle 技能；代理會在 docs/ai/requirements、design、planning 等目錄中建立文件，並在每個關卡（驗證、測試、審查）通過後才進入程式碼階段。

適合誰使用 – 已經依賴一個或多個 AI 程式碼助手，並希望獲得可重現、可審計流程的團隊：

• 需要在會話間記住規範的大程式碼庫。
• 具有嚴格品質門檻（測試、安全審查、文件）的專案。
• 需要統一 UI 和訊息層來管理多個代理的開發者。

安裝與快速入門

# 一行指令 – 建立設定並安裝所需元件
npx ai-devkit@latest init

導覽程式完成後，可執行以下指令：

• ai-devkit agent list
• ai-devkit agent console
• ai-devkit agent send "review this branch" --group reviewers
• ai-devkit memory store …
• ai-devkit skill add <registry> <skill> 從公開註冊表拉取額外技能。

可擴充性 – 技能由 Anthropic、Vercel、Supabase、Microsoft、Google 等多個組織發布。可使用 ai-devkit skill add … 新增技能，或依照 SDK 指南撰寫自己的技能。

授權 – MIT，無遙測，完全在本機執行。

---

所有細節均直接取自倉儲的 README；未推測任何額外功能。