一个链接,我把 100 多页官方文档变成了 AI 的技能包

大家好，我是悟鸣。

现在越来越多的活都交给 AI 干了，但有一样东西还停在「给人看」的时代：文档。

我一直觉得，文档其实分两类：一类是写给人看的，讲究通俗易懂；另一类，其实应该是写给 AI 看的。毕竟文档一多，人先没耐心读完，AI 才是那个能逐字逐句全部啃完的「读者」。

既然活让 AI 干，资料又没人愿意一页页翻，那就得让文档本身变得更适合 AI 来读。

我之前分享过把最佳实践封装成技能包的经验：不能被转成 Skill 的最佳实践，都只是过眼云烟

最典型的场景就是接入新框架：官方文档几十上百页，结构繁琐，每次查都要翻半天。这种时候，与其让 AI 一次次现查现翻，不如直接把整个文档站变成一个技能包，让它随取随用。

于是，我做了一个「白泽 Skill」：你只管丢给它一个文档链接，它会把这个文档所在的整个目录抓下来，自动转换成一个 Wiki 技能包。

「白泽」这个名字，取自中国上古神话中「黄帝遇白泽」的传说（主要记载于《云笈七签·轩辕本纪》，后世衍生出《白泽图》）。

传说黄帝东巡至东海边（东望山）时，遇见神兽白泽。白泽能言，通晓天下鬼神精怪，向黄帝一口气讲清了 11,520 种精怪的名称、形态、习性和应对之法。黄帝命人把这些内容绘制记录下来，编成《白泽图》——白泽也因此成为「知晓万物、驱邪避凶」的瑞兽。

白泽 Skill 做的事，和这只神兽一模一样：把散落在 Wiki 导航和页面里的知识逐一辨识、归类、记录，编成 Agent 能快速检索的「图鉴」，就像当年白泽为黄帝点破万千精怪。

这个技能不只是简单地把文档抓下来然后做成一个技能包，它在构建的时候会保持层级关系。另外，如果做更新的时候，它只更新发生变化的这些文档。它还会进行覆盖率检查、链接索引，以及索引之间的创建。

安装只需要一句话：

装好之后，用起来更简单，直接说一句「使用白泽 Skill生成一个 xxx 的 Wiki」就行。

中间过程全自动。比如我们之前处理的 Jev 模型文档，它一口气自动抓了 100 多页。

整个过程相当严谨，一步都不省：

全部处理完之后，它会自动装进当前智能体的 Skills 目录。下次只要提到相关关键词，技能包就会被自动触发，随叫随到。

遇到相关的问题，直接问就可以了。

我们不只是让它回答问题。如果你让它写相关代码，它会基于技能包里沉淀的文档内容，写得更规范、更贴合官方用法。

举个真实的例子。前段时间我在研究 DeepSeek Harness，想让它帮我写插件，但每次都要打开官网翻文档，特别麻烦。

后来我用白泽 Skill，把官方文档直接装成了 Wiki 技能包。

再让它基于 DeepSeek Harness研发插件，整个过程顺畅了非常多。省掉的不仅是翻文档的时间，更是反复核对用法的沟通成本。

当然，我也不建议把所有文档都一股脑变成技能包。技能包会占用上下文，只有那些最关键、最高频使用的文档才值得这么做；什么都往里装，反而会浪费上下文、拖累效果。

把最关键的文档喂给 AI，让它带着完整的知识上场干活，剩下的，交给它就好。