技能写好了,SKILL.md 在文件夹里,引用到的说明和脚本也放进去了。上传之后你发现:有的请求会加载它,有的该用时却没加载;有时明明加载了,输出还是老样子。
这时候最容易做错的事,是把说明、示例、脚本一起大改一遍,然后说一句“好像好一点了”。官方的办法更慢,也更稳:先验收,再小步改,一次只动一处。
一、按顺序验收:先文件,再加载,最后看输出

官方 how-to 把测试拆成几步,别跳步:
- 先看
SKILL.md是否清楚,description有没有写对适用时机,引用到的文件是否都在。 - 用 Claude Code 的,可以把技能放到
~/.claude/skills/my-skill/SKILL.md,在任意项目里启动claude,用一句符合 description 的任务看它会不会自己加载,或直接输入/my-skill调用。加载不起来,先改 description。 - 上传到 claude.ai 或桌面端后,到 Customize > Skills 打开这个技能,发几条应该触发的请求,并看它的思考过程,确认技能确实被加载。
- 只确认会加载还不够,还要看有技能之后输出有没有真的变好。
二、准备两组触发句子,再做功能测试
触发测试的目标很具体:明显任务要加载,换种说法也要加载,无关话题不要加载。

【应触发】
- (最直白的那句任务,含技能要处理的对象或专名)
- (换一种说法,意思相同)
- (再换一种场景表述,仍属于同一类任务)
【不应触发】
- (完全无关的问题)
- (看起来像同一大类、其实不该由这个技能接手的请求)
功能测试再看:输出对不对,该跑的脚本有没有跑,出错时怎么表现,边界情况会不会垮。想证明技能有用,可以对照没有技能时的基线:官方示例里写过,没有技能时来回很多轮、还可能调用失败、token 消耗也更高;那些数字是示例,别当成你自己的结果。
三、触发不对,优先改 description
Claude 在决定要不要加载技能之前,读到的是名称和 description;正文要等加载之后才会被读到。所以触发不对时,先改 description,别先去改一大段步骤说明。
- 欠触发:该用的时候没出现。补上关键词,写清适用场景,让“做什么”和“何时用”都具体一点。
- 过触发:不相关的请求也加载了。把不适用的边界写进 description,收窄触发条件。
官方还要求用第三人称来写,不要写成“我可以帮你……”或“你可以用它来……”。还有一条经验:先在一个难任务上迭代到能做成,再把成功的做法抽出来写进技能,然后扩展测试集,不要一上来就铺很多假想场景。
四、一次改一处,用真实请求再测
每次改完,用真实请求再跑一遍,不要一次改一大包。改了 description,就先把应触发和不应触发的句子再测一遍;改了步骤或脚本,就再看功能测试有没有回退。

官方提供的 skill-creator 可以帮你出测试提示、查看结果、修改技能:在 claude.ai 上到 Customize > Skills 打开,官方标明它来自 Anthropic。它的能力随入口不同,写法也不完全一样——在聊天里是一条一条跑测试提示,结果只出现在对话中;在 Cowork 和 Claude Code 里,它还会用同一组提示做无技能基线对照、并行跑,并补上通过率、耗时和 token 数。Claude Code 里需要按官方说明安装为插件。
有两点别记混:完整指南的测试一章写过,它不跑自动化测试套件、也不给量化评估;而一篇介绍更新的官方文章则写了评测和基准模式。先按你当前入口实际能看到的结果来用,能做基线对照就做,不能就手动跑有技能和无技能各一次。
把失败案例带回给 skill-creator 时,可以说清楚:用这次对话里出现的问题和解决办法,改技能里对应的那一处。
五、一分钟速查表
| 你遇到的症状 | 先查哪里 | 怎么改 |
|---|---|---|
| 该触发时没触发 | description 的适用场景 | 补关键词,写清做什么、何时用 |
| 无关请求也被加载 | description 的边界 | 写清不适用场景,收窄条件 |
| 加载了但输出没变好 | 功能测试与基线对照 | 每次只改一处,用真实请求复测 |
| 改了不知道是哪处起作用 | 改动的范围 | 一次只动一个地方 |
六、常见问题
技能文件都对,就是加载不起来,怎么办?
先查 description,它是加载前唯一会被读到的部分;再确认当前入口的技能目录放对了没有。
要不要一次把示例、脚本、步骤全补齐?
不要。先把一件事在难任务上做对,再抽取成技能,然后逐步扩展测试集。
skill-creator 会自动跑评测、给通过率吗?
不同入口不一样:在 Cowork 和 Claude Code 里会给通过率、耗时和 token 数,聊天里是逐条跑提示、结果只在对话中。以你当前入口看到的为准。
官方示例里的回合数和 token 数能直接引用吗?
不能。那是示例形态,要用你自己的真实请求对照。
来源与编译
- Create custom skills|https://claude.com/docs/skills/how-to
- Testing and iteration|https://claude.com/resources/guides/the-complete-guide-to-building-skills-for-claude/testing-and-iteration
- Skill best practices|https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
- 站内旧文:Claude:自定义技能/可复用流程入门|https://www.kmhgame.com/claude-zi-ding-yi-ji-neng-ke-fu-yong-liu-cheng-ru-men/
- 说明:本文为编译整理,非逐字实测;界面文案与开关以你本机客户端、官方现页为准(核验日 2026-11-16)。原文与资料版权归各出处所有。