SuperAPI AI 工具集

clean-functions

编程与开发

查看项目

更新于 10-16 08:41

技能介绍

用途:在编写、修复、编辑或重构 Python 函数时,强制遵循 Clean Code 原则,帮助保持函数简洁、职责单一。

主要能力与规则: F1 参数过多:函数参数最多 3 个;超过 3 个说明函数做得太多或需要数据结构,建议改用 dataclass 或 dict 封装参数。 F2 不使用输出参数:不要通过修改参数产生副作用,应返回新值。例如用返回新值的 with_footer(report) 代替原地修改 report 的 append_footer(report)。 F3 不使用标志参数:布尔标志意味着函数至少做两件事,应拆分为两个函数,例如将 render(is_test) 拆为 render_test_page() 与 render_production_page()。 F4 删除死函数:如果函数没有被调用就删除,不要保留“以防万一”的代码,历史记录由 Git 保存。

适用场景:Python 代码的日常编写与重构、代码审查中检查函数设计、减少函数参数与副作用。

限制:资料仅给出上述四条规则与示例,未提供安装命令、运行方式、平台支持、价格或性能数据,这些暂未提供。