前言
你是否有过这样的经历：每次打开 Claude 对话框，都要粘贴一段几百字的"背景说明"；团队里每个人对 AI 的用法各有一套，协作时鸡同鸭讲；辛苦调教出来的 Prompt 存在备忘录里，下次又忘了复制——
这些痛点，Claude Code Skills（技能）系统正是为此而生。
本文是 Claude Code Skills 系列的第一篇，带你彻底搞清楚：Skills 是什么、解决什么问题、从哪里开始。
一、Claude Code 是什么？
Claude Code 是 Anthropic 推出的官方命令行工具（CLI），让你在终端里直接与 Claude 协作写代码。它不只是一个简单的聊天界面，而是一个具备文件读写、代码执行、Git 操作等能力的智能编程助手。
# 安装
npm install -g @anthropic-ai/claude-code
# 启动
claude
Claude Code 的核心扩展机制，就是本系列要讲的主角：Skills（技能）。
二、Skills 解决了什么问题？
没有 Skills 时的困境
| 问题 | 描述 |
|---|---|
| Prompt 重复粘贴 | 每次对话都要重新说明项目背景、技术栈、代码规范 |
| 团队不一致 | 不同同事对 AI 的指令风格各异，输出质量参差不齐 |
| 工作流不可复用 | 好不容易调出来的工作流，下次还得重新摸索 |
| 上下文容易遗忘 | 长对话中 Claude 容易"忘记"早期的约定 |
Skills 给出的答案
Skills 本质上是可复用的、可共享的 AI 工作流配置文件。你把工作流、规范、知识封装进一个 SKILL.md 文件，Claude 就能随时"加载"并精确执行——无需重复说明。
三、Skills 的工作原理
3.1 一个 Skill 的完整结构
每个 Skill 是一个目录，核心文件是 SKILL.md：
.claude/skills/my-first-skill/
└── SKILL.md
SKILL.md 由两部分组成：
① YAML 前置配置（Frontmatter）
---
name: commit-helper
description: 生成符合 Conventional Commits 规范的提交信息。当用户说"帮我写提交信息"或"生成 commit message"时触发。
allowed-tools: [Read, Bash, Edit]
user-invocable: true
---
② Markdown 正文（指令内容）
## 工作流程
1. 运行 `git diff --staged` 查看暂存的变更
2. 分析变更类型（feat/fix/docs/refactor/chore 等）
3. 生成符合格式的提交信息：`<type>(<scope>): <description>`
## 格式规范
- 标题不超过 72 个字符
- 使用祈使句，如"Add"而非"Added"
- 如有 Breaking Change，标注 `BREAKING CHANGE:`
3.2 两种触发方式
手动触发（斜杠命令）：
/commit-helper
自动触发（语义匹配）：
Claude 在会话开始时读取所有 Skill 的 description 字段，当你的自然语言请求与描述匹配时，自动加载对应 Skill。
你：帮我写一下这次的提交信息
Claude：（自动加载 commit-helper Skill，分析 git diff 后生成规范的提交信息）
四、Skills 存放在哪里？
| 位置 | 作用范围 | 适用场景 |
|---|---|---|
~/.claude/skills/ | 全局（个人） | 跨项目的个人习惯 |
.claude/skills/ | 项目级 | 团队共用，提交到 Git |
优先级：项目级 > 全局级
推荐将项目级 Skills 提交到 Git 仓库，这样整个团队都能使用同一套 AI 工作流。
五、内置斜杠命令速查
在你创建自己的 Skills 之前，Claude Code 已经内置了一批实用命令：
| 命令 | 功能 |
|---|---|
/help | 列出所有可用命令（含自定义） |
/clear | 清除当前对话历史 |
/compact | 压缩历史记录，节省上下文空间 |
/model | 切换 AI 模型 |
/config | 打开配置界面 |
/hooks | 管理生命周期钩子 |
/permissions | 查看和管理工具权限 |
/status | 查看当前配置层级状态 |
/init | 自动生成项目 CLAUDE.md 文件 |
六、CLAUDE.md：项目的"入职文档"
除了 Skills，Claude Code 还有一个重要文件：CLAUDE.md。
它是 Claude 在每次会话开始时自动读取的项目说明文档，相当于给 AI 的"入职指南"：
# 项目说明
## 技术栈
- 前端：React 18 + TypeScript
- 后端：FastAPI + PostgreSQL
- 包管理：pnpm
## 开发规范
- 提交信息遵循 Conventional Commits
- 所有函数必须有 JSDoc 注释
- 禁止使用 `any` 类型
## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
- 代码检查：`pnpm lint`
最佳实践：CLAUDE.md 保持简洁，详细规范通过链接指向其他文档，而不是全部塞进来。
七、快速上手：创建你的第一个 Skill
步骤 1：创建目录
mkdir -p .claude/skills/code-review
步骤 2：编写 SKILL.md
---
name: code-review
description: 执行代码审查，检查代码质量、安全漏洞和性能问题。当用户说"帮我 review 代码"或"代码审查"时触发。
allowed-tools: [Read, Grep]
user-invocable: true
---
## 代码审查清单
请按照以下维度检查指定文件或当前变更：
### 1. 代码质量
- 函数是否职责单一？
- 变量命名是否清晰？
- 是否有重复代码？
### 2. 安全性
- 是否存在 SQL 注入风险？
- 用户输入是否经过校验？
- 敏感信息是否硬编码？
### 3. 性能
- 是否有 N+1 查询问题？
- 循环内是否有不必要的计算？
输出格式：使用 Markdown 表格，列出文件名、问题描述、严重程度（高/中/低）和修改建议。
步骤 3：测试
在 Claude Code 中输入：
/code-review
或自然语言：
帮我 review 一下 src/api/auth.ts 这个文件
八、Skills 生态：站在巨人的肩膀上
不必所有 Skill 都自己写，社区已经有大量现成的：
- skills.sh：官方 Skill 市场，通过
npx skills add <org/repo>一键安装 - awesome-claude-code：GitHub 上的精选 Claude Code 资源列表
安装社区 Skill：
npx skills add anthropics/commit-helper
npx skills add community/playwright-qa
九、总结
| 概念 | 一句话说明 |
|---|---|
| Skills | 可复用的 AI 工作流配置，封装在 SKILL.md 中 |
| SKILL.md | 包含 YAML 配置 + Markdown 指令的核心文件 |
| 自动触发 | Claude 根据 description 字段语义匹配用户请求 |
| 手动触发 | 通过斜杠命令 /skill-name 显式调用 |
| CLAUDE.md | 项目级的 AI 入职文档，每次会话自动加载 |
下一篇我们将手把手创建一个完整的生产级 Skill——从零开始打造你的专属斜杠命令。
