Skill 介绍

了解 Claude Code 的核心扩展机制

什么是 Skill？

Skill 是 Claude Code 的技能扩展系统。每个 Skill 是一个 SKILL.md 文件，位于项目的 .claude/skills/ 目录下。

Skill 通过 YAML frontmatter 定义触发条件，通过 Markdown 正文 定义具体的工作规则和执行流程。当 Claude Code 工作时，它会根据当前上下文自动匹配和执行合适的 Skill。

Skill 文件结构

⚙️YAML Frontmatter

nameSkill 名称，用于识别和展示

trigger触发条件（自然语言描述）

description功能简述，帮助 AI 理解 Skill 用途

📄Markdown Body

Rules编码规范和约束条件

Steps执行流程和操作步骤

Examples示例代码和参考实现

目录结构

.claude/
  skills/
    code-review/
      SKILL.md          # 代码审查 Skill
    tdd/
      SKILL.md          # 测试驱动开发 Skill
    verification/
      SKILL.md          # 验证流程 Skill

Skill vs Prompt vs Agent

三者的核心区别

维度	Prompt	Skill ★	Agent
定义方式	一次性自然语言	YAML + Markdown 文件	多 Skill + 工具链
复用性	低（需重复输入）	高（文件级复用）	最高（系统级复用）
触发机制	手动粘贴	条件自动触发	自主决策触发
适合场景	简单指令	标准化工作流	复杂自动化任务
持久化	无	文件系统	配置系统
组合能力	无	有限	强（可嵌套调用）

Skill 生命周期

📝

创建

在 .claude/skills/ 目录下创建 SKILL.md 文件

✏️

定义

编写 YAML frontmatter（触发条件）和 Markdown（规则）

🎯

触发

Claude Code 根据上下文自动匹配或用户手动调用

⚡

执行

按照 Skill 定义的规则生成代码、运行验证

🔄

迭代

根据执行结果优化 Skill 内容，提升准确性

核心价值

标准化

将团队最佳实践编码化，确保每次 AI 交互都遵循统一规范

自动化

条件触发机制，无需重复输入指令，工作流自动执行

可扩展

文件级 Skill 可共享、版本管理和组合使用