moai-foundation-core

MoAI Foundation Core 作為 MoAI-ADK 生態系統的架構骨幹，為 AI 驅動的開發提供了一套標準化的原則與模式。它專為希望實作高品質、可擴充代理人工作流程的工程師與開發人員所設計。透過強制執行嚴格的標準，該框架確保了自主代理人在受控的 Token 限制下，依然能可靠、安全且高效地運作。其核心重點在於以結構化的多代理人協作取代直接、非結構化的執行方式，從而提升複雜軟體開發生命週期中的維護性。

• TRUST 5 品質框架：透過測試優先、可讀性、統一性、安全性與可追溯性五大支柱，並結合自動化驗證機制，實現系統化的品質保證。

• SPEC-First TDD：一種正式的開發方法論，在實作前優先處理規格說明，運用 EARS 格式以減少規劃階段的 Token 浪費。

• 委派模式：透過專門的代理人協調工作執行，利用順序、並行與條件式執行策略，避免單體式代理人的行為。

• Token 預算管理：先進的上下文管理技術，包含策略性的 /clear 指令與模組化檔案載入，旨在將 200K 的 Token 預算發揮至極致。

• 漸進式揭露：基於實作深度交付資訊的多層次知識架構，支援從入門到進階的配置需求。

• 模組化架構：透過檔案分割與標準化參照架構提升系統擴充性，確保複雜的工作流程保持可管理狀態。

• 典型輸入包括開發需求、技術規格與任務提示；輸出為高度結構化、經過測試的程式碼單元與文件集。

• 此框架針對大規模 AI 自動化、複雜程式碼庫重構以及自動化技能生成等場景進行了最佳化。

• 關鍵績效指標包含測試覆蓋率 (>85%)、Token 利用效率，以及對執行規則中定義之安全限制的遵守情況。

• 實務上的限制要求使用者必須遵守定義好的代理人目錄，並嚴格遵循基於 /moai 的指令參考，以維持系統的一致性。

• 建議使用所提供的 TOON 工作流程模板，以實現與 ADB 啟用硬體及裝置控制環境的無縫整合。