← 返回概念列表
学习进度6 / 6

技能的可维护性设计

Designing a skill for maintainability · AS.6 第 6 章 工程化:从需求到上线的技能开发全流程

一句话定义

一个技能应该拆成职责清晰的小模块、每一部分都写明白是干什么用的,避免堆成一大段又长又复杂的规则,这样未来不管是自己还是别人接手修改,都能只改需要改的那一小块而不用担心牵一发动全身。

机制 / 原理

技能会随着使用场景增多而不断修补——今天加一条例外规则,明天补一个新格式的支持,如果一开始就写成一整块耦合在一起的说明,后续每次修改都要重新读一遍全文才敢下手,还容易改了一处、破坏另一处没预料到的地方。把技能按功能模块拆开(比如输入校验、核心转换逻辑、输出格式分开写清楚各自的边界),并在每部分标注这一块负责什么、为什么这么设计,相当于给未来的自己或接手的人留了一张地图,修改时只需要定位到对应模块,不用通读全文猜哪句话对应哪种情况。

经典实验 / 例子

一个按不同学术期刊要求格式化参考文献的技能,如果所有期刊的格式规则混在一大段文字里,以后要新增一本期刊的格式就得从头翻一遍确认没有冲突。更好的做法是把通用的作者姓名处理规则和各期刊专属的标点、顺序差异分开模块写清楚,新增一本期刊时只需要在专属规则里加一段,不用动通用规则部分,也不会不小心影响到已经支持的其他期刊。

生活中的例子

类似搭乐高:把整体设计成一块块可以单独替换的模块,某一块想换个造型直接拆下来重搭就行;如果从头到尾拼成一整块粘死的造型,想改其中一小部分就得把整个作品拆掉重来。

常见误区

常见误区是觉得技能内容不多、没必要分模块,随手把所有规则写成一整段文字,短期内确实省事,但技能稍微复杂起来或者需要交给别人维护时,才发现连自己都很难看清楚哪句话管的是哪种情况。

资料来源:图解Skill:AI提效实战指南(宝玉,人民邮电出版社,2026年5月) · 第 6 章 · 第 AS.6 节 (CC BY 4.0)
本讲解由 AI 依据该教材与主流学术观点撰写,非逐字引用,仅供学习参考。