SKILL.md 怎么写才好用：我踩过的 4 个坑
我遇到的具体问题
有阵子我每天都要让 WorkBuddy 帮我做同一件事：把一段中文需求翻译成给开发看的英文 ticket。重复了快两周，我想干脆写个技能，让它自动接手。
第一版 SKILL.md 我写得特别简单，就一句话描述：“把中文需求转成英文开发任务”。结果呢？我每次说“帮我把这个需求写成英文”，WorkBuddy 要么当普通对话处理，要么加载了别的技能。它根本不知道该用我这个。
为什么这事值得自动化
这种“每天来一遍、步骤固定”的活，最适合做成技能。我粗略算过：每次手写英文 ticket 大概八分钟，一天一两趟，一个月就是四个多小时。做成技能之后，说一句话就出稿，省下的时间够我摸鱼好几回。
但前提是技能真能被触发、真能按想的来。写不好，比手动还心累。
我是怎么用 WorkBuddy 做的
我后来把 SKILL.md 重写了一遍，关键改动有四处（也就是后面那四个坑）。写完之后，用 SKILL 生成器 帮我按规范补齐了标准段落，省得自己记格式。
现在只要我说“把这个需求英文一下”，它稳稳加载这个技能，按我定的结构出 ticket：背景、验收标准、技术要点分三段，每次都一个样。
中间卡在哪 & 怎么绕过去
四个坑，挨个说：
坑一：描述太虚。 “把中文需求转成英文”这种写法 WorkBuddy 判断不了什么时候该用。改成“把中文产品需求翻译成给研发看的英文 ticket，含背景/验收标准/技术要点”——具体了，触发就准了。
坑二：忘了写触发词。 光有描述不够，得显式告诉它“用户说’英文一下’’写 ticket’时就用我”。没有触发词，它得靠猜。
坑三：文件命名不规范。 我一开始存成 myskill.md，结果没被识别。规范是用小写中划线，比如 zh-ticket-en.md，大小写转换工具 能一键把驼峰或空格转成这种格式。
坑四：没写边界。 该技能只处理“中文转英文 ticket”，但我不说清楚，它偶尔会把普通的英文润色也揽过去。在 SKILL.md 里写明“只处理研发 ticket，其他英文需求不接”，之后就干净了。
顺带的几个发现
写出第一个好用的技能之后，我上瘾了，接连把“每日签到的检查”“周报汇总”都做成了技能。最大的发现是：技能不是写完就完，而是越用越能发现哪里该加边界、哪里描述该改。
大小写转换工具 成了我建文件前的固定动作——再也不会因为命名格式不对导致技能加载失败。
你也可以这样用
挑一个你每周至少重复三次、步骤固定的活，先手把手做一遍并记录步骤，再照着“描述要具体 + 写清触发词 + 规范命名 + 划清边界”这四条改写 SKILL.md。别一上来写十个，先让一个跑顺。
常见问题
Q：技能一直不被触发怎么办？ 九成是描述或触发词太含糊。把“做什么”和“用户什么情况下用”都写死，别留模糊空间。
Q：一个技能里能放多个步骤吗？ 能，而且应该放。技能就是为“多步骤固定流程”设计的，把完整流程写进去比拆成一堆小技能好维护。
Q：命名真的影响加载吗？ 影响。WorkBuddy 按约定识别技能文件，大小写和中划线格式不对就可能扫不到。不确定就用转换工具统一成小写中划线。