标签: AI Coding / Claude Code / 深度技术
系列定位: Claude Code 实战系列第三篇。前两篇分别是《CLAUDE.md 协作指南》与《真实项目开发流程》,本篇聚焦 Claude Code 的 Skills 扩展体系,深度解析官方源码与设计理念。
Skills 是什么
在 Claude Code 的语境里,Skill 不是一个内置功能,而是一套自定义扩展机制。
它的本质是:把针对特定任务的专业知识打包成文件,让 Claude Code 在遇到相应场景时能够调用这套知识,而不是每次都重新描述。
这和 CLAUDE.md 不同。CLAUDE.md 是项目级上下文,回答的是"这个项目是什么";Skill 是任务级指令,回答的是"这类任务应该怎么做"。
从官方源码看,Skills 的文件结构非常清晰:
skill-name/├── SKILL.md ← 必须文件,YAML frontmatter + 核心指令├── references/ ← 可选,参考文档,按需加载├── examples/ ← 可选,工作示例└── scripts/ ← 可选,可执行脚本
Claude Code 启动时会扫描 skills/ 目录,把每个子目录里的 SKILL.md 的 name 和 description 加载进上下文。当用户的描述触发了某个 description,Claude 会把对应的 SKILL.md 全文读入,然后按照里面的指令执行。
为什么需要 Skills
三个场景能说清楚:
第一,团队知识传承。
你团队里最好的工程师,他的代码审查方式、安全扫描逻辑、部署规范,都是靠多年经验积累的。如果只靠口口相传,每次换人都要重新教。有了 Skill,这些经验可以固化成文件,新工程师加上项目 CLAUDE.md,AI 就能用团队的标准工作。
第二,复杂任务的决策框架。
一段 prompt 只能给出一个答案,一个 Skill 可以给出一个决策树。Claude 遇到不同情况,应该走哪条分支,输出什么,都有明确的规范,而不是每次生成一段看似合理但不一致的内容。
第三,反复重写的确定性任务。
有些任务每次都要重新写差不多的代码,比如每次新建组件都要搭脚手架、每次做代码迁移都要处理同一套模式。把这些任务的"正确做法"写成 Skill,Claude 每次都能用最优方式执行,不会每次都从零推理。
Skills 的真实结构:从官方源码看设计
SKILL.md 的 frontmatter
官方 frontend-design 插件的 Skill 文件是这个样子的:
---name: frontend-designdescription: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications.---# Frontend Design Guidance## Design ThinkingBefore coding, understand the context and commit to a BOLD aesthetic direction...## Technical RequirementsImplement production-grade code that is...
frontmatter 里只有三个字段有实际作用:
| 字段 | 必须 | 作用 |
|---|---|---|
name |
是 | 唯一标识符 |
description |
是 | 触发条件描述,决定 Claude 什么时候调用这个 Skill |
version |
否 | 版本号 |
其中 description 是整个 Skill 最重要的字段。官方 plugin-dev 插件的方法论明确指出:description 的质量直接决定 Skill 能不能被正确触发。
官方推荐的 description 写法是第三人称 + 具体触发短语:
## 正确示范description: This skill should be used when the user asks to "create a hook", "add a PreToolUse hook", "validate tool use"...# 错误示范description: Provides guidance for working with hooks. # 模糊,没有触发短语description: Load this skill when user asks... # 第二人称
正文:不是步骤清单,是决策框架
官方 frontend-design Skill 的正文是这样一个结构:
## Design Thinking- Purpose: 这个界面解决什么问题?- Tone: 选择一个设计方向(极简、复古、奢华……)- Constraints: 技术约束是什么?- Differentiation: 什么让它令人印象深刻?## Frontend Aesthetics Guidelines- Typography: 字体选择- Color & Theme: 配色体系- Motion: 动效- Spatial Composition: 空间布局
这给 Claude 的是一套思考框架,不是一串执行步骤。Claude 在这个框架内自主判断每一步怎么做,而不是机械地读指令。
官方 Skill Development 方法论里专门强调了这一点:正文应该用祈使句/不定式(verb-first),而不是第二人称。
## 正确To create a hook, define the event type.Configure the MCP server with authentication.Validate settings before use.# 错误You sh…