乐于分享
好东西不私藏

文档,还是技能?我卡住的一个小问题

文档,还是技能?我卡住的一个小问题

最近在打磨一份材料,整个过程中沉淀了一些自己的写作讲究——比如不写没有来源依据的话,不引用查不到出处的数字,凡是有时效的说法都用最新的口径,诸如此类,等等。等让 AI 帮我更新或检查的时候,能照着一条条核对。

规矩本身不难。难的是定完之后,我卡在一个很小、却绕不过去的选择上:

这份规矩,我到底该存成一份文档,用的时候翻出来读;还是做成一个技能,让 AI 自己判断什么时候该用它?

两个都行,但总觉得该有个更对的选法。后来想清楚了,觉得值得写下来——因为凡是开始拿 AI 认真干活的人,迟早都会撞上这个岔路口。

一句话的分界

先把结论摆出来:

文档,是“你得记得去加载”的东西;技能,是“AI 自己判断该加载”的东西。

文档是内容本体。它老老实实躺在那儿,等你想起来、翻出来、喂给 AI。它是真源,所有的规矩都住在里面。

技能不是文档的升级版。它是薄薄的一层调度——一句“我该在什么时候出场”的说明,加上一个指向文档的地址。它自己不存内容,只负责在对的场景,把对的文档喊起来。

打个比方:文档像一本手册,平时安安静静放在那儿;技能像一个记性很好的助手——你一动手做某类事,它就想起来“该翻这本手册了”,替你递到手边。真正的内容永远在手册里,助手只是省掉你自己记着去翻的那一步。

那到底什么时候,值得请这么个“助手”?

不是越自动越好。我给自己定了三条,占齐了才值得从文档升成技能:

一是会反复来。同一类活隔三差五就出现一次,每次要守的规矩都差不多。只用一次的事,犯不上。

二是场景能被一句话认出来。AI 能凭“我又在做这类事”这种信号,自己反应过来该用它。认不出来的,自动不了。

三是你确实嫌每次手动喊它烦。手动翻文档一点没错,只是你想省掉“记得去加载”这一步。

反过来,一次性的、只给人看一眼的、靠一个结论就够的东西——就让它安安静静当文档,别包技能。给一件小事套一层机制,是另一种浪费。

更新时,只动一个地方

真正让我第二次卡住的,是更新。

有了文档和技能两样东西之后,人最容易犯的错,是两边各改一份,改着改着——两份对不上了,自己都不知道该信哪个。

想通之后其实很简单:改内容,只改文档,技能会自己读到最新的;只有新增一个领域、或者文件改了名,才回头动技能那一层。

技能里永远不存正文的副本。这样就不存在“两份不一致”这回事。

一句话收口:改内容找文档,改结构找技能。文档越攒越厚,技能每次读到的都是最新那份。

卡住我的,其实不是技术

写到这儿我想说点别的。

这次真正卡住我的,从来不是“技能怎么做”这种技术问题。是边界感——两个东西长得太像,我分不清各自站在什么位置,只能凭感觉选,还怕选错。

而想通它之后我发现,这背后是一个更大的判断,值得反复用:

什么东西,该沉淀成一份“随时能翻出来的本体”;什么东西,该做成一个“会自己找上门的机制”。

这个判断,不只管文档和技能,也管我怎么安放攒下的每一样东西。

还有一件事我越来越确信:我卡住的地方、我问出口的每一个“这俩到底啥区别”,才是最值得记录分享的,因为别人也可能会遇到这个问题。答案会过时,今天这套说法明年可能就被更好的取代;但一个真实的人,在真实的活里,到底会在哪儿犯难、为什么犯难——这个不会过时。