技能

文档告诉助手 事情是怎样的，技能告诉它 这件事该怎么做。

比如「发布新版本」：从打标到上线有固定的顺序和几处必须停下来确认的地方。 写成技能之后，助手在你说「发个版」时就照这套做，不用你每次盯着它一步步讲。

一份正文，各家格式

不同的 AI 助手各有各的技能格式和存放位置。鹿灯的做法是：你只维护一份正文， 各家格式由鹿灯生成。目前支持 Claude、Codex 和 Trae。

这意味着你换助手、或者同时用好几个，技能不用重写。

怎么写一个技能

技能有三部分：

标题——人读的名字，也用来生成文件名。

何时使用——一句话，说清 什么情况下该用这个技能。

这一句最重要，因为助手是靠它决定要不要加载这个技能的。它得回答「什么时候用我」， 而不是「我是什么」：

✓ 在需要发布新版本时使用：涵盖打标、镜像与上线三段的顺序与必须确认的地方。

✗ 发布流程说明。

第二种写法助手匹配不上，技能就永远不会被用到——等于没写。

正文——具体的步骤或判据。建议分三段：

## 何时使用
（哪些情形该触发它；越具体越容易被正确匹配）

## 怎么做
（步骤或判据。能给命令就给命令，能给判据就给判据）

## 边界
（什么情况不适用；已知的坑与反例）

「边界」最常被省略，也最值得写——助手最容易犯的错不是不会做， 而是在不该用这个技能的地方用了它。

正文里不要写死某一家助手的路径或工具名。同一份正文要生成好几家的格式， 写死一家在别家就是错的。写「打开本技能的说明文件」，别写具体路径。

用户级还是项目级

技能可以归在某个项目下，也可以是用户级的——用户级的技能在你所有项目里都可用。

「怎么写提交信息」这类跨项目的习惯适合用户级；「这个项目怎么发版」适合放在项目下。 归属随时可以改。

改了之后

技能改过之后，装过它的助手下次用到时会自动更新到新版本。你不用挨个去通知。

没改的时候助手直接读它本地那份，不重复传输——所以技能写长一点也不会拖慢它。

停用

不想再让助手用某个技能，把它停用。停用之后：

• 助手取不到它的内容；
• 已经装过它的机器，下次用到时会被告知删掉本地那份——所以停用是真的停用， 不会有哪台机器还在偷偷按旧技能干活；
• 技能本身还在你的列表里（灰显），随时可以重新启用。

从现有的技能导入

如果你的机器上已经有写好的技能文件，可以直接导入鹿灯，之后就由鹿灯统一管理和分发。