重构建议
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @metago/metago-refactor-suggest。
技能介绍
要解决什么问题
接手或维护一段已经明显「又长又难改」的代码时,往往需要先判断问题出在哪一类结构债务上,再决定是抽函数、拆模块还是改数据流——而不是一口气大改功能。本技能面向日常自查:在你贴出代码或描述片段规模的前提下,快速给出坏味道判断、可行重构方向、风险点与验证思路;完整分步计划与前后对比代码属于专业版 metago-refactor-pay。
技能如何工作
触发后按免费版能力范围组织输出,核心是可执行的结论摘要而非长篇报告:
- 坏味道识别:根据你提供的代码结构、命名、职责集中度等,归纳常见异味类型(如过长函数、重复逻辑、过深嵌套等)。
- 重构方向:在行为保持前提下,建议优先动刀点(提取方法、引入对象、缩小可见范围等),并说明取舍理由。
- 风险提示:标出边重构边改需求、缺少测试网等高风险做法,以及可能波及的调用方。
- 验证建议:建议用哪些用例或回归点确认「改结构不改行为」。
信息不足时技能会引导补充,不臆测;结论不确定时会标注置信度。未提供代码时会要求你贴上相关片段;范围过大时会建议按模块拆分提问。
适用边界与注意点
- 免费版输出为快速版要点,不包含可存档的完整深度交付。
- 建议遵循行为保持原则;没有测试时仍可讨论方向,但更建议先补关键用例再动刀。
- 纯提示词技能,不执行外部请求、不收集用户数据;关键结论宜人工复核后再落地修改。
使用场景
- 维护一个 200~500 行单文件函数,想先判断该拆职责还是抽子函数再动手改
- Code Review 中看到重复分支和魔法数,需要列出坏味道类型和优先重构顺序
- 遗留模块没有单测,想在改结构前拿到风险清单和应先补哪些关键用例
- 用户说「这段逻辑太绕」,你手头只有片段,需要验证建议和置信度标注
适合人员
- 负责老业务模块的日常维护工程师,经常要在不动需求的前提下理清「这段该怎么拆」
- 做合并请求评审的资深开发,希望把异味归类并写进评审意见里的重构建议而非只留「太难读」
- 带领小团队偿还技术债务的技术负责人,需要先给模块划分重构边界再安排迭代
- 独立接外包维护旧代码的全栈开发者,缺测试时想先拿到风险提示再评估工时