技能市场里能装的包很多,但总有一些「只有你公司才用得到的流程」——比如你们特有的周报格式、某类合同的审核清单。这些没必要等别人做,自己写一个 Skill 固化下来,以后一句话就能调出来用。本文用「公文写作助手」做例子,走完从零到能用的全过程。
一、两条创建路径,选顺手的
路径一:用 skill-creator 自动生成
在对话框里直接说:
WorkBuddy 会调用内置的技能创建能力,根据你刚才的对话自动生成一套 SKILL.md。适合不想碰文件结构的人。
路径二:手动从零写
想完全掌控内容、或者流程比较私密,就自己写。下面重点讲这条。
二、SKILL.md 长什么样
一个 Skill 就是一个文件夹,里面至少放一个 SKILL.md。文件分两段:开头是 YAML 元数据,后面是写给 AI 看的正文指令。
这里有个关键点:description 是 AI 判断「要不要调用这个技能」的特有依据。把触发词、能力、场景都写进去,它才会在对的时刻自动启用。写给人看的描述(「这是一个好用的助手」)没用,要写给 AI 执行的指令。
三、放对目录,重启生效
文件夹命名用 kebab-case(小写中划线),结构如下:
把文件夹放到 ~/.workbuddy/skills/你的技能名/ 下,重启 WorkBuddy,它就能被识别了。scripts/ 和 references/ 不是必须的,纯提示词类技能有 SKILL.md 就够。
四、触发测试 + 迭代
重新开一次对话,说出你写在 description 里的触发词,比如「帮我写一份给街道办的通知」。观察它是不是按你定义的流程走。第一次往往有偏差,这是正常的,回去改 SKILL.md,通常迭代两三次就稳了。
五、两个常见坑
1. description 写太虚
只写「写作助手」,AI 分不清什么时候该用它。把具体触发词列出来,命中率立刻上来。
2. 正文写成「文档」而不是「指令」
记住一条原则:SKILL.md 是写给 AI 执行的命令,不是给人看的说明书。越具体越好——角色、步骤、输出格式、注意事项,一条条写清。
固化一个私有流程,本质是把自己的经验「外包」给 AI。你花十分钟写一次,之后每次都用一句话省下十分钟,这笔账怎么算都值。