SuperAPI AI 工具集

refactoring-patterns

编程与开发

查看项目

更新于 10-26 17:17

技能介绍

重构模式是一个帮助 AI 代理系统性地改善现有代码结构的技能。资料将其定位为“不改变可观察行为而重组代码”的实践:目标是让代码更容易理解、修改成本更低、更少隐藏缺陷。每次重构动作都是一个具名、可重复的变换,按小步骤执行并在每步后验证测试,是保持代码库安全的核心方式。

用途与触发场景:当用户要求把方法、函数或代码块提取为具名辅助函数;存在随新分支不断增长的长 if/else 链或 switch;函数参数过多需要简化;希望用命名常量替换魔法数字或字符串字面量;需要拆解承担过多职责的大类;条件逻辑复杂难以一眼读懂;寻求不改变行为的“系统性”代码改进;或想消除跨文件、跨类的重复代码时,该技能会被启用。资料同时明确不应触发的场景:性能优化(重构针对可读性而非速度)以及改变系统边界的架构决策(应改用 clean-architecture)。

关键原则:小步前进并保持测试通过,一次只应用一个重构;保留可观察行为,返回值、副作用和抛出的错误必须保持一致;一次只做一个重构,不把提取方法与重命名变量混在同一提交;先重构再加功能(Fowler 规则:先让改动变容易,再做容易的改动);把代码坏味道视为需要重构的信号。

主要能力:技能内置代码坏味道分类与对应手法的映射,包括长方法→提取方法、大类→提取类、长参数列表→引入参数对象、重复代码→提取方法/上移方法、switch 语句→以多态替换条件、基本类型偏执→值对象、依恋情结→移动方法、临时字段→提取类、数据泥团→引入参数对象、投机性泛化→折叠继承/移除。它还提供重构安全网的建议:没有测试就不要重构,测试缺失时先编写刻画测试来捕获当前行为。

常见任务示例:提取方法(将打印订单摘要拆分为打印表头、打印明细、打印合计三个函数);以多态替换条件(把按配送方式分支的运费计算改为 ShippingStrategy 接口及各实现类);引入参数对象(把 createReport 的多个参数合并为 ReportOptions);用命名常量替换魔法数字(如折扣阈值、滞纳金单价);分解条件(把复杂布尔表达式拆成具名谓词函数);提取类(将地址字段和地址相关方法从 User 中拆出为 Address 类);以查询替换临时变量(把局部计算变量改为可复用函数调用)。

使用方式:资料未提供安装或调用命令以外的产品操作细节;技能提到首次激活时会在对话首条回复前加上特定表情符号,并检查已安装的配套技能,缺失时提示可用 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name> 安装。需要识别具体坏味道或在多个重构手法间抉择时,再加载 references/code-smells.md 参考文件。

适用场景与限制:适合日常代码可读性改进、消除重复、简化复杂条件与参数、拆分职责混杂的类,并强调与功能开发分开提交。不适用于性能优化与改变系统边界的架构调整;资料也提醒避免过度提取微小函数、对稳定的 switch 强行套用多态、一次性大规模重命名,以及用查找替换代替 IDE 重命名重构等做法。该技能的收费、平台支持范围等商业信息暂未提供。