你还在为你的龙虾笨笨的而烦恼吗?
你还在为找不到合适的 Skills 安装而焦头烂额吗?
你还在为网上找到的 Skills 可能不安全而心惊胆战吗?
养了这么久龙虾,是时候开始构建自己的 Skills 了。这时候,一篇来自 Anthropic 团队的 Skills 秘籍在外网广为流传,为想要构建 Skills 的开发者和智能体用户提供了绝佳的参考资料。
- 博客标题:Lessons from Building Claude Code: How We Use Skills
- 博客链接:https://x.com/trq212/status/2033949937936085378
这篇文章来自于 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 提供了一个很好的思路。
- 库与 API 参考
这些 Skills 解释如何正确使用库、CLI 或 SDK。这些 Skills 可以是针对内部库,也可以是针对 Claude Code 在使用常见库时遇到困难的库。它们通常包含一组参考代码片段,以及 Claude 在编写脚本时应避免的一些常见问题。
示例:
- billing-lib — 你的内部账单库:边缘情况、常见陷阱等
- internal-platform-cli — 你内部 CLI 包装器的每个子命令,并提供何时使用它们的示例
- frontend-design — 使 Claude 更好地理解你的设计系统
- 产品验证
这些 Skills 描述了如何测试或验证代码是否正常工作。它们通常与外部工具(如 Playwright、tmux 等)配合使用,以进行验证。
验证 Skills 对确保 Claude 输出正确非常有用。可能值得让工程师花一周时间,专注于提高验证 Skills 的质量。
考虑使用技术,例如让 Claude 记录它的输出视频,这样你就可以准确看到它测试了什么,或者在每个步骤上强制进行状态的程序化断言。这些通常通过在 Skills 中包含各种脚本来实现。
示例:
- signup-flow-driver — 在无头浏览器中运行注册 → 邮件验证 → 入职流程,并在每个步骤上进行状态断言
- checkout-verifier — 使用 Stripe 测试卡驱动结账界面,验证发票是否真正落入正确的状态
- tmux-cli-driver — 用于需要 TTY 的交互式 CLI 测试
- 数据抓取与分析
这些 Skills 连接到你的数据和监控系统。这些 Skills 可能包括库,用于通过凭证、特定的仪表盘 ID 等抓取数据,以及常见工作流或获取数据的方式说明。
示例:
- funnel-query — "我需要哪些事件来查看注册 → 激活 → 付费" 以及实际包含标准 user_id 的表
- cohort-compare — 比较两个群体的留存率或转化率,标记统计显著的差异,链接到细分定义
- grafana — 数据源 UID、集群名称、问题 → 仪表盘查找表
- 业务流程与团队自动化
这些 Skills 将重复的工作流自动化为一个命令。虽然这些 Skills 通常是相对简单的指令,但可能有更复杂的依赖关系,涉及其他 Skills 或 MCP(多控制点)。
对于这些 Skills,将先前的结果保存在日志文件中有助于保持模型的一致性,并反映工作流的前期执行。
示例:
- standup-post — 汇总你的任务追踪器、GitHub 活动和 Slack 内容 → 格式化的站立会议,仅显示增量变化
- create--ticket — 强制执行模式(有效的枚举值、必填字段)以及创建后工作流(通知审阅者、在 Slack 中链接)
- weekly-recap — 合并的 PR + 关闭的票据 + 部署 → 格式化的周报
- 代码脚手架与模板
这些 Skills 用于生成代码库中特定功能的框架模板。你可以将这些 Skills 与可组合的脚本结合使用。它们在你的脚手架有自然语言要求,而这些要求无法仅通过代码覆盖时尤为有用。
示例:
- new--workflow — 使用你的注释脚手架一个新的服务 / 工作流 / 处理器
- new-migration — 你的迁移文件模板以及常见的坑
- create-app — 新的内部应用,预先配置你的认证、日志记录和部署
- 代码质量与审核
这些 Skills 强制执行你组织中的代码质量并帮助审查代码。它们可以包括确定性的脚本或工具,以确保最大程度的稳健性。你可能希望将这些 Skills 自动运行,作为钩子的一部分或 GitHub Actions 中的一部分。
示例:
- adversarial-review — 启动一个新鲜眼光的子智能体进行批评,实施修复,迭代直到反馈降级为小瑕疵
- code-style — 强制执行代码风格,特别是 C…