ww-w-ai/bkit-claude-code

解決的問題

bkit 是 Claude Code 的插件，將 AI 原生開發轉化為結構化系統。它透過引入嚴謹的驗證、上下文管理以及多代理編排工作流程，解決了「氛圍編碼」（vibe-coding）問題——即 AI 產生的程式碼看似合理，但實際上可能與原始設計或需求不符。

如何運作

bkit 採用「上下文工程」方法，使用一組專用代理與品質門檻。它透過三個主要指令運作：

• /sprint：透過將多功能發布拆分為「上下文預算內衝刺」（通常 ≤ 75K 令牌）來管理多功能發布，防止 AI 失去焦點或記憶體耗盡。使用主計畫在會話間追蹤進度。
• /pdca：對單一功能執行「計畫-執行-檢查-行動」（PDCA）循環。這涉及一個由專家代理（PM、CTO、開發者、QA）組成的團隊，他們建立 PRD、設計文件與程式碼，然後驗證結果是否符合設計。
• /control：一個單一自主性旋鈕（0-4 級），決定流程在多大程度上無人監控運行，從完全手動到完全自主。

為確保品質，bkit 使用 品質門檻（如 M1 matchRate）來衡量設計規格與生成程式碼之間的對齊程度。若匹配率低於 90%，系統將自動觸發自我修復循環。

適用對象

• AI 編碼新手：希望在無需深厚資深工程直覺的情況下交付生產級軟體的人。
• 獨立開發者與初創建構者：需要一個「盒中團隊」來並行處理前端、後端、QA 與安全的人。
• 團隊負責人：管理超出單一 AI 會話上下文視窗的複雜發布的人。
• 非英語使用者：能以多種語言描述需求（支援 8 種語言自動偵測）。

主要亮點

• 上下文預算衝刺：透過將專案拆分為可管理的、依賴感知的模組，防止上下文視窗溢出。
• 程式碼化文件：遵循「文件 = 程式碼」理念，每個功能都會產生 PRD、設計與報告，這些文件隨後成為驗證的契約。
• 自動自我修復：使用 gap-detector 與 pdca-iterator 自動修復偏離設計規格的程式碼。
• 多代理編排：產生專業代理（如 pm-lead、cto-lead、qa-lead）來處理開發生命週期的不同階段。
• 詳細的品質門檻：包含 11 個具體門檻，包括 7 層資料流完整性檢查。