我们撰写 Skill 已经有几个世纪了。我们把它叫做书。

博客 · 阅读时间 5 分钟

让人给自己的 AI 智能体「写一个 Skill」，你会看到一种奇怪的怯场，仿佛这是一种从没人做过的写作。其实不是。一份食谱就是一个 Skill。一本野外手册就是一个 Skill。飞机座椅后背那张塑封安全卡、运维文件夹里的事故 runbook、你第一位编辑逼你读了两遍的风格指南——这些其实都是我们现在想交给智能体的同一样东西：这件事该怎么做，写下来，好让别人不用你在场也能做到。

真正新鲜的不是写作本身，而是读者。一本食谱是写给那些翻一遍、决定晚饭吃什么、顺便看看开场小故事的人的。智能体不想要那个故事。它想要的是烤箱温度、静置时间，还有「如果面团没发酵到两倍大，再等二十分钟，别瞎猜」。好的说明书里其实一直藏着这部分内容——只是被人类读者也想要的其他东西埋起来了，而智能体需要有人把它重新挖出来。

我一直做错的那部分

有一阵子，「写一个 Skill」对我来说几乎等同于翻译，而我很不擅长：读一章，把要点记在脑子里，再敲进一个文本框。我会记住那句听起来最有分量的话，却在两段之后把准确的数字弄丢了，因为那时候我早就不做笔记了。写出来的东西是原文的氛围，不是原文本身——听起来很自信，却在某个不起眼的地方是错的，直到智能体照着它走到我没想到的地方，我才会发现。

我接下来试过的办法更糟：把整章直接粘贴进去，指望智能体在压力之下自己找到对的那一段，就像把一本四十页的手册塞给别人，说「就在里面某处」。这两种做法都算不上真正在写一个 Skill。一种是把原始材料直接扔掉，另一种是拒绝去做把它变成 Skill 的那份工作。

改变了什么

Skilnu 那个「从文档起草」的功能，做的正是我一直不擅长的事：它会读取真正的文档——PDF、Word 文件、Markdown 导出——然后返回一份草稿 SKILL.md，保留的是细节，而不是氛围。什么都不会被发布。它只是停在撰写表单里的一份初稿，等着我在下游任何人看到之前，把它理解错的地方改过来。

真正改变的习惯，比听起来要小得多。我不再问「这件事该怎么跟智能体解释」，而是开始问「我是不是已经把这个写在什么地方了」。答案越来越经常是肯定的：某位离职同事写的入职文档，从那之后再没人打开过；一份过去以 PDF 形式存在、没人读过第一页之后内容的风格指南；一本我总是口头推荐、却懒得直接借出去的书里的一章。这些东西最后都只差二十分钟加一遍编辑，就能变成智能体真正能照着做的东西——而不只是我凭记忆胡乱转述的内容。

这并不意味着这些草稿就不需要编辑了。一个只读过你文档一次的模型，写出来的东西也带着「只读过一次」的痕迹：该给规则的地方给了摘要，原文含糊的地方它也照样含糊。这部分工作始终是你的，就像它一直以来都是那个为新读者改写手册的人的工作一样。消失的是从空白页开始、努力回忆第四章到底说了什么的那部分。

你的书架上早就摆满了这些

从零开始写一个 Skill 的冲动，把每一条智能体指令都当成一种全新的文档。其实不是。在你团队的 wiki 某个角落、运维柜子里的某个文件夹、或者一个真正的书架上，你希望智能体知道的大部分内容，早就被某个在乎把事情第一次就做对的人写下来了。这件事从来都不是「去写它」，而是终于承认——那本手册算数。