代码简化助手
将以下提示词粘贴到你的 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 噪声的技术负责人。
- 希望把复杂业务逻辑拆成清晰函数的前端工程师。
- 需要区分重构与功能改动并单独提交交付的资深工程师。