Agent Skills 入门：构建可复用的 Claude 技能

Anthropic 官方课程 | 免费 | 中级 | 预计学习时间：50 分钟

课程概述

本课程教你构建、配置和分享 Claude Code 的 Skills（技能）——可复用的 Markdown 指令集，Claude 会自动将其应用到匹配的任务中。课程涵盖从创建第一个 Skill 到在团队和企业中分发 Skills 的完整流程。

模块一：Skills 基础

1.1 什么是 Skills

Skills 是存储在 .claude/skills/ 目录下的 Markdown 文件（SKILL.md），包含结构化的指令和约束。当 Claude Code 识别到用户的任务匹配某个 Skill 的描述时，会自动加载该 Skill 的内容作为上下文。

1.2 Skills vs 其他自定义方式

自定义方式适用场景持久性
CLAUDE.md项目级全局规范始终加载
Skills特定任务的专业指令按需加载
Hooks工具调用前后的自动化事件触发
Subagents独立执行的专业代理按需创建

模块二：创建你的第一个 Skill

2.1 SKILL.md 文件结构

SKILL.md 使用 YAML frontmatter 定义元数据：

  • name：技能名称
  • description：触发匹配的关键描述（决定何时被加载）
  • allowed-tools（可选）：限制 Skill 可使用的工具

正文部分包含详细的指令、模板、约束和示例。

2.2 编写有效的描述

描述是 Skill 匹配的关键。好的描述应当：

  • 包含用户可能使用的关键词和短语
  • 明确 Skill 适用的任务类型
  • 避免过于宽泛（会误匹配）或过于狭窄（难以触发）

模块三：Skill 目录组织

3.1 渐进式披露

为了保持上下文窗口的高效使用，Skill 目录应采用渐进式披露结构：

  • SKILL.md：核心指令和快速参考
  • templates/：代码模板和脚手架
  • examples/：示例代码和最佳实践
  • scripts/：自动化脚本（不消耗上下文）

模块四：高级配置

4.1 工具访问限制

通过 allowed-tools 配置限制 Skill 可以使用的工具集，增强安全性。例如，一个代码审查 Skill 可以限制为只读工具，防止意外修改。

4.2 脚本执行

Skill 可以包含脚本（如 Shell 脚本、Python 脚本），这些脚本在执行时不消耗上下文窗口空间，适合复杂的自动化逻辑。

模块五：分发与共享

5.1 仓库提交

将 Skills 提交到项目仓库的 .claude/skills/ 目录，团队成员自动获取。

5.2 Plugin 分发

通过 Claude Code 的 Plugin 系统分发 Skills，支持跨项目和跨团队共享。

5.3 企业级部署

通过企业管理设置（Managed Settings）统一部署 Skills 到组织内所有成员。

模块六：Subagent 集成

6.1 将 Skills 绑定到 Subagent

将 Skill 配置为自定义 Subagent 的指令，实现隔离的专家级任务委派。例如：创建一个"SQL 专家" Subagent，绑定数据库查询 Skill。

模块七：故障排除

7.1 常见问题

  • 触发失败：检查描述中的关键词是否与用户输入匹配
  • 优先级冲突：多个 Skill 匹配时的优先级解决
  • 运行时错误：脚本执行失败的调试方法

前置要求

  • 熟悉 Claude Code 基本操作
  • 了解 Markdown 和 YAML 格式

本课程由 Anthropic 官方提供，灵阙学院提供中文导读与知识扩展。完整互动课程请访问 Anthropic Academy。