moonbit-refactoring

moonbit-refactoring 技能为 AI 代理程序提供了一个结构化框架，用于对 MoonBit 代码库执行高质量的维护工作。它专为使用 MoonBit 的开发者、函数库维护者及团队设计，适用于更新旧代码、强制执行项目架构标准或针对性能与清晰度优化现有模块。通过应用此技能，代理程序将作为专业的重构引擎，优先考虑语义正确性、API 稳定性及惯用语法表达。

• 执行整体架构审查，包括封装结构、依赖性管理及文件大小优化，目标是将每个包控制在 1 万行代码以内。

• 通过识别冗余的公开导出内容、将辅助函数移至内部包，并将公开 API 接口严格限制在必要范围内，来执行 API 精简化。

• 通过将自由函数转换为方法来改进代码的易发现性与链式调用，通常会利用 #as_free_fn 宏在转换期间维持向后兼容性。

• 通过使用 ArrayView、StringView 和 BytesView 等视图类型来取代数据复制，从而优化内存使用并确保高效的数据处理。

• 推动表达式 MoonBit 特性的使用，特别是用声明式模式匹配、嵌套匹配和 guard 子句取代命令式变更，以实现更干净的控制流程。

• 自动整合循环不变量与文档更新，确保重构过程能通过编译器检查与单元测试的验证。

• 此技能需要访问整个存储库，并高度依赖 moon ide 工具链（包含 moon ide doc、moon ide find-references 和 moon ide analyze），以安全地识别项目中各项变更的影响。

• 此技能预设代理程序会遵循先进行广泛架构改进，再进行细部重构的工作流程。

• 用户应预期代理程序会在过程中频繁执行 moon check 与 moon test，以保证不会出现回归问题。

• 给予代理程序的输入应包含需要关注的特定包或符号，输出的结果通常是一系列连贯的 commit，这些变更会改进包模块化、简化枚举构造子用法，并使代码库与 MoonBit 的最佳实践保持一致。