Skills（技能）已成为 Claude Code 中最强大、使用最频繁的扩充功能之一。它灵活、快速、易于共享 — 但这份灵活性也让许多开发者不知道「该建什么」以及「如何让它真正发挥效用」。

在 Anthropic，我们在生产环境中已建立并使用了数百个 Skills。本文整理了来自真实内部使用场景的设计模式、分类方法与实战经验，是一份「让 Claude Code 从通用 AI 助手进化为组织专属超级代理人」的完整实战手册。

什么是 Skills？打破「只是 Markdown 档案」的迷思

许多人仍然认为 Skills「只是 Markdown 文字档」。这只说对了一半。

一个 Skill 实际上是一个完整的资料夹，可以包含：

• 指令文件（Markdown 格式）
• 脚本（Bash、Python 等）
• 资源档案（范本、范例档案、图片）
• 资料（JSON、日志，甚至小型 SQLite 资料库）
• 设定档
• 动态钩子（如 PreToolUse 等事件触发器）

Claude 可以主动探索资料夹内的档案、按需读取、浏览子目录，甚至在适当时机修改内容。Skills 同时支援丰富的设定选项：包含钩子（hooks）的注册、让 Claude 能自动发现的描述设定等。

真正的威力，在于你如何创意地运用完整的资料夹结构。

Anthropic 内部使用的 9 大 Skills 类型

整理我们所有的 Skills 后，我们发现它们集中在以下几个反复出现的类别中。设计最干净、最高价值的 Skills，通常只专注在一个类别。而较杂乱的 Skills，往往是因为试图同时解决太多问题。

类型一：函式库与 API 参考

用途： 提供内部函式库、CLI 工具、SDK 或复杂第三方工具的专属知识。

重点包含：

• 常见陷阱与边界情况
• 范例程式码片段
• Claude 预设行为容易出错的使用模式

实际案例：

• billing-lib：整理计费函式库的边界情况与危险操作
• internal-platform-cli：子命令说明与使用时机
• frontend-design：强制执行公司专属的设计系统

类型二：产品验证

用途： 自动化流程，用来测试与验证程式码输出结果（通常搭配 Playwright、tmux 等工具）。

这类 Skills 杠杆效益极高，值得投入大量工程时间打磨。

常用技术：

• 录制浏览器或 CLI 操作的影片
• 在每个步骤进行程式化的状态断言

实际案例：

• signup-flow-driver：完整的「注册 → 验证 → 引导流程」并附带状态断言
• checkout-verifier：Stripe 测试卡号 + 发票状态确认
• tmux-cli-driver：互动式 TTY 终端机测试

类型三：资料抓取与分析

用途： 为你的监控与资料分析技术栈，预先打包好查询语句、仪表板与分析辅助工具。

实际案例：

• funnel-query：从「注册 → 启用 → 付费」的多表 JOIN 查询
• cohort-compare：留存率与转换率的差异分析，附显著性标记
• grafana：资料来源 UID、丛集名称、以及「症状 → 对应仪表板」的映射表

类型四：业务流程与团队自动化

用途： 一键自动化重复性的团队工作流程。通常由简单指令加上其他 Skills 的依赖组成，并善用日志来保持记忆与一致性。

实际案例：

• standup-post：汇整 Tickets + GitHub + 上次 Slack 讯息，只发送「差异更新」
• create-ticket：强制执行 Issue 格式规范，并触发建立后的后续工作流程
• weekly-recap：已合并 PR + 已关闭 Tickets → 格式化的每周回顾报告

类型五：程式码鹰架与范本

用途： 使用组织的精确惯例生成样板程式码，包含验证、日志、部署设定等必要的标准配置。

实际案例：

• new-<framework>-workflow：特定框架的工作流程起始范本
• new-migration：资料库迁移范本，附常见坑点提醒
• create-app：新应用程式的完整鹰架建立

类型六：程式码品质与审查

用途： 强制执行程式码风格、进行对抗性审查、引导测试流程。可以是确定性的脚本，也可以是代理式的 AI 任务。透过 Hooks 或 GitHub Actions 触发。

实际案例：

• adversarial-review：以「全新视角」提出批评 → 修正 → 反复迭代
• code-style：强制执行 Claude 预设行为容易忽略的程式码风格
• testing-practices：测试策略指引

类型七：CI/CD 与部署管理

用途： 守护部署流程，监控 PR 状态，处理渐进式推送与自动回滚。

实际案例：

• babysit-pr：重试不稳定的 CI、解决冲突、自动合并
• deploy-<service>：建置 → 冒烟测试 → 渐进式推送 → 自动回滚
• cherry-pick-prod：精挑提交到生产环境的工作流程

类型八：操作手册（Runbooks）

用途： 「症状 → 结构化调查 → 报告」的全流程处理。非常适合值班（on-call）场景。

实际案例：

• <service>-debugging：症状 → 工具 → 查询模式的完整指引
• oncall-runner：值班处理自动化
• log-correlator：依 Request ID 关联日志

类型九：基础设施维运

用途： 例行性的维运与维护（对破坏性操作设有防护机制）。

实际案例：

• <resource>-orphans：找出孤立资源 → 发送 Slack 通知 → 确认 → 清理
• dependency-management：依赖套件更新工作流程
• cost-investigation：帐单费用异常的根因查询

11 个实战最佳实践（Anthropic 内部使用心得）

1. 不要陈述显而易见的事

Claude 已经懂一般的程式设计最佳实践，也看得到你的程式码库。请专注在组织特有的知识，这些知识才能推动 Claude 脱离预设行为。

例：frontend-design 这个 Skill 是在反复迭代后，才成功让 Claude 戒掉「预设使用 Inter 字体 + 紫色渐层」的习惯。

2. 建立「常见坑点（Gotchas）」章节 — 这是含金量最高的部分

捕捉 Claude 真实踩过的错误，持续更新。 这通常是任何 Skill 中最有价值的部分。

3. 善用完整资料夹结构与渐进式揭露

让 Claude 只在需要时才读取特定档案：

skill/
├── SKILL.md              # 主要指令
├── references/
│   └── api.md            # 详细 API 签章
├── assets/
│   └── template.md       # 可直接复制使用的范本
└── scripts/              # 辅助脚本

4. 避免过度约束指令

Skills 是可复用的，因此要提供资讯与灵活度，而不是把 Claude 强制导入单一僵化的执行路径。

5. 支援设定与初始化

在 Skill 资料夹中放置 config.json。若设定档不存在，指示 Claude 向使用者询问（可使用 AskUserQuestion 工具进行结构化输入）。

6. Description 栏位是写给模型看的

这是 Claude 在 Session 开始时扫描、用来判断 Skill 是否相关的依据。 请以「触发条件描述」的方式撰写，而非人类阅读的摘要。

7. 透过档案实现记忆功能

在 Skill 资料夹（或更稳定的 ${CLAUDE_PLUGIN_DATA} 目录）中储存日志、JSON 或 SQLite 资料。

例：standups.log 让下次执行时，Claude 能看到上次的差异，只更新变动的部分。

8. 提供辅助脚本与函式库给 Claude 使用

让 Claude 能够组合使用，而不是每次都从头重写样板程式码。

例：提供资料抓取的辅助函式，让 Claude 能动态串接分析函数。

9. 按需启用钩子（On-Demand Hooks）

只在需要时才启用某些强制性行为：

• /careful：封锁 rm -rf、DROP TABLE、强制推送等危险操作
• /freeze：锁定只能编辑特定目录

10. 分发与规模化策略

 警告：缺乏策展机制，最终会导致技能重复与品质低落。

11. 追踪使用数据

使用 PreToolUse 钩子记录呼叫次数，找出哪些 Skills 最受欢迎、哪些已被废弃。

如何开始？给新手的建议

Anthropic 近期推出了 Skill Creator 工具，让建立 Skills 的过程更加简单 — 建议从这里开始。

大多数我们内部的 Skills 一开始都非常精简（几行指令 + 一个常见坑点），随着使用者持续新增真实边界情况才逐渐成长茁壮。

Skills 让 Claude Code 从一个通用 AI 助手，蜕变为高度符合组织需求的超级代理人。 现在还是早期发展阶段，建议积极实验、持续迭代，并将成果分享给社群。

常见问题（FAQ）

Q：Skills 和一般的 System Prompt 有什么差别？ A：System Prompt 是静态的文字，而 Skills 是包含脚本、资料、模板的完整资料夹结构，Claude 能主动与这些档案互动。

Q：一个 Skill 可以呼叫另一个 Skill 吗？ A：可以。「业务流程与团队自动化」类型的 Skills 就常常以其他 Skills 作为依赖。

Q：Skills 适合个人开发者使用吗？ A：当然。即使是个人使用，建立「常见坑点」与「API 参考」类型的 Skills 也能大幅提升与 Claude Code 的合作效率。

本文链接地址：https://www.wwsww.cn/rgzn/37747.html
郑重声明：本文版权归原作者所有，转载文章仅为传播更多信息之目的，如作者信息标记有误，请第一时间联系我们修改或删除，多谢。