SuperAPI AI 工具集

file-refactor

编程与开发

查看项目

更新于 10-16 07:20

技能介绍

用途:让每个源文件保持在 500 行以内,在文件越过上限前完成拆分,避免单文件同时承担多种职责。

触发时机:文件超过 500 行;模块混合了类型、工具函数、处理器、渲染与常量;页面组件内含可抽取的内联子组件;服务文件把纯辅助函数、数据类与编排逻辑混在一起。

TypeScript / React 拆分顺序:类型(接口、类型别名、枚举)→ types.ts;纯工具(格式化、分组、转换)→ utils.ts;复杂状态逻辑 → hooks/useXxx.ts;子组件(UI 片段)→ components/XxxYyy.tsx;常量与配置(硬编码数组、配置对象)→ constants.ts。

Python 拆分顺序:数据模型(@dataclass、TypedDict、Protocol)→ models.py;纯辅助函数(无副作用的格式化/解析)→ utils.py 或 *_format.py;编排逻辑保留在原文件作为协调者(CLI 入口、服务门面);CLI 分组(子命令处理器)→ 独立模块;常量(模板、frozenset)→ constants.py。

规则:单一职责,每个文件只做一件事;内聚,相关代码放在一起;保留导出,不破坏既有导入,必要时从原文件重新导出;与邻近文件保持一致,沿用现有包结构,不发明新模式。拆分后必须通过类型检查与 lint。

限制:资料未提供具体安装命令、支持的平台、收费方式或效果数据,暂未提供。