SuperAPI AI 工具集

refactoring-playbook

编程与开发

查看项目

更新于 10-16 05:08

技能介绍

用途:指导代码现代化、架构迁移、依赖升级或大规模重构类任务,核心目标是在改变实现的同时保持行为不变。

主要能力:提供一套分阶段迁移方法论与 worker 分工。原则是“先测试后改动”:已有测试需确保通过并覆盖待改行为;缺少测试则先补特征测试(characterization tests)记录当前行为。里程碑按安全转换阶段划分:characterization(补测试)、scaffold(新旧并存,绞杀者模式)、migrate-batch-N(分批迁移,每批测试通过)、cutover(切换并删除旧代码)、cleanup(清理脚手架)。

worker 类型:characterization-worker 补现有行为测试;scaffold-worker 搭建与旧代码并存的新基础设施与适配器;migration-worker 每次只迁移一个组件并更新调用点,跑全量测试;verification-worker 跑全量测试并人工比对新旧行为差异。各 worker 通过 .factory/library/ 下的 migration-plan.md 与 migration-status.md 共享状态,开始前读取、完成后更新。

使用方式:编排前创建 migration-plan.md(当前状态、目标状态、范围、方法、风险区)与 migration-status.md(组件状态、测试覆盖、脚手架状态、阻塞项),并确保 .factory/services.yaml 的测试命令运行全量套件。功能命名如 characterize-<area>、scaffold-<component>、migrate-<component>、verify-batch-N、cutover-<area>、cleanup-<area>。

适用场景:需要保留行为的重构、架构或依赖迁移。限制与注意:迁移中不得改变行为,禁止大爆炸式迁移,不得跳过特征测试,需用 grep/find-references 确认调用点全部更新,重构与加功能分开。遇到脚手架未就绪、测试失败且修复复杂、发现架构问题或未记录依赖时,应返回编排器。资料未提供具体收费、平台支持与安装命令等信息。