SuperAPI AI 工具集

ajiang_ablation_refactor

编程与开发

查看项目

更新于 10-16 01:33

技能介绍

消融式重构:用单变量实验定位无收益的复杂度,同时保留有价值的保障。

用途:不因“架构看起来乱”就直接全面重写,而是通过移除、绕开或替换单个机制,观察用户结果与成本变化,据此决定取舍。

准备工作:先读取目标项目规范,确认目标仓库/工作区、版本、用户结果与允许的改动;参考仓库只读。没有项目规则时,从实际README、脚本和源码推导入口。按当前可用且获授权的工具执行;缺少独立agent时可用新会话、人工审查或分视角自检,并注明真实审查方式;缺少浏览器或真实API时完成可执行部分并交接未覆盖验收。不绑定模型厂商或特定插件。复杂任务可按 assets/task-record.md 保存必要事实。

主要能力:定义需保留的结果与基线,采集耗时、模型调用/成本、内存、依赖、重复实现维护点、故障或误阻断等基线数据;查找同一规则的多份实现、同一数据的多份来源、昂贵复核层、保留的旧入口、无实际消费者的配置、反复转换的数据等候选;在隔离工作副本或可回滚实验中一次改变一个机制并重跑同一输入与验收,记录维持、退化与成本变化。安全、数据完整性与恢复护栏需有失败或攻击场景验证,正常样本无差异不足以证明冗余。

使用方式:按候选机制、原责任、实验变化、行为证据、成本变化、结论整理取舍,结论可为保留、删除、合并、替换或待验证。仅要求分析时交付可审查方案;授权实施时完成改造。新路径上线后检查旧函数、路由/注册、配置、测试、依赖与公开文档,无消费者的旧路径按证据退役;暂留兼容入口时说明责任与可验证的退役条件,避免永久双轨。最后重跑基线任务与相关回归,必要不变量由回归测试守住。

适用场景:膨胀软件的最小重构评估、冗余机制清理、旧路径退役决策。

限制:代码行数仅用于找候选,不作为质量指标;未测量的收益不写为数字;一次任务成功不能宣称所有历史行为等价;未覆盖的平台与低频条件需明确列出。