WoJiSama/skill-based-architecture

解決的問題

編碼代理經常面臨項目規則分散、多個檔案（如 CLAUDE.md 或 .cursorrules）中重複的指示，以及缺乏明確的「完成定義」等問題。基於技能的架構（SBA）將這些分散的指示集中到單一的、可路由且可驗證的專案「技能」中，確保代理在不猜測實作範圍的情況下，嚴格遵循專案的實際業務邏輯與架構規則。

如何運作

SBA 提供一個專案層級的操作契約，代理使用該契約來導航倉儲。與載入一個巨大的指示檔案不同，代理會：

1. 盤點 倉儲，識別現有規則。
2. 選擇 基於使用者請求的特定工作流程。
3. 載入 僅載入當前決策所需的證據與知識。
4. 綁定 將業務意義與當前程式碼所有者關聯。
5. 驗證 根據請求的最終狀態來驗證結果，而非僅將指令或提交視為「完成」。
6. 記錄 從失敗中提取可重用的學習，防止問題再次發生。

適用對象

專案指示已變得過大難以導航，或在不同代理入口檔案之間存在矛盾，或重複任務需要嚴格流程與可靠完成檢查的開發者與團隊。

特點

• 集中化知識：消除 AGENTS.md、CLAUDE.md 與 Cursor 規則之間的重複。
• 與代理無關：相容於 Claude Code、Cursor、Windsurf、Gemini CLI 及其他文件感知代理。
• 基於證據的執行：採用結果導向的生命周期，若證據否認當前前提，則返回本地化或分解階段。
• 自動化遷移：包含一個腳手架工具，可預覽並應用現有規則向 SBA 結構的遷移。
• 嚴格的完成紀律：基於綁定的交付物與最終狀態定義「完成」，而非單純的活動（如推送或提交）。