SuperAPI AI 工具集

js-project-refactor

编程与开发

查看项目

更新于 10-16 08:46

技能介绍

用途:面向存在架构问题、结构混乱的 JavaScript 项目,从全局视角梳理文件结构与代码逻辑,进行解耦与重构,消除面条代码与循环依赖,建立单向数据流或清晰依赖图。\n\n主要能力:落实单一职责原则,避免“上帝文件”;实现高内聚低耦合,公共逻辑下沉,业务模块间通过清晰接口通信;提升可扩展性与可测试性,将业务逻辑与第三方库、UI、底层 API 请求解耦。\n\n使用方式:触发场景包括用户要求“重构项目”“优化代码结构”“梳理架构”“解决代码耦合”,或项目存在职责不清、互相依赖的面条代码。工作按四步展开:先做项目全局诊断,指出过度耦合、职责混用、命名不规范等问题;再输出重构后的目录树并说明各文件职责;随后逐个输出重构代码,确保 import/export 或 require 路径正确,不省略核心逻辑;最后做重构总结并给出后续维护建议。\n\n结构规范:按领域/功能划分模块文件夹;提取 constants/config、utils/helpers、services/api、controllers/hooks/domain 等层次。文件以单一职责为第一拆分原则,参考单个文件超过 300-400 行时审视是否职责过多;但高度内聚的逻辑(如长配置表、强关联表单校验规则)即使超过 500 行也应保留,避免过度碎片化。\n\n注释规范:删除废话注释与已注释掉的死代码;保留解释特殊业务规则、黑科技或复杂正则/算法原理的注释;为重构后所有导出函数、类、接口、常量补充标准 JSDoc,标明职责、@param 与 @returns。\n\n限制:若单次回答受代码量限制,先输出基础建设模块和主干业务流程模块并提示继续生成剩余部分。其他如具体安装命令、支持平台、收费方式暂未提供。