SuperAPI AI 工具集

monolith-refactor

编程与开发

查看项目

更新于 10-15 21:34

技能介绍

用途:系统性地将过大的文件拆分为更小、更易维护的模块,且不改变原有行为。

目标选择:可指定一个具体文件,或一个目录;若指定目录,则优先重构其中最大的文件。

推荐流程:读取并梳理目标文件或目录结构;评估依赖以确定安全的拆分顺序;提出职责清晰的模块拆分方案;以小而可验证的步骤创建新文件并迁移代码;对超大文件分多个阶段处理;通过 re-export 或 index/mod 文件保留公共 API;每次迁移后更新导入与引用;为拆分后的模块新增或更新测试;每个阶段结束后更新文档,说明迁移内容与原因;最后发布迁移报告。

约束:除非明确要求,否则不得改变行为;优先使用小而内聚的文件,避免产生新的巨型文件;在可行时把文件控制在约 300-400 行以内;保持模块边界明确、职责聚焦。

完成报告需包含:目标路径、新建文件、修改文件、API 表面变化(如有)、新增或更新的测试。