SuperAPI AI 工具集

refactoring-packages

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:分析既有代码的包/模块结构,给出改进建议并制定、执行迁移计划,适用于需要整理依赖关系、消除循环依赖或拆分臃肿模块的场景。

工作流程:1. 现状分析 → 2. 问题定位 → 3. 改进建议 → 4. 迁移计划。

现状分析使用工具:mcp__serena__list_dir(recursive: true)把握目录结构;mcp__serena__get_symbols_overview 把握文件内符号;mcp__serena__find_referencing_symbols 检测依赖关系。确认要点包括目录深度(理想 4 层以下)、每个目录的文件数(理想 10 以下)、命名规则一致性。

问题定位参照 references/analysis-patterns.md,优先级由高到低为:循环依赖(导致无法构建)、神模块(变更影响大)、功能散落(降低开发效率)、过度嵌套(降低可读性)。改进建议同样参照该文件。

迁移计划分阶段:Phase 1 准备(确认测试覆盖率、制作依赖关系图);Phase 2 结构变更(创建新目录、移动文件、更新导入路径);Phase 3 验证(运行测试、确认构建)。示例中针对 auth/mod.rs 神模块,建议拆分为 auth/core.rs、auth/middleware.rs、auth/error.rs,并将 mod.rs 改为仅做再导出,验证命令为 cargo test 与 cargo clippy。

相关技能(建议并读):package-design(重构目标的设计原则)、ddd-module-pattern(DDD 语境下的目标结构)、intent-based-dedup(重构时判断重复代码是否共通化)。

限制:资料未提供具体支持的编程语言范围、安装方式、收费与平台信息。