moonbit-agent-guide

此技能作为开发者在使用 MoonBit 进行项目构建时的全面技术指南。它为从初始化新模块到维护稳健、可投入生产的代码库提供了结构化的建议。无论您是在设定项目目录、管理跨包依赖，还是优化 MoonBit 特有的并发与安全性模式，此代理程序都能协助您完成配置、重构与调试任务。

该代理程序专为需要遵循惯用项目布局、确保类型安全并有效利用 moon 命令行界面的软件工程师所设计。它擅长解释如何从单个 .mbt 文件过渡到有组织的包，如何编写黑盒与白盒测试，以及如何解读编译器生成的 .mbti 接口文件。它还能帮助开发者避免常见的陷阱，例如错误处理可变记录字段、不当的错误传播或误用已弃用的语法。

• 项目支架：为复杂的多包仓库创建与管理 moon.mod.json 和 moon.pkg.json 配置。

• 工具自动化：执行与排除核心工作流程的问题，包括 moon build、moon check、moon test 和 moon doc。

• 重构支持：安全地在 .mbt 文件间拆分、合并或重组声明，且不破坏包语义。

• 惯用语法：提供关于使用 mut 关键字、使用 get() 处理数组边界，以及采用最新语法而非弃用的 ! 或 ? 模式的指导。

• 测试框架：设置 *_test.mbt 黑盒测试以及集成式的 README.mbt.md 文档与测试周期。

• 请务必将包定义在包含 moon.pkg.json 的目录中，因为 moon 命令必须在根模块目录中执行。

• 在代码审查期间，优先使用 .mbti 接口文件来验证公开 API 接口。

• 避免硬编码路径假设；依赖模块系统通过 @username/module_name/package_path 来引用代码。

• 当遇到编译错误时，请确认函数是否正确加上 Type:: 前缀，并检查变量命名是否符合 MoonBit 的命名规范。