SuperAPI AI 工具集

refactor-pm

编程与开发

查看项目

更新于 10-16 05:53

技能介绍

用途:扫描指定文件或目录,识别机制与策略纠缠的代码,并给出重构建议。它遵循 Arne Brasseur 的定义:机制是无倾向、上下文无关、可跨业务领域复用、易隔离测试、变化缓慢的代码;策略是有倾向、绑定特定领域、预期频繁变化的代码。区分不在代码做什么,而在代码怎么写,目标是让代码向这一光谱两端靠拢。

主要能力与诊断角度:判断代码是否把所有依赖作为显式参数传入,还是依赖默认值、全局变量或隐式上下文(越显式越偏机制);判断逻辑复用方式,若换参数即可复用属机制,若需复制粘贴再改属策略;判断代码表达的是稳定技术事实还是当前业务决策;检查硬编码值程度,硬编码常量往往意味着策略泄漏进机制;判断代码是否以便利优先于显式,便利导向的默认值常是策略渗入机制。

输出内容:对每个文件或模块报告四类发现——机制与策略纠缠的混合代码及其边界应画在哪里;目前嵌在策略代码中、可抽取为独立模块或库的机制候选及其理由;漂移到本应属于底层机制中的错位策略,说明隐藏假设及其应有归属;针对每项发现给出具体重构建议,展示前后结构而非只讲原则。

限制:不提倡过早重构,只有当某模式在至少两个不同用例中出现时才建议抽取;保持现有行为不变,这是结构性重构而非业务逻辑重写;建议须基于真实代码,不得提出代码库中无证据的抽象。该技能的介绍未提供安装命令、调用方式、支持语言、平台或收费信息,暂未提供。