本页目录7
要点速览
- Skills 是「文件夹形式的指令、脚本与资源」,可归纳为 9 大常见类别,覆盖从 API 参考到基础设施运维
- 「产品验证」类 Skills(用 Playwright、tmux 做验证)被认为对 Claude 输出质量提升最明显
- 写 Skill 时应聚焦「反直觉的坑」而非复述 Claude 已知的常识,并善用文件夹分层做渐进式披露
- description 字段要为模型决策而写,不是为人类阅读,加入触发词(如「babysit」)能提高识别率
- 用 append-only 日志或 JSON 文件让 Skill 具备跨会话记忆,用可执行脚本减少样板代码生成
- 分发上可用 ./.claude/skills 仓库内置、插件市场,或「沙盒共享仓库 → 官方市场」的有机成长路径
本文是对 Anthropic 官方文章「Lessons from Building Claude Code: How We Use Skills」的中文要点摘要,完整内容以原文为准:https://claude.com/blog/lessons-from-building-claude-code-how-we-use-skills
概述
这篇发布于 2026 年 6 月 3 日的文章,分享了 Anthropic 内部团队在 Claude Code 中构建数百个 Skills 的实战经验。官方对 Skills 的定义是:「一组可被 agent 发现并使用的文件夹,里面包含指令、脚本和资源」。
九类常见 Skills
- 库与 API 参考:讲清楚某个库、CLI 或内部工具的正确用法与「坑」,例如计费库、内部 CLI 封装、代理配置指南。
- 产品验证:测试并验证代码是否真的按预期工作,常借助 Playwright、tmux 等工具。官方特别强调,这类「验证型」Skills 是对 Claude 输出质量提升「最明显可衡量」的一类。
- 数据拉取与分析:对接数据/监控栈,例如漏斗查询、群组对比分析、Grafana 与 Datadog 集成。
- 业务流程与团队自动化:自动化重复性工作流,如站会播报、工单创建、周报生成。
- 代码脚手架与模板:生成框架样板代码,如新工作流生成器、迁移模板、建新应用。
- 代码质量与评审:落地团队规范,如对抗式评审流程、风格检查、测试实践。
- CI/CD 与部署:管理构建与部署流程,如 PR 监控、灰度发布、cherry-pick 工作流。
- Runbooks(运行手册):跨多工具的排查流程,如服务调试、oncall 值班助手、日志关联分析。
- 基础设施运维:带护栏的常规运维任务,如孤儿资源检测、依赖管理、成本排查。
写好 Skill 的要诀
- 避免写「废话」:不要复述 Claude 本来就知道的通用知识,而要聚焦领域特有、可能挑战模型默认假设的信息。
- 专设「坑」章节:把迭代中踩过的常见失败点写下来,比如某张表是 append-only 的、字段命名不一致、staging 环境的特殊行为等。
- 善用文件系统结构做渐进式披露:把 Skill 组织成文件夹,配合
references/api.md、assets/templates/等子文件,让 Claude 按需查阅细节,而不是一次性塞进主 prompt。 - 不要过度写死:提供必要信息的同时保留灵活性,让 Claude 能适应不同场景变化。
- 考虑配置需求:配置信息放进
config.json;遇到缺失上下文时,可提示用户补充,或使用AskUserQuestion工具做结构化提问。 - 为模型而非人类写 description:Skill 的描述字段是给模型做「要不要调用这个 Skill」的决策依据,应包含容易被模型识别的触发词(比如文中举例的「babysit」),而不是写成给人看的文档摘要。
- 靠日志实现跨会话记忆:用 append-only 的文本日志或 JSON 文件存数据,帮助 Claude 记住之前执行过什么、有哪些变化。
- 附带可执行脚本:提供可复用的代码库和函数,让 Claude 专注于「组合调用」而不是每次都重新生成样板代码。
- 按需启用 hooks:针对可选行为使用会话级 hooks,例如
/careful用来阻止破坏性操作,/freeze用来限制写权限。
分发策略
- 仓库内置:把 Skills 提交进
./.claude/skills目录,团队内统一代码库即可共享使用。 - 插件市场:搭建内部插件市场,让各团队按需选装 Skill 并附带安装配置流程,避免不必要的 Skill 塞满模型上下文。
- 有机成长模式:Skill 最初往往是个人上传到共享仓库的「沙盒」版本,受欢迎的 Skill 再通过 PR 的方式「毕业」进入官方市场。
Skill 之间的依赖管理
一个 Skill 可以直接按名字引用另一个已安装的 Skill,从而实现组合式复用,不需要额外搭建正式的依赖管理体系。
效果度量
可以用 PreToolUse hook 记录 Skill 的调用日志,借此识别哪些 Skill 使用率高、哪些利用不足(本站引申:可作为后续维护和淘汰的依据)。
上手入口
- 官方文档:https://code.claude.com/docs/en/skills
- 示例 Skills 仓库:https://github.com/anthropics/skills
文章最后强调:Skill 通常都是从一个很简陋的版本开始,随着实际使用中暴露出的边界情况不断迭代完善。