构建 Claude Code 技能：自动化你的程序性知识

原文来源: Building Skills for Claude Code: Automating your procedural knowledge - Claude.com Blog

Skills 是模块化的知识包，用于教会 Claude 你团队的特定工作流程、术语和业务逻辑。与每次对话都从头开始不同，Skills 使 Claude 能够在遇到相关任务时自动引用你的组织知识。

解决的核心问题

组织会积累分散在 wiki 和部落知识中的程序性知识——数据仓库模式、业务指标、查询模式——但 Claude 无法访问这些上下文。

没有 Skills 时的痛点：

用户需要反复通过提示词解释相同的细节
每次对话都要重新说明业务规则
关键的组织知识无法被有效利用

Skills 如何工作

Skills 使用**“渐进式披露”（Progressive Disclosure）**机制，分层次揭示信息：

第一层：Claude 看到可用 skills 的轻量级索引
第二层：当任务匹配时，加载相关指令
第三层：仅在需要时访问详细文档

这种设计在全面的知识覆盖和有限的上下文窗口之间取得了平衡。

Skill 架构

SKILL.md 文件

包含以下内容：

---
name: "数据仓库 SQL 查询"
description: "帮助用户编写符合业务规则的 SQL 查询"
---

# 工作流程指导

1. 明确用户的查询需求
2. 检查是否已有现成的仪表板
3. 识别相关数据源
4. 执行分析并应用必要的过滤器

# 关键业务逻辑

- **始终**排除测试账户 (account_type != 'test')
- **始终**使用 `created_at_utc` 而非 `created_at`
- 收入计算必须使用 `net_revenue` 字段

# 参考文档

详见 `references/` 目录中的文件。

References 目录

包含详细的参考文档：

表结构和字段定义
标准过滤器和必需的业务逻辑
指标计算公式
常见查询模式
边缘情况和已知问题

Skills vs CLAUDE.md 的区别

特性	CLAUDE.md	Skills
加载方式	总是加载	渐进式披露（按需加载）
适用范围	仅 Claude Code 项目	跨平台（claude.ai、Claude Code、API）
支持内容	主要是指令文本	可执行代码 + 参考文件
最佳用途	项目特定配置	大型、可复用的组织知识

关键区别：

CLAUDE.md 是项目级配置文件，每次对话都会加载
Skills 是跨项目的知识模块，仅在相关时才加载

实战案例：数据仓库 SQL Skill

这个 skill 引导 Claude 完成以下步骤：

明确请求：理解用户想要分析什么数据
检查现有资源：查看是否已有相关仪表板
识别数据源：找到包含所需数据的表
执行分析：编写 SQL 查询并应用业务规则

自动应用的业务逻辑：

排除测试账户（account_type != 'test'）
使用 UTC 时间戳字段
遵循标准的指标计算公式

开始构建 Skills

第一步：安装 Claude Code

确保已安装 Claude Code CLI 工具。

第二步：启用 skill-creator skill

使用内置的 skill-creator skill 来帮助你创建新的 skills。

第三步：识别候选知识

寻找跨代码库的知识，例如：

数据仓库查询模式和业务规则
平台文档（API、架构指南）
公司标准（代码风格、安全要求）
常见工作流程（部署流程、审查清单）

第四步：结构化信息

将知识组织成两部分：

SKILL.md（高层指导）：

---
name: "你的 skill 名称"
description: "简短描述，告诉 Claude 何时使用这个 skill"
---

# 工作流程
[关键步骤和决策点]

# 业务逻辑
[必须遵循的规则和约束]

# 参考文档
见 references/ 目录

references/ 目录（详细文档）：

表结构、API 规范
示例代码和查询模板
边缘情况说明

分享 Skills

根据团队工作流程选择分享方式：

方式	适用场景
Zip 文件	简单分享，手动更新
版本控制仓库	团队协作，版本管理
Git 集成	自动同步更新
插件包	标准化分发

Skills 的价值

减少重复工作

团队成员不再需要反复解释相同的业务规则和工作流程。

知识标准化

确保每个人都遵循相同的最佳实践和业务逻辑。

跨平台可用

同一个 skill 可以在 claude.ai、Claude Code CLI 和 API 中使用。

持续改进

Skills 可以像代码一样进行版本控制和持续优化。

最佳实践

1. 保持 SKILL.md 简洁

在 SKILL.md 中只包含高层次的指导和关键业务逻辑，将详细内容放在 references/ 目录中。

2. 编写清晰的描述

Description 字段决定了 Claude 何时加载这个 skill，确保它准确描述了 skill 的适用场景。

3. 使用具体示例

在 references/ 中提供真实的查询模板、代码示例和使用案例。

4. 定期更新

随着业务规则和工作流程的变化，及时更新 skills。

5. 测试有效性

通过实际使用来验证 skills 是否能正确引导 Claude 的行为。

何时使用 Skills

适合 Skills：

✅ 跨多个项目的通用知识
✅ 复杂的业务规则和工作流程
✅ 需要详细参考文档的领域知识
✅ 团队共享的最佳实践

不适合 Skills（使用 CLAUDE.md）：

❌ 特定项目的配置
❌ 临时的开发指令
❌ 简单的代码风格偏好

开始使用 Claude Code Skills

想要体验 Claude Code 的完整功能？访问 CodeCC 获取官方 Claude API 直连服务，支持：

✅ Skills 渐进式加载
✅ 跨平台知识管理
✅ 企业级知识库集成
✅ 团队协作工具