如何写好一个 skill:从定位问题到对症下药

 

 大家在工作里用 skill 的时候,是不是遇到过这种场景:

听说某个 skill 特别好用,跑去 GitHub 一看,star 好几千,评论区一片「神器」「效率翻倍」。你装好后满怀期待地丢了个真实任务进去,结果模型跑出来的东西,要么抓不住重点,要么纠结一堆无关紧要的格式问题,跟大家吹的完全对不上。折腾了一下午,最后默默把它删了,心里嘀咕一句:是不是我用得不对?

如果你有过这种经历,我想先说一句:大概率不是你的问题,那个 skill 多半也写得没毛病。它只是从一开始,就没打算为你而写。

那我们该如何写出一个好用的skill呢?

要讲清楚这件事,得先从 skill 到底是个什么东西说起。

什么是skill?

简单说,skill 是一包你预先准备好、交给模型在合适时机自己取用的「专项知识和工具」。

你可以把它想象成给一个能力很强、但对你这摊业务一无所知的新人,准备的一份份「专项操作手册」。新人本身很聪明,通用的活儿都会干,但你们团队那些约定俗成的规矩、那些只有老员工才知道的坑、那套特定格式的交付物,他不可能凭空知道。于是你把这些整理成一份份手册,平时收在柜子里,等他真碰到对应的活儿,再抽出那一本来看。

skill 干的就是这件事。它把某一类操作的流程、规范、踩坑经验,连同可能用到的代码和模板,打包成一个独立的单元。模型平时不用管它,一旦遇到对应的场景,再把它「取出来」按需使用。

为什么 skill 好用:关键在「渐进式加载」

要理解 skill 为什么有效,得先理解大模型的一个软肋。

我们和大模型交互,靠的是上下文窗口。直觉上你可能觉得,把所有信息一股脑全塞给它,它知道得越多就答得越好。但实际恰恰相反:上下文里的信息越多、越杂,模型反而越容易出问题。该关注的重点被淹没,不相关的内容互相干扰,最后模型开始「一本正经地胡说八道」——这就是我们常说的大模型幻觉。

skill 的机制,正是冲着这个问题来的,它的核心叫渐进式加载。

模型启动时,并不会把每个 skill 的全部内容都读进上下文。它看到的,只是一份轻量的清单——每个 skill 叫什么、什么时候该用。只有当它判断「眼下这个任务正好对得上某个 skill」,才会把那个 skill 的详细内容真正读进来。需要里面更细的参考资料或脚本时,再进一步去取。

这样一来,上下文里始终只装着「当下这件事真正需要的东西」,干净、聚焦,模型自然更不容易跑偏。这也是 skill 比一份巨长的系统提示词更高明的地方:它把信息按场景拆开,用的时候才加载。

先破除一个误区:skill 不只是一个 markdown 文件

很多人对 skill 的理解,停留在「写一个 SKILL.md,告诉模型该怎么做」。Claude 团队特意点明了这个误区——skill 其实是一个文件夹,里面可以放脚本、参考代码、模板、数据,模型能去发现、读取、调用这些东西。

这个认知差,直接决定了你能写出什么层次的 skill。

如果你只把它当一段 prompt,那你能塞进去的就只有文字。但如果你把整个文件目录都当成可以调度的资源,事情就完全不一样了。需要一段固定格式的输出?放个模板文件让模型去 copy。有套取数的逻辑反复要用?写成函数库塞进去,让模型直接调,而不是每次现写。文档太长?拆成几个 reference 文件,让模型按需去读,需要哪块读哪块。

一个完整的 skill 都包含什么

它的结构大致长这样:

暂时无法在飞书文档外展示此内容

其中 SKILL.md 的开头是这样:

暂时无法在飞书文档外展示此内容

SKILL.md 是整个 skill 的入口和大脑,也是唯一必需的组件。开头的 frontmatter 里,name 给它一个清晰的身份,description 则负责告诉模型「什么情况下该触发我」——这是模型判断要不要用这个 skill 的依据,所以要把最关键的使用场景写在最前面。frontmatter 下面的正文是核心指令,讲清这类任务怎么做、有哪些规范和坑,并且要尽量精简,因为它一旦加载就会在整个会话里占用上下文。

剩下的都是按需调用的支撑材料:篇幅长事实依据的细节拆进 reference,对照样例放进 examples,固定格式的产出物给一份 template 模板,可复用的代码塞进 scripts/。关键是要在 SKILL.md 里点名它们、说清各自装了什么,模型才会在恰当的时机去读或去执行。这套结构之所以高效,靠的正是前面说的按需加载:SKILL.md 常驻且轻量,参考资料和示例等真用上了才读,脚本只在执行时才跑——上下文里始终只装着当下真正需要的东西。这几样配合起来,skill 才从「一段提示词」变成「一套能被模型调度的工具」。

网上有哪些 skill 的来源?

现在能找到 skill 的地方不少:像 Clawhub 这样的聚合站、Anthropic 官方的 skills 仓库、各家模型厂商陆续推出的技能商店,都是现成的来源。

Clawhub链接:ClawHub Anthropic skill仓库:https://github.com/anthropics/skills

但用过一圈你就会发现,很多 skill 并没有它们宣传的那么好用,或者他离你所期望的效果…

— 以上为试看内容(约 40%),开通会员后阅读全文 —