SuperAPI AI 工具集

oma-refactor

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:在不改变可观察行为的前提下改善代码内部结构,以可读性为首要目标,通过小的、可验证的变换逐步重构,每一步都由测试、工具或类型等安全网把关,并与行为变更分开提交。

主要能力:识别重构意图(重构、清理、去重、现代化、提升可维护性);针对代码异味、技术债、遗留代码、长方法/大文件、上帝类、热点、特征测试及提取/移动/重命名等变换;选择并排序重构目标(异味+SATD+热点=变更频率×复杂度);评估当前是否可安全重构(覆盖率×变异强度×不稳定性);执行具体文件或模块的重构;在功能开发前做预备性重构;遗留系统救援(发现接缝+特征测试后再重构)。

使用方式:输入目标(文件/模块/路径、异味报告、SATD 标记或驱动重构的功能请求)、验证方式(项目测试命令,必要时覆盖率/变异工具)、约束(编码规范、受监管环境标记、合并窗口)。输出为一系列仅重构的原子提交、缺失时补充的安全网测试(单独提交)、前后指标对比与可读性结论。独立运行报告写入 .agents/results/refactor/,编排运行写入 .agents/results/result-refactor[-{sessionId}].md。

适用场景:对特定文件/模块执行提取、移动、重命名、分解、模式对齐;功能前的预备重构;遗留代码接缝发现与特征测试;重构目标选择与优先级排序;审计代码当前是否适合重构。

限制:不用于修复缺陷或失败行为(应使用 oma-debug);不用于安全/性能/可访问性审查(oma-qa);不用于系统设计、模块边界、ADR 或约定变更(oma-architecture);不用于数据库模式设计或迁移机制(oma-db);不用于提交拆分/暂存机制(oma-scm);性能优化本身不在范围内。缺少验证路径时,首个交付物是安全网而非重构。行为契约不可违反,测试与生产代码一次只冻结一侧,指标仅为代理,可读性才是成功标准。