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 启用硬件及设备控制环境的无缝整合。