笔记 · AI 工作流 ·

Skill 是文件夹,不只是提示词

Skill 可以带脚本、数据和配置;最值钱的是踩坑清单,description 要写成触发条件而不是摘要。

读书笔记原文:《Claude 内部工程师总结的 Skills 经验全在这了》↗小互(整理自 Thariq Shehata《Lessons from Building Claude Code: How We Use Skills》) · xiaohu.ai

为什么读

原文作者是 Anthropic 负责 Claude Code Skills 系统的工程师,讲的是他们内部真实在用的做法。对想自己写 Skill 的人来说,这比泛泛的教程更有用。

我记下的要点

  1. Skill 是一个文件夹。 里面可以放脚本、模板、数据,Agent 会自己发现和使用。Claude Code 里的 Skill 还能配置,比如注册 Hooks。
  2. 九类 Skill。 原文分了库与 SDK 知识、验证、数据监控、工作流自动化、脚手架、代码审查、部署、调试排查、运维九类。验证类被认为值得花一整周打磨。
  3. 只写 Claude 不知道的。 Claude 本来就有很多默认偏好,Skill 要纠正它的惯性。例子是前端设计 Skill 要避开千篇一律的 Inter 字体和紫色渐变。
  4. 踩坑清单(Gotchas)信息密度最高。 从 Claude 常见的失败点里一条条积累。大多数 Skill 起步时只有几行字加一条踩坑记录,之后慢慢补。
  5. 渐进式披露和 description。 用 references/、assets/ 分层放内容,告诉 Claude 有哪些文件,它按需去读。description 是触发器,Claude 启动时只看这份清单决定要不要调用,所以要写明什么时候用。
  6. 会话级护栏。 例如 /careful 在调用后拦截 rm -rf、DROP TABLE、force-push 这类危险命令;/freeze 禁止改目录以外的文件,调试时防止误改。

我的想法

「description 是触发器,不是摘要」这条对我最有用。直觉上会想写一段概括,但对 Skill 来说,Claude 需要知道的是「什么情况下该叫我」,而不是「我是什么」。这和写产品需求时区分「功能描述」和「使用场景」很像。

小互在文章里补充说,他自己的 Skill 大多集中在工作流自动化,验证和调试几乎空白。我猜很多人都会这样,因为自动化最容易看到效果。但结合 Boris 那篇讲的「让 Claude 能验证自己」,验证类可能才是更值得补的。

/freeze 这种护栏思路也值得记住:与其在提示词里反复叮嘱别乱改,不如直接把范围锁死。

我打算试试

  • 给网站写一个小 Skill,第一版只写几行说明和一条踩坑记录
  • 把这个 Skill 的 description 改写成「什么时候用」的触发条件