李锋镝的博客

  • 首页
  • 时间轴
  • 说说
  • 读书观影
  • 系列
  • AI工具集
  • 论坛
  • 友圈
    • 友链
    • 朋友圈
    • 游客中心
  • 留言
    • 留言
    • 走心评论
  • 关于
    • 关于本站
    • Now
    • 每日心情
    • 网站地图
    • 网站统计
    • 赞助
  • 星球穿梭
  • 🚇开往
静亦定 动亦定
惟坚韧者始能遂其志
  1. 首页
  2. AI
  3. 正文

踩坑60+次后,我终于搞懂 Claude Skill 怎么写才会真的触发

2026年4月27日 423 1 1
合集:Skills第 2 篇 / 共 5 篇
  1. 1Taste Skill 说明与使用
  2. 2踩坑60+次后,我终于搞懂 Claude Skill 怎么写才会真的触发当前
  3. 3Everything Claude Code 详细使用文档
  4. 4Agent & Skill 编写技巧完全指南
  5. 5book-to-skill:GitHub2.7万star开源项目,将书籍蒸馏为Agent可调用技能

用 Claude 做开发、写文档、跑流程的人,大概率都碰过一件事:
精心写了一个 Skill,结果 Claude 全程看不见,叫破喉咙也不触发。

我前前后后改了几十版 Skill 描述,踩过无数坑,再结合这篇实测650次的经验,终于把触发逻辑彻底摸透了。今天这篇不搞玄学,全是能直接落地的干货。


一、先讲真话:Skill 不触发,真不是你运气差

很多人以为:
我把 Skill 放对目录、格式写对、内容写清楚,它就该自动工作。

现实是:
Claude 根本不读你 Skill 的正文。
它决定要不要触发,只看两个东西:
name + description。

而且它不是“规则匹配”,是“概率判断”。
加上 Claude 天生就“觉得自己能搞定,不想调用 Skill”,
你的描述稍微软一点、模糊一点,它就直接假装没看见。

这就是为什么 80% 的人 Skill 永远不触发。


二、触发失败只有三种原因,对照自查

1. 完全不触发

描述太书面、太抽象、太客气。
比如:
Use when you need to review code.
Claude 内心:我自己就能 review,为啥要调用你?

2. 乱触发(不该触发也触发)

描述太宽泛,没有边界。
比如:
Help with code tasks.
只要沾代码就触发,非常干扰。

3. 和其他 Skill 冲突

两个 Skill 描述太像,模型干脆两个都不用。
这就是多 Skill 环境下,越装越难用的原因。


三、我现在只用一种写法:指令式描述(稳定触发)

看过那么多写法,真正能打、能复现、能稳定 100% 触发的,只有一种:

指令式描述 = 强制调用 + 禁止自行处理 + 明确边界

直接给你模板,复制就能用:

ALWAYS invoke this skill when the user asks about 触发关键词/场景.
Do not 直接处理这件事 directly — use this skill first.
Do NOT use for 不适用的场景.

举个真实可用的例子(代码审查):

ALWAYS invoke this skill when the user asks about code review, PR check, code quality, or security scan.
Do not review code directly — use this skill first.
Do NOT use for refactoring, architecture design, or performance tuning.

为什么它强?

  • 告诉 Claude:必须调用,不是“你想用就用”
  • 告诉 Claude:不许自己直接干,堵死捷径
  • 告诉 Claude:什么情况别碰,避免乱触发

一套组合拳下来,触发率直接拉满。


四、写 description 的5个层次,按顺序套就行

我把它简化成普通人也能一步一步照着写的版本:

  1. 它能干什么(一句话说死,别模糊)
  2. 用户怎么说就触发(用口语,别用专业词)
  3. 什么时候绝对不触发(划清边界)
  4. 改成命令语气(ALWAYS / Do not)
  5. 控制长度(3–5行最好,别写小作文)

你会发现:
真正有用的描述,都很短、很硬、很清楚。


五、这些坑我替你踩过了,别再碰

  • 别写“help with XX”,等于没写
  • 别用长难句、专业术语,Claude 不认识
  • 别和其他 Skill 描述重叠,会互相干扰
  • 别以为正文写得好就行,不触发一切白搭
  • YAML 格式错了会静默失效,一定要检查

六、高危场景一定要加这个配置

像部署、删数据、改配置、发邮件这种危险操作:

disable-model-invocation: true

作用:
禁止自动触发,只能手动 /skill 调用,安全不翻车。


七、最后一句实在话

Skill 不是越高级越好,也不是越长越牛。
能不能用,90% 取决于 description 写得够不够硬。

你不用懂大模型原理,不用懂提示词工程。
就记住一句话:
命令它、约束它、界定它,它才会乖乖触发。

