SuperAPI AI 工具集

python-refactoring

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:该技能提供 Python 代码重构的触发条件与指导原则,帮助判断何时应重构代码,主要依据代码规模与复杂度阈值。

主要能力:

  1. 模块大小限制:单个 .py 文件超过 250 行时,建议拆分为多个模块,例如用 init.py 暴露公共 API,并拆出 core.py、helpers.py、validators.py 等;或提取相关函数到独立模块。
  2. 函数大小限制:函数(声明加函数体)超过 75 行时,建议分解为多个职责单一的小函数,例如将 process_data 拆为 validate、transform_data、clean_data、aggregate_data、export_results 等步骤。
  3. 类大小限制:类超过 200 行时,建议按职责拆分,或通过依赖注入将 validator、parser、transformer、exporter 等作为构造参数传入,由 process 方法组合调用。
  4. 重构原则:遵循单一职责原则,避免一个类同时承担认证、邮件、缓存、报表等多种职责;在类属性或依赖过多时,优先使用组合而非继承,通过构造函数注入依赖。

使用方式:当代码超过上述大小阈值、类方法过多、函数过于复杂或需要做重构决策时,可参考本技能给出的规则与示例进行拆分和重组。

关键规则:模块超过 250 行拆分为多个模块;函数超过 75 行分解为更小函数;类超过 200 行应用单一职责并考虑组合;方法过多时拆分为更小的类;依赖过多时使用依赖注入。

限制:资料未提供具体安装命令、运行方式、支持平台、收费信息或自动化重构工具,相关内容暂未提供。