SuperAPI AI 工具集

oma-refactor

编程与开发

查看项目

更新于 10-16 05:47

技能介绍

用途:在不改变可观察行为的前提下改善内部代码结构,以可读性为优先,通过一系列小型、可验证的变换逐步重构,并把行为改动与重构分开提交。

主要能力:识别代码异味、技术债、遗留代码、长方法/大文件、上帝类、热点和特征测试;在重构前诊断安全网(变更行覆盖率、测试确定性、变异强度);按热点(复杂度×变更频率)对目标排序;规划命名明确的原子变换(提取、移动、重命名、分解、对齐惯用法);必要时先补齐特征测试/黄金主测试;对持久化状态或外部消费方采用 expand-contract 并行变更方案。

使用方式:先确认动机与范围,检查验证路径;若为棕地代码,先找接缝并编写特征测试(独立提交),再实施重构。每次只做一个原子变换,优先使用确定性引擎(IDE 重命名、codemod、ast-grep 等),然后原样重跑既有测试,通过后以 refactor: 提交。反复失败则改用 Mikado:记录前置条件,仅回退本次变换的编辑。报告默认写入 .agents/results/refactor/*.md。

适用场景:针对具体文件/模块执行重构;功能开发前的预备性重构;遗留系统救援;重构目标选择与优先级排序;评估代码当前是否适合重构。

限制:不修复缺陷或失败行为(转 oma-debug);不做安全/性能/无障碍审查(转 oma-qa);不决定系统设计、模块边界、ADR 或约定变更(转 oma-architecture);不负责数据库模式设计与迁移机制(转 oma-db);不处理提交拆分机制(转 oma-scm);性能优化本身不在范围内,调优只是副作用而非目标。重构必须保持消费方契约不变,无安全网不得重构,且不得把行为改动混入重构提交。