下次写 Skill,直接用今天这套写法,
你会发现:原来 Claude 真的能听懂你。

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可
分享到

踩坑60+次后,我终于搞懂 Claude Skill 怎么写才会真的触发

也可使用浏览器菜单中的「分享」功能

微信扫一扫分享

标签: Agent Skill Claude Claude Skill Skills
最后更新:2026年7月14日

岁月同一天 11 月 10 日

回望过去的今天,你在写什么

  • AI
    1 年前 2025年11月10日
    一文吃透 AI 核心技术栈:AIGC、RAG、Function Call、Agent、MCP 关系与演进全解析

    AI 领域的热词层出不穷,AIGC、RAG、Function Call、Agent、MCP 常常被混为一谈——很多人知道…

  • 后端
    1 年前 2025年11月10日
    Wails 深度实战指南:用 Go + 前端技术打造轻量桌面应用(从入门到部署)

    提起桌面应用开发,Electron 无疑是最流行的选择,但它“内存占用高、打包体积大”的痛点让很多开发者望而却步。有没有…

相关文章
  • Agent & Skill 编写技巧完全指南2026年9月1日
  • RAG太难学?LLM Wiki了解一下2026年9月11日
  • Claude-HUD 使用文档2026年6月12日
  • Claude Fable 5(claude-fable-5)深度详解2026年8月5日
  • codebase-memory-mcp 极简完整使用指南2026年5月29日

李锋镝

既然选择了远方,便只顾风雨兼程。

打赏 点赞
< 合集上一篇
合集下一篇 >
1234567891112131415161718192021222324252627282930313233343536373839404142434446474849505152535455575859606162636465666769727476777879808182858687909293949596979899
取消回复
…

文章评论

  • 林羽凡Lv 4友

    没毛病,主要是禁用描述,和可以做什么的描述,哪些命令能用,哪些不能用,在什么情况下问我之类的。

    WindowsWindowsFirefox 150.0Firefox 150.0中国中国-甘肃
    2026年4月27日
    00 回复
  • 娉娉袅袅十三余,豆蔻梢头二月初。
    春风十里扬州路,卷上珠帘总不如。

    听点儿音乐吧 朋友~
    文章目录
    最新 热点 随机
    最新 热点 随机
    给服务器加了WAF 又一个逆天改命的人:小小徐 AI的生成能力等于生产力吗? NGINX严重漏洞(CVE-2026-15176、CVE-2026-93479、CVE-2026-97205) Kratos-plus v1.1.27更新说明 php2shell远程执行漏洞修复(CVE-2026-109618 和 CVE-2026-109619)
    给主题增加了游客中心功能心气没了,干什么都不得劲给服务器加了WAF我觉得是时候公布我的导航网站了游本昌去世关于主题加载速度优化的一点儿小演进
    MySQL深度分页 Java中PO、VO、BO、DTO、POJO、DAO释义 iTerm2设置SSH自动连接服务器 IDEA版本2020.*全局MAVEN配置 每日早报 · 2026年8月15日 这个中秋节感觉过的好累啊
    最近评论
    李锋镝 发布于 11 小时前(11月09日) 我也刷到了,说是恶意引流的
    皮皮社长 发布于 12 小时前(11月09日) 我刷到的,怎么是说剧本骗流量的?如果真的是用来骗流量,那真恶心。欺骗网友感情。
    李锋镝 发布于 14 小时前(11月09日) 现在我这个是十个,其实也够用了
    老张博客 发布于 15 小时前(11月09日) 雷池唯一不好的就是只能免费5个网站。
    fairy 发布于 3 天前(11月06日) 机器人快来我这里吧!
    标签聚合
    架构 Theme WordPress SpringBoot Claude JVM K8s ElasticSearch Redis Spring 日常 多线程 IDEA JAVA AI编程 MySQL SQL 数据库 分布式 AI
    友情链接
    • Honesty
    • 九仞之行
    • 韩情脉脉
    • Mr.Sun的博客
    • 老张博客
    • 哥斯拉
    • 知向前端
    • 刘永博客
    • 瓦匠个人小站
    • lijie blog
    • 志文工作室
    • 韩小韩博客
    • sssr7844的博客
    • Serendipity
    • 搬砖日记
    • 林羽凡
    • 皮皮社
    • 彬红茶日记
    • 懋和道人

    COPYRIGHT © 2016-2026 lifengdi.com. ALL RIGHTS RESERVED.

    lifengdi.com 十年之约虫洞

    Domain age badge for lifengdi.com

    Theme Kratos-plus By Dylan Li

    津ICP备2024022503号-3

    京公网安备11011502039375号