Agent Skills
返回列表
代码简化助手

代码简化助手

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e40a4360/code-simplification。

技能介绍

要解决什么

代码能跑,但不容易维护,是这类技能针对的问题。它不追求“少写几行”,而是把已经通过测试的功能代码整理成更容易阅读、修改、调试和评审的形式。典型场景包括:实现明显比问题更重、代码审查指出嵌套过深或命名含糊、多个文件里散落重复逻辑,以及合并后引入不一致。

它如何工作

技能把简化定义为一个受控流程:

  • 先理解再动手:在删除或改写前,先判断代码为什么存在,避免误删“Chesterton’s Fence”。
  • 识别具体信号:例如 3 层以上嵌套、50 行以上长函数、doThing(true, false, true) 这类布尔参数、data/temp 这类模糊命名、重复逻辑和无价值包装。
  • 小步应用:每次只做一个简化点,跑测试;重构与功能变更分开提交。
  • 验证整体效果:如果简化后更难理解、需要改测试、移除错误处理或扩大 diff 范围,就回退或重新评估。

适用边界

它适合在测试通过、行为稳定的代码上工作,但不适合用于性能关键路径、尚不理解的行为、准备整体重写的模块,或已经足够清晰的代码。简化的目标是降低理解成本,而不是机械减少行数。

使用场景

  • 功能已通过测试但实现嵌套过深,需要在不改变行为时拆出 guard clause 与短函数。
  • 代码审查中指出长函数和布尔参数,需要在提交前把它整理成选项对象或独立函数。
  • 合并多个分支后出现重复逻辑,需要识别重复块并提取共享函数。
  • 准备重构赶工期时写的模块,需要在保持测试通过下清理 dead code 和误导命名。

适合人员

  • 负责把功能代码整理成可评审变更的后端工程师。
  • 需要清理重构范围并降低 diff 噪声的技术负责人。
  • 希望把复杂业务逻辑拆成清晰函数的前端工程师。
  • 需要区分重构与功能改动并单独提交交付的资深工程师。