SuperAPI AI 工具集

refactor-clean

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:refactor-clean 用于指导编码智能体做“干净重构”,即把旧结构替换为代码库若在今天重新设计时会采用的更简单形态,而不是在问题旁边加一层兼容层。核心是移动所有权,让每个概念只有一个明确归属:既把 N 个重复所有者合并为一个,也把过载模块拆成它隐藏的多个所有者。

主要能力与工作流:扫描所有被触及路径中的命名,判断名称是否描述概念当前范围,立即重命名误导性的文件、符号、导入绑定与共享导出,并在同一轮更新所有消费者、测试、文档与智能体指令;找出缺少唯一所有者的概念及其全部所有者与消费者;在放宽检查或把输入改为可选之前先做删除,追踪写入方、传输、读取方、校验方与消费者,若删除后必需行为仍成立,就删除该机制及其调用点、测试与文档残留;把剩余概念提升到自然归属的模块,让旧调用点直接消费该所有者;仅为已识别的消费者和具体会被破坏的行为保留兼容,桥接要小并带移除条件。

规则要点:每一行都是债务,写守卫、校验器或清理路径前先问平台是否已提供该能力、该失败是否改变真实结果;用 git diff --numstat <base> -- ':!specs' ':!.test.' ':!**/test-harness' 衡量改动规模,小行为改动耗大量行数说明在对抗现有形态;不因既有架构的沉没成本而保留旧形态;优先一个共享原语而非 N 个适配器;模块过大按所有权缝拆分;新建机制前先搜索已有实现;默认不保留仅开发期兼容;命名不携带历史沿革;可重复请求优先幂等契约而非拒绝;约束模型到生产实际写入的范围;检查不应重新推导代码已计算的值;对称占位符可能掩盖朝向或坐标缺陷。

适用场景:重命名请求、名称过时或误导、范围变化、发现重复概念、合并重复所有者、拆分过载模块、删除冗余输入与适配器、架构切换等。

限制:资料未提供具体安装命令、平台支持、收费方式与效果数据;该技能以规则与工作流文本形式给出,实际执行依赖使用它的编码智能体与代码库环境。