SuperAPI AI 工具集

refactor

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:refactor 是一个智能重构命令,触发词包括 refactor、refactoring、cleanup、restructure、extract、simplify、modernize。它面向需要安全、可验证地改造代码的场景,强调先理解意图与代码库,再逐步执行并持续验证,而非盲目搜索替换。

主要能力:命令支持指定重构目标(文件路径、符号名、模式或描述),并提供 --scope=<file|module|project> 与 --strategy=<safe|aggressive> 选项。流程分为六个阶段:意图确认、代码库分析、构建依赖与影响图、测试覆盖评估、生成重构计划、逐步执行与最终回归验证。执行中结合 LSP 工具(如定义跳转、引用查找、重命名、诊断)与 AST-grep 做结构化搜索和替换,替换前要求先 dryRun 预览。

使用方式:以 /refactor 加目标与选项调用,例如 /refactor [--scope=<file|module|project>] [--strategy=<safe|aggressive>]。在 Claude Code 中,资料说明需将 OpenCode/Codex 专有工具示例转换为 Claude Code 原生工具,如用 Task 工具派生子代理,用 Skill 工具调用技能;不要直接调用 task(...)、call_omo_agent(...)、spawn_agent(...)、background_output(...)、wait_agent(...)、team_*(...)、send_message(...)、followup_task(...)、close_agent(...) 等。

适用场景:适合文件、模块或整个项目的重构,包括提取逻辑、简化代码、现代化改造、清理与结构调整。

限制:资料要求测试覆盖低或为零时暂停或拒绝激进重构;不得使用 as any、@ts-ignore、@ts-expect-error,不得删除测试来通过,不得提交损坏代码;出现公共 API 破坏、范围不清或连续三次验证失败时应中止并咨询用户。具体平台支持、收费与价格暂未提供。