跳至内容

软件技术分享

关于电子游戏的方方面面

  • 游戏产业
    • 行业杂谈
    • 开发者采访
  • 游戏设计
    • 专题学习
    • 设计制作
  • 游戏热点
    • 游戏评测
    • 攻略与资料
    • 流行游戏
  • 工具指南
  • AI
    • AI新闻
    • 使用心得
  • 沙雕应用
  • 游戏7×24小时
  • 关于妙游社

技能写完先验收:触发不对,先改 description

作者 2026年11月16日 10:34

技能写好了,SKILL.md 在文件夹里,引用到的说明和脚本也放进去了。上传之后你发现:有的请求会加载它,有的该用时却没加载;有时明明加载了,输出还是老样子。

这时候最容易做错的事,是把说明、示例、脚本一起大改一遍,然后说一句“好像好一点了”。官方的办法更慢,也更稳:先验收,再小步改,一次只动一处。

一、按顺序验收:先文件,再加载,最后看输出

验收三步:文件 → 加载 → 输出

官方 how-to 把测试拆成几步,别跳步:

  1. 先看 SKILL.md 是否清楚,description 有没有写对适用时机,引用到的文件是否都在。
  2. 用 Claude Code 的,可以把技能放到 ~/.claude/skills/my-skill/SKILL.md,在任意项目里启动 claude,用一句符合 description 的任务看它会不会自己加载,或直接输入 /my-skill 调用。加载不起来,先改 description。
  3. 上传到 claude.ai 或桌面端后,到 Customize > Skills 打开这个技能,发几条应该触发的请求,并看它的思考过程,确认技能确实被加载。
  4. 只确认会加载还不够,还要看有技能之后输出有没有真的变好。

二、准备两组触发句子,再做功能测试

触发测试的目标很具体:明显任务要加载,换种说法也要加载,无关话题不要加载。

触发测试要成对准备句子
【应触发】
- (最直白的那句任务,含技能要处理的对象或专名)
- (换一种说法,意思相同)
- (再换一种场景表述,仍属于同一类任务)

【不应触发】
- (完全无关的问题)
- (看起来像同一大类、其实不该由这个技能接手的请求)

功能测试再看:输出对不对,该跑的脚本有没有跑,出错时怎么表现,边界情况会不会垮。想证明技能有用,可以对照没有技能时的基线:官方示例里写过,没有技能时来回很多轮、还可能调用失败、token 消耗也更高;那些数字是示例,别当成你自己的结果。

三、触发不对,优先改 description

Claude 在决定要不要加载技能之前,读到的是名称和 description;正文要等加载之后才会被读到。所以触发不对时,先改 description,别先去改一大段步骤说明。

  • 欠触发:该用的时候没出现。补上关键词,写清适用场景,让“做什么”和“何时用”都具体一点。
  • 过触发:不相关的请求也加载了。把不适用的边界写进 description,收窄触发条件。

官方还要求用第三人称来写,不要写成“我可以帮你……”或“你可以用它来……”。还有一条经验:先在一个难任务上迭代到能做成,再把成功的做法抽出来写进技能,然后扩展测试集,不要一上来就铺很多假想场景。

四、一次改一处,用真实请求再测

每次改完,用真实请求再跑一遍,不要一次改一大包。改了 description,就先把应触发和不应触发的句子再测一遍;改了步骤或脚本,就再看功能测试有没有回退。

skill-creator 能帮你做什么

官方提供的 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)。原文与资料版权归各出处所有。

相关阅读

  • Claude 防封偏方,1693 条记录验一遍
  • DeepSeek:直出 3D,它写完了看不出哪儿不对
  • Codex 能跑不等于对,架构并发别放手
  • Claude Code 账单差 3 倍,前缀缓存被冲掉
  • Grok Bot 当新员工带:先接应用再交活
  • DeepSeek:日志分析,只把五条样本发出去

浏览更多「AI」文章 ›

  • 一、按顺序验收:先文件,再加…
  • 二、准备两组触发句子,再做功…
  • 三、触发不对,优先改 des…
  • 四、一次改一处,用真实请求再…
  • 五、一分钟速查表
  • 六、常见问题
  • 技能文件都对,就是加载不起来…
  • 要不要一次把示例、脚本、步骤…
  • skill-creator …
  • 官方示例里的回合数和 tok…
  • 来源与编译

文章导航

上一篇Codex 装依赖要联网:开一次就够,别解开沙箱
下一篇Grok 该续旧线程还是开新窗:看材料还在不在

相关文章

Claude 防封偏方,1693 条记录验一遍 Claude 防封偏方,1693 条记录验一遍 DeepSeek:直出 3D,它写完了看不出哪儿不对 DeepSeek:直出 3D,它写完了看不出哪儿不对 Codex 能跑不等于对,架构并发别放手 Codex 能跑不等于对,架构并发别放手

沙雕应用推荐

给猫起名机 给猫起名机 丢两个词进去,吐出猫自己都不会答应的名字。 去玩一下 ↗

评测设计产业杂谈

软件技术分享

关于电子游戏的方方面面

栏目

  • 游戏产业
  • 游戏设计
  • 游戏热点
  • 工具指南
  • AI
  • 沙雕应用
  • 游戏7x24小时
  • 关于妙游社

本站

  • 首页
  • 隐私政策
  • 联系我们
  • 关于妙游社
  • 工具指南专题
  • 文章 RSS

关注公众号

沙漏社公众号二维码

© 2026 软件技术分享

沪ICP备19032461号-1

目录

×
  • 一、按顺序验收:先文件,再加载,最后看输出
  • 二、准备两组触发句子,再做功能测试
  • 三、触发不对,优先改 description
  • 四、一次改一处,用真实请求再测
  • 五、一分钟速查表
  • 六、常见问题
    • 技能文件都对,就是加载不起来,怎么办?
    • 要不要一次把示例、脚本、步骤全补齐?
    • skill-creator 会自动跑评测、给通过率吗?
    • 官方示例里的回合数和 token 数能直接引用吗?
  • 来源与编译
→ 目录