一句话定义
一个技能应该拆成职责清晰的小模块、每一部分都写明白是干什么用的,避免堆成一大段又长又复杂的规则,这样未来不管是自己还是别人接手修改,都能只改需要改的那一小块而不用担心牵一发动全身。
机制 / 原理
技能会随着使用场景增多而不断修补——今天加一条例外规则,明天补一个新格式的支持,如果一开始就写成一整块耦合在一起的说明,后续每次修改都要重新读一遍全文才敢下手,还容易改了一处、破坏另一处没预料到的地方。把技能按功能模块拆开(比如输入校验、核心转换逻辑、输出格式分开写清楚各自的边界),并在每部分标注这一块负责什么、为什么这么设计,相当于给未来的自己或接手的人留了一张地图,修改时只需要定位到对应模块,不用通读全文猜哪句话对应哪种情况。
经典实验 / 例子
一个按不同学术期刊要求格式化参考文献的技能,如果所有期刊的格式规则混在一大段文字里,以后要新增一本期刊的格式就得从头翻一遍确认没有冲突。更好的做法是把通用的作者姓名处理规则和各期刊专属的标点、顺序差异分开模块写清楚,新增一本期刊时只需要在专属规则里加一段,不用动通用规则部分,也不会不小心影响到已经支持的其他期刊。
生活中的例子
类似搭乐高:把整体设计成一块块可以单独替换的模块,某一块想换个造型直接拆下来重搭就行;如果从头到尾拼成一整块粘死的造型,想改其中一小部分就得把整个作品拆掉重来。
常见误区
常见误区是觉得技能内容不多、没必要分模块,随手把所有规则写成一整段文字,短期内确实省事,但技能稍微复杂起来或者需要交给别人维护时,才发现连自己都很难看清楚哪句话管的是哪种情况。