Skill 是什么
Skill 是一份按需加载的作业说明。模型平时只看见名字和触发条件,任务对上了才读步骤和附件。它不是模型,也不是工具。
工程里最容易混的是五样东西。混在一起的结果通常是:系统提示词越写越长,该做的检查仍然没人做。
| 东西 | 什么时候出现 | 负责什么 |
|---|---|---|
| 系统提示词 | 每一回合都在 | 身份、硬边界、永远生效的几条规矩。写长了就挤占任务本身。 |
| 用户提示词 | 这一次 | 眼前的目标。下次还得重写,也没法保证另一个人按同一套步骤做。 |
| 工具 | 被调用时 | 动手:读文件、跑命令、搜网页、调接口。工具不决定该不该这么做。 |
| 检索 | 被查询时 | 往上下文里补事实。补进来的是资料,不是流程。 |
| Skill | 描述匹配之后 | 何时用、步骤、如何验证、何时停下,以及可选的模板和脚本。 |
为什么要拆出来
上下文不是免费的。把代码审查、发版、写周报、对账全部写进系统提示词,模型每回合都在读用不上的规矩,真正的 diff 反而被挤到后面。
Skill 用的是渐进披露。目录里先暴露名字和描述,描述负责触发;正文、例子、脚本等任务匹配后再读。不匹配的流程不进上下文。这是省地方,也是避免无关规矩污染这一次判断。
一份 Skill 长什么样
当前这批编程 Agent,Claude Code、Codex 以及同类产品,形状大体一样:一个目录,里面一份 SKILL.md。开头是名字和描述。描述写触发条件,不要写“帮助写代码”。正文是步骤。旁边可以放模板、检查清单、脚本。
脚本是工具能执行的动作。Skill 只告诉 Agent 何时去跑、跑完看什么。Skill 不授予权限。它不能自己放开沙箱,也不能替你确认。能写哪些目录、哪些命令要人点头,仍是 Agent 的边界。
---
name: review-diff
description: 用户要求审查当前改动,且仓库里已经有 diff 时使用。不要用于从零实现功能。
---
1. 只读 diff,先列出行为变化。
2. 对照现有测试,指出缺的断言。不补测试,除非用户接着要求。
3. 发现与本次改动无关的问题,单独列出,不要混进必须修改的项。
4. 不改文件。用户没有明确说“按审查结果改”就停。
好的和坏的
写得好的 Skill
一件事
审查 diff 是一件事。审查完再改代码是下一件事。塞在一起,触发条件就会糊。
触发条件具体
“仓库里有 diff,用户要审查”能判断。“写后端”不能判断,于是每次写代码都会把它拖进来。
步骤能核对
做完可以回答:看过 diff 没有,测试缺口列了没有,有没有偷偷改文件。
写了怎么停
信息不够、测试本身就是红的、diff 不属于这次任务,就停下来问,而不是继续找活干。
写砸了的 Skill
第二份系统提示词
把口味、安全禁令和所有业务知识都塞进去。结果它几乎每次都被加载,渐进披露名存实亡。
描述是口号
“帮助用户更好地编码”会在任何编程任务上匹配。匹配太宽,等于没有 Skill。
没有停止条件
Agent 会把一份说明读成“可以继续改,直到自己满意”。满意不是验收。
把权限写在正文里
“可以直接推送到主分支”不是 Skill 该决定的。权限在环境里。正文这么写,只是在引诱人把边界拆掉。
它在 Agent 里的位置
Agent 先判断这是不是该加载的活。加载之后,Skill 约束这一段流程,工具负责动手,模型负责拿不准的判断。三者缺一个,另外两个补不上。
Skill 写得再细,也不能代替跑一遍你指定的检查。步骤里如果写了“跑测试”,跑的是工具;判读失败输出的是模型;决定红了就停、不许改无关文件的,才是这份 Skill。