来自Claude Code工程师的分享，Skills 完整指南。- 大数跨境

首页

来自Claude Code工程师的分享，Skills 完整指南。

渔夫 AIDaily

2026-03-20

hi，我是渔夫。

今天，分享来自 anthropic 负责 Claude Code 方向的工程师，他在 x 上分享了在内部 Skills 使用的经验。

在 Anthropic 内部，Skills 早就成为使用最为广泛的扩展点之一了，而且是大量使用 Claude Code 的 Skills，目前有数百个处于活跃使用状态。

但是，因为太灵活了，让人很难知道什么才是最有效的。

哪类 Skills 值得做？写好一个 Skill 的秘诀是什么？什么时候该分享给别人？

以下是anthropic 内部，用 Skills 加速开发过程中总结出的经验，值得研究。

一、什么是 Skills？

首先，介绍了 Skills 并非大家误解是“markdown 文件”，而是文件夹，可以包含脚本、模板、数据、参考代码等都可以写进去。

这样，Agent 就可以自主发现，探索和操作这些文件夹内容。

二、Skills 的 9 种类型

1、库 & API 参考

用来说明，如何正确使用某个库，CLI 或 SDK等的 Skills。这类 Skills 常用是包含参考代码片段，和 Cluade 在编码时避免出错的清单。

Skills 示例：

billing-lib：内部计费库：边界情况、陷阱等
internal-platform-cli：你内部 CLI 封装器的每一个子命令，附带使用时机示例
frontend-design：让 Claude 更好地适配你的设计系统，前端设计 Skills

2、产品验证

这类 Skills 通常使用来描述如何测试或验证代码是否正常工作的。

如，AI 修改过功能，你可以让这个类 Skills 负责每一步对状态进行程序化断言。

Skills 示例：

signup-flow-driver：在无头浏览器中跑完注册 → 邮件验证 → 引导流程，并在每一步提供状态断言的钩子。
checkout-verifier：当在用 Stripe 时，可以测试卡驱动结账 UI，验证发票是否真正落到正确状态。
tmux-cli-driver：用于需要 TTY 的交互式 CLI 测试场景。

3、数据获取 & 分析

Skills 示例：

funnel-query：漏斗查询（如注册→激活→付费完整漏斗）
cohort-compare：对比两个用户群的留存或转化，标出统计显著的差异，并链接到分群定义
grafana：数据直接映射到对应 Dashboard

4、业务流程 & 团队自动化

把重复性工作流自动化为一条命令的 Skills。

Skills 示例：

standup-post：如，汇总你的 GitHub 活动和昨天的 Slack 内容，然后会生成格式化站会帖子，只呈现变化部分。
weekly-recap：合并的 PR + 关闭的 ticket + 部署记录 → 格式化的周报帖子

5、代码脚手架 & 模板

我们可以为代码库中特定功能生成框架样板的 Skills。

意思就是，可以把这些 Skills 与可组合的脚本结合使用，如当你的脚手架有纯代码无法完整表达的自然语言需求时，这类 Skills 尤其有用。

Skills 示例：

new-<framework>-workflow：用你的注解规范生成一个新的服务/工作流/处理器脚手架
new-migration：你的迁移文件模板加上常见坑
create-app：新建内部应用，预置好你的认证、日志和部署配置

6、代码质量 & 审查

通常在开发团队，都需要代码规范的 Skills。

它可以包含确定性脚本或工具以获得最大健壮性。你可能希望将这类 Skills 作为 Hooks 的一部分或在 GitHub Action 中自动运行。

Skills 示例：

adversarial-review：启动一个全新视角的 subagent 来批判代码，实施修改，反复迭代直到发现的问题。
code-style：团队要求的代码规范。
testing-practices：指定如何编写测试以及测试什么内容的指导。

7、CI/CD & 部署

这类 Skills 帮你把代码从本地一路送到线上。

Skills 示例：

babysit-pr：全程盯着 PR，自动重试、解冲突、合并，不用你守着
deploy-<service>：构建、测试、灰度发布一条龙，有问题自动回滚，运维团队爽飞了。
cherry-pick-prod：挑一个提交上生产，自动处理冲突并生成 PR

8、Runbook

服务部署后，可能收到一个报警或错误，自动走完排查流程，最后给你一份结构化报告。非常有价值的 Skills。

Skills 示例：

<service>-debugging：告诉你这个服务出问题该查哪里、用什么工具
oncall-runner：拿到告警，自动检查常见原因，输出排查结论
log-correlator：给一个 request ID，帮你把所有系统的相关日志都捞出来

9、基础设施运维

这里 Skills 主要负责日常维护和运维操作，涉及危险操作时会强制加确认步骤，防止手滑。

Skills 示例：

<resource>-orphans：找出没人用的 pods/volumes，然后发 Slack 通知，等你授权后再清理
dependency-management：走完公司内部的依赖审批流程

三、制作 Skills 的核心技巧

1. 不要说废话只写能推动 Claude 跳出惯性的信息，它已经懂的别写。

2. 重点写 Gotchas（避坑）Claude 踩过的坑都记进去，随时更新。这是整个 Skill 里信息密度最高的部分。

3. Skill 是文件夹，不是文件脚本、模板、参考代码都可以放进去，告诉 Claude 有哪些文件，它会自己去读。

4. 别把 Claude 逼死指令别太死板，给够信息，留出灵活空间。

5. 初始化配置用 config.json需要用户填的信息（比如 Slack 频道），存到 config.json，没配置就让 Claude 主动问。

6. Description 是触发条件，不是简介 Claude 靠它判断"要不要调用这个 Skill"，要写"什么场景下用"，不是"这个 Skill 是什么"。

7. 给 Claude 提供脚本和代码让 Claude 专注于"决定做什么"，而不是重复造样板代码。

8. 按需 Hooks 危险操作（删库、强推）用 /careful 临时开启护栏，不要一直挂着。

四、分发 Skills

小团队：直接把 Skills 提交到 repo 的 ./.claude/skills 目录
规模化：建立内部插件市场，让团队按需安装

值得注意的是：烂 Skill 和重复 Skill 很容易产生，上线前要有把关机制。

五、度量 Skills

为了了解一个 Skill 的效果，可以用 PreToolUse Hook 来记录公司内部的 Skill 使用情况。可以帮助哪些 Skill 很受欢迎，或者哪些的触发率低于预期。

原文：https://x.com/trq212/status/2033949937936085378?s=20