Skill 技能开发与应用 · 编写与封装 · 2026-03-21

搞不懂Skills?看看Claude Code内部工程师们是怎么玩的

还在为Skills开发头疼?Anthropic工程师分享Claude Code内部实战经验,教你打造高效实用的Skills。

核心内容:

  1. Skills的本质与常见误解解析
  2. 优秀Skills的分类与开发秘诀
  3. 团队内部数百个Skills的实战经验总结

你还在为你的龙虾笨笨的而烦恼吗?

你还在为找不到合适的 Skills 安装而焦头烂额吗?

你还在为网上找到的 Skills 可能不安全而心惊胆战吗?

养了这么久龙虾,是时候开始构建自己的 Skills 了。这时候,一篇来自 Anthropic 团队的 Skills 秘籍在外网广为流传,为想要构建 Skills 的开发者和智能体用户提供了绝佳的参考资料。

这篇文章来自于 Anthropic 的 Claude Code 团队工程师,Skills 功能核心参与者 Thariq Shihipar。内容大多是 Anthropic 内部使用 Skills 的实战经验和总结。

我们对该博客进行了全文编译,希望读者从中获取关于 Skills 制作、使用和推广分发相关的经验。

以下是博客全文:

Skills 已经成为 Claude Code 中使用最广泛的扩展方式之一。它们灵活、易于创建,也方便分发。

但这种灵活性也带来了一个问题:很难判断什么才是最佳实践。什么类型的 Skills 值得开发?写出一个优秀 Skill 的秘诀是什么?又应该在什么时候将它们分享给他人?

在 Anthropic 内部,我们已经在 Claude Code 中广泛使用 Skills,目前有数百个 Skills 在实际运行中。

这些是我们在使用 Skills 来加速开发过程中总结的一些经验。

什么是 Skills ?

如果你刚接触 Skills,建议先阅读我们的文档:

相关链接:https://code.claude.com/docs/en/skills

本文默认你已经对 Skills 有一定了解。

我们经常听到一个常见的误解:认为 Skills「只是一些 Markdown 文件」。但实际上,Skills 最有趣的地方在于 —— 它们并不仅仅是文本文件,而是一个文件夹,里面可以包含脚本、资源、数据等内容,供智能体进行发现、探索和操作。

在 Claude Code 中,Skills 还具备多种配置选项,包括注册动态钩子(hooks)等。

相关链接:https://code.claude.com/docs/en/skills#frontmatter-reference

我们发现,一些最有意思的 Skills,正是通过巧妙利用这些配置选项和文件结构来实现的。

Skills 类型

在整理我们所有 Skills 之后,我们发现它们大致可以分为几个常见的类别。

最好的 Skills 通常能够清晰地归类到一个类别中,而那些更为复杂或难以理解的 Skills,则可能跨越多个类别。这并不是一个权威的分类列表,但它为你判断在你的组织中是否缺少某些类型的 Skills 提供了一个很好的思路。

  1. 库与 API 参考

这些 Skills 解释如何正确使用库、CLI 或 SDK。这些 Skills 可以是针对内部库,也可以是针对 Claude Code 在使用常见库时遇到困难的库。它们通常包含一组参考代码片段,以及 Claude 在编写脚本时应避免的一些常见问题。

示例:

  1. 产品验证

这些 Skills 描述了如何测试或验证代码是否正常工作。它们通常与外部工具(如 Playwright、tmux 等)配合使用,以进行验证。

验证 Skills 对确保 Claude 输出正确非常有用。可能值得让工程师花一周时间,专注于提高验证 Skills 的质量。

考虑使用技术,例如让 Claude 记录它的输出视频,这样你就可以准确看到它测试了什么,或者在每个步骤上强制进行状态的程序化断言。这些通常通过在 Skills 中包含各种脚本来实现。

示例:

  1. 数据抓取与分析

这些 Skills 连接到你的数据和监控系统。这些 Skills 可能包括库,用于通过凭证、特定的仪表盘 ID 等抓取数据,以及常见工作流或获取数据的方式说明。

示例:

  1. 业务流程与团队自动化

这些 Skills 将重复的工作流自动化为一个命令。虽然这些 Skills 通常是相对简单的指令,但可能有更复杂的依赖关系,涉及其他 Skills 或 MCP(多控制点)。

对于这些 Skills,将先前的结果保存在日志文件中有助于保持模型的一致性,并反映工作流的前期执行。

示例:

  1. 代码脚手架与模板

这些 Skills 用于生成代码库中特定功能的框架模板。你可以将这些 Skills 与可组合的脚本结合使用。它们在你的脚手架有自然语言要求,而这些要求无法仅通过代码覆盖时尤为有用。

示例:

  1. 代码质量与审核

这些 Skills 强制执行你组织中的代码质量并帮助审查代码。它们可以包括确定性的脚本或工具,以确保最大程度的稳健性。你可能希望将这些 Skills 自动运行,作为钩子的一部分或 GitHub Actions 中的一部分。

示例:

— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/tishicikuangjia/2026032109536.html