codestable/CodeStable

解決的問題

CodeStable 為長期專案中的 AI 協作式軟體開發提供一組輕量級的「技能契約」。它防止 AI 代理隨著時間推移失去上下文或邊界，確保 AI 行為基於證據、尊重專案邊界，並將知識整合回現有的專案文件，而非建立重複的平行系統。

如何運作

CodeStable 不使用複雜的代理編排或僵化的腳本，而是採用「薄外衣、厚上下文」的方法。它定義特定技能（例如 cs-feat 用於功能實作，cs-issue 用於錯誤修復），在約束目標與邊界之餘，讓 AI 模型能根據倉儲事實自行選擇執行路徑。

關鍵機制包括：

• 基於證據的交付：在完成任務前要求驗證（例如，錯誤修復需實現「紅轉綠」）。
• 專案記憶：使用極簡骨架（.codestable/）追蹤關鍵專案事實（attention.md）、經驗證的教訓（lessons/）和活躍任務游標（work/）。
• 權威所有權：避免重複文件，將穩定結論推回專案原始資訊來源（ADRs、程式碼或現有文件）。

適用對象

• 長期迭代（數月或數年）的軟體專案團隊。
• 希望 AI 高效執行，同時人類保持對產品邊界與最終驗收控制的開發者。
• 重視可驗證結果、獨立審查以及跨不同 AI 會話或模型的知識重用的團隊。

核心亮點

• 基於技能的路由：提供 8 種專業技能，用於路由操作、入職引導、功能實作、問題診斷、重構、史詩管理、審查與記憶管理。
• 極簡記憶：使用小而結構化的目錄儲存高價值專案事實與經驗，避免專案膨脹。
• 史詩雙層模型：將長期契約（目標／決策）與暫時執行狀態（進度／證據）分離。
• 插件生態系統：可整合 Codex 與 Claude 插件市場。