SuperAPI AI 工具集

Keeping Routines Focused

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:这是一份代码设计指南,主题是让每个例程(函数/方法)只做一件事,即实现“功能内聚”。核心原则是:如果例程的描述里出现“and”,说明它承担了过多职责,应拆分为多个专注的例程。目标是提升代码的智力可管理性,使代码更易理解、测试、修改和复用。

主要能力:给出识别信号(描述含“and”、命名含糊或过长、超过200行、参数超过7个、局部变量超过10个、混合抽象层级、同时做校验/计算/副作用、难以原子化测试);提供三种提取技术:按职责提取、按抽象层级提取、提取复杂条件为命名良好的布尔函数;并给出内聚层级(从偶然内聚到功能内聚)与命名诊断、参数数量、长度等经验准则。

使用方式:在编写新代码时主动应用,在设计函数、写规格、命名时检查;在评审或重构既有代码时,对长例程、难理解或难测试的例程进行拆分。文中以订单处理为例,展示如何把校验、定价、库存、持久化、通知等职责拆成独立例程,并给出“何时提取/不提取”的判断标准。

适用场景与限制:适用于需要提升代码可维护性的开发与重构场景。资料未提供具体安装命令、平台或收费信息;长度与参数阈值属于经验性建议,并非硬性限制,生成代码、复杂状态机和大量错误处理等情形可例外。