建立 Claude Code 的经验：我们如何使用 Skills

原文链接的观点是，claude.com/blog/lesson…

从原文作者来看。Thariq Shihipar

在 Anthropic 内部建立并规模化数百个 Skills 的过程中，我们学到了什么。

使用者痛点：在海量可用的 Skills 中。开发者常常不知道该优先实现哪些，导致时间和资源浪费。

Skills 已成为 Claude Code 中使用最广泛的 点之一。它们灵活、易于创建，也易于分发。

但正是这种灵活性，让人很难判断什么做法最好：什么样的 Skills 值得做？如何组织一个 Skill？什么时候该与他人共享，

使用者痛点：缺乏统一的组织规范，使得团队在搜索、维护和复用 Skills 时效率低下。

在 Anthropic。我们已在 Claude Code 中大量使用 Skills，活跃使用的数量达数百个。

什么是 Skills？

Skills 是包含指令、脚本与资源的文件夹。智能体可以发现并使用它们，从而更准确、更高效地完成任务。这篇文章假定读者已了解 Skills 基础；若你是新手，请先从我们的 Skilljar 上的智能体 Skills 入门课程 开始。

在 Claude Code 中。Skills 还有 多种配置选项，包括注册动态钩子。

发现。Claude Code 里一些最有效的 Skills，会善用这些配置选项与文件夹结构。说起来，

Skills 的类型

在盘点 Anthropic 内部所有 Skills 后发现它们大致可归为九类。 怎么说呢，最好的 Skills 能清晰归入其中一类；试图做太多事的 Skills 往往会横跨多类，反而让智能体困惑。这不是一份权威清单，但它是识别你自身 Skills 库缺口的实用框架。

Claude Code 团队将内部 Skills 分类，发现可归入九个不同类别。

. 库与 API 参考

这类 Skills 说明如何正确使用某个库、CLI 或 SDK。既可以是内部库，也可以是 Claude Code 有时处理不好的常见库。这类 Skills 常包含参考代码片段文件夹，还有 Claude 写脚本时应避开的 gotcha 列表。

• billing-lib — 你们内部的计费库：边界情况、踩坑点等。说起来，
• internal-platform-cli — 内部 CLI 包装器的每个子命令。还有何时使用它们的示例，
• sandbox-proxy — 为开发工作配置组织的 egress 网关：哪些主机可达、如何调试「connection refused」错误、如何添加 allowlist 条目。

. 产品验证

这类 Skills 描述如何测试或验证代码是否正常工作。它们常与 Playwright、tmux 或其他外部验证工具配合使用。

使用者痛点：缺少统一的验证流程导致手动调试成本高、错误复现困难。

在内部，验证类 Skills 对 Claude 输出质量的可衡量影响最大。让一名工程师花一周时间把验证 Skills 做到优秀，往往是值得的。

可以考虑这方面。让 Claude 录制其输出视频，以便你确切看到它测了什么；按理说，或在每一步对状态做程序化断言。这些通常通过在 Skill 中包含多种脚本实现。

• signup-flow-driver — 在无头浏览器中跑完注册 → 邮件验证 → 新手引导，并在每一步用 hook 断言状态。
• checkout-verifier — 用 Stripe 测试卡驱动结账 UI，验证发票是否真正进入正确状态。
• tmux-cli-driver — 用于交互式 CLI 测试，被验证对象需要 TTY 时使用。说起来，

. 数据获取与分析

This category connects your data and monitoring stack.

• funnel-query — 「要 join 哪些事件才能看 signup → activation → paid」。还有真正存放 canonical User_id
.

• ...