Skill 是文件夹,不只是提示词
Skill 可以带脚本、数据和配置;最值钱的是踩坑清单,description 要写成触发条件而不是摘要。
读书笔记原文:《Claude 内部工程师总结的 Skills 经验全在这了》↗小互(整理自 Thariq Shehata《Lessons from Building Claude Code: How We Use Skills》) · xiaohu.ai
为什么读
原文作者是 Anthropic 负责 Claude Code Skills 系统的工程师,讲的是他们内部真实在用的做法。对想自己写 Skill 的人来说,这比泛泛的教程更有用。
我记下的要点
- Skill 是一个文件夹。 里面可以放脚本、模板、数据,Agent 会自己发现和使用。Claude Code 里的 Skill 还能配置,比如注册 Hooks。
- 九类 Skill。 原文分了库与 SDK 知识、验证、数据监控、工作流自动化、脚手架、代码审查、部署、调试排查、运维九类。验证类被认为值得花一整周打磨。
- 只写 Claude 不知道的。 Claude 本来就有很多默认偏好,Skill 要纠正它的惯性。例子是前端设计 Skill 要避开千篇一律的 Inter 字体和紫色渐变。
- 踩坑清单(Gotchas)信息密度最高。 从 Claude 常见的失败点里一条条积累。大多数 Skill 起步时只有几行字加一条踩坑记录,之后慢慢补。
- 渐进式披露和 description。 用 references/、assets/ 分层放内容,告诉 Claude 有哪些文件,它按需去读。description 是触发器,Claude 启动时只看这份清单决定要不要调用,所以要写明什么时候用。
- 会话级护栏。 例如 /careful 在调用后拦截 rm -rf、DROP TABLE、force-push 这类危险命令;/freeze 禁止改目录以外的文件,调试时防止误改。
我的想法
「description 是触发器,不是摘要」这条对我最有用。直觉上会想写一段概括,但对 Skill 来说,Claude 需要知道的是「什么情况下该叫我」,而不是「我是什么」。这和写产品需求时区分「功能描述」和「使用场景」很像。
小互在文章里补充说,他自己的 Skill 大多集中在工作流自动化,验证和调试几乎空白。我猜很多人都会这样,因为自动化最容易看到效果。但结合 Boris 那篇讲的「让 Claude 能验证自己」,验证类可能才是更值得补的。
/freeze 这种护栏思路也值得记住:与其在提示词里反复叮嘱别乱改,不如直接把范围锁死。
我打算试试
- 给网站写一个小 Skill,第一版只写几行说明和一条踩坑记录
- 把这个 Skill 的 description 改写成「什么时候用」的触发条件