SuperAPI AI 工具集

safe-refactor

编程与开发

查看项目

更新于 10-16 03:41

技能介绍

用途:在重命名函数、变量或类,重组代码结构,优化性能关键段,提升可读性与可维护性,提取方法或类,以及合并重复代码时,执行安全重构。

主要能力:提供“安全优先”流程,要求先分析当前代码与依赖,再创建 git 分支或暂存变更作为备份,随后进行小而可验证的增量修改,并保持可回滚。重构前需用 Grep 查找目标代码的所有使用位置,用 Read 理解现有实现,识别依赖与副作用,并检查需要谨慎处理的复杂逻辑。变更管理上要求原子化修改、每步后测试、同步更新注释与文档,并在未明确变更时保持公共 API 不变。

使用方式:重构前运行 pnpm test、pnpm run lint、pnpm run typecheck 做检查;重构后运行 pnpm test && pnpm run lint && pnpm run typecheck 验证,并用 git diff --name-only 检查破坏性变更。回滚可使用 git reset --hard HEAD~1、git checkout main、git branch -D feature-branch,或通过 git stash 与 git stash pop 保存和恢复工作区变更。也可保留原始文件备份、参考 git 历史并确认改动文件后手动回滚。

适用场景:函数或方法重命名、变量重命名、代码提取等重构类型,以及需要与版本控制、测试框架配合的日常开发维护。

限制:资料未提供具体支持的编程语言、平台、收费方式或性能数据;示例命令基于 pnpm 与 git,实际可用性取决于项目环境。遇到测试失败、lint 错误或类型错误时,应停止继续修改,回滚问题变更,验证回滚有效后拆分为更小改动重试,必要时请求代码审查。