Agent Skills
返回列表
💻

代码精简化

开发编程 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

功能已经跑通、测试也绿了,但实现里嵌套过深、函数过长、命名含糊,每次改 bug 都要把整段逻辑在脑子里重走一遍。更糟的是 code review 被揪出「能看懂但不好改」,或者在赶工期合并后留下重复分支和同一段条件判断散落在多个文件里。Code Simplification 针对的是这类「行为正确、表达过重」的代码:目标不是少几行,而是让新同事读得更快、你本人 debug 时更少停顿。

技能如何工作

技能把简化当成有纪律的流程,而不是随手删注释。五条原则里最关键的是 Preserve Behavior Exactly:只改表达方式,输入输出、副作用、边界与错误路径必须一致;拿不准就别动。其余原则强调跟项目既有风格对齐、宁可直白也别炫技、警惕过度内联和为了行数砍抽象,以及默认只动本次改动范围内的代码。

The Simplification Process 分四步:

  1. 理解再动手(Chesterton's Fence):先弄清某段逻辑、某个 helper 或错误处理为什么存在,再决定能否删或并。
  2. 按信号找机会:对照技能里的模式表——深层嵌套、50+ 行长函数、嵌套三元、布尔参数旗标、重复条件、泛化命名、重复逻辑、死代码等,每项都对应可操作的改法(守卫子句、拆函数、选项对象、提取谓词函数等)。
  3. 一次只做一处、每步跑测试:重构与功能/修 bug 分 PR;超过约 500 行改动量则考虑 codemod 而非手改。
  4. 整体验证:对照清单确认测试未改预期仍通过、diff 干净、未削弱错误处理;若「简化版」反而更难读,应回滚。

技能还列出常见借口(「能跑就别动」「类型已经自文档化了」)与 Red Flags,例如简化后必须改测试才算过、或顺手大改无关模块。

适用边界

别在还没读懂业务语义时就动手;别动已清晰可读仅为「洁癖」的代码;性能敏感且简化版会可测变慢时不要换;整块模块即将重写时也别在弃用代码上精雕细琢。简化若需要删掉本应保留的「为什么」注释或错误分支,那不是简化,是埋雷。

使用场景

  • 功能验收通过后,要把某次需求里刚合入的长函数和三层嵌套拆成可 review 的小步提交。
  • Review 评论指出 `doThing(true,false,true)` 式布尔参数和重复 `if`,需要按技能表格改成守卫子句或选项对象。
  • 合并分支后发现两处复制粘贴的业务校验,要在不改对外行为的前提下提取共享函数并单独开重构 PR。
  • 赶工留下的嵌套三元与 `data`/`temp` 命名让新人读不懂,要在跑通测试的前提下按增量步骤改名与展平控制流。

适合人员

  • 负责合并他人 PR 并要写清「复杂度/命名」意见的后端或全栈维护者
  • 刚接手遗留模块、需要在不造新 bug 前提下让控制流更易追踪的 feature owner
  • 习惯把重构与需求混在一个 PR 里、想按技能要求拆提交的研发负责人
  • 在 CI 全绿后专门安排「可读性收尾」、又怕动到边界行为的资深工程师