内容来源：ClaudeWorld。本https://claude-world.com/articles/skills-guide/
原题：Claude Code Skills: Complete Guide to Slash Commands
原发布时间：2026-01-10
全面掌握 Claude Code 的 Skills 系统：了解斜杠命令的工作方式、可用的内置技能，以及如何为自己的工作流创建自定义 Skills。
Skills 是 Claude Code 的斜杠命令系统——可通过 /command 语法触发的可复用提示词与工作流。本指南将介绍内置 Skills、定制方式，以及如何创建自己的 Skill。
Skills 是什么？
根据官方文档，Skills 包括：
• 由斜杠命令触发的可复用提示词模板
• 组合多个步骤的工作流自动化
• 可以按需创建的自定义扩展
• 理解代码库的项目专用命令
你可以把 Skills 看作宏：它把常用工作流编码成一条命令。
Skills 如何工作
用户输入：/commit
Claude Code：
1. 在 .claude/skills/ 或内置 Skills 中查找定义
2. 加载该 Skill 的提示词模板
3. 执行 Skill 定义的工作流
4. 向用户返回结果
内置 Skills
核心工作流 Skills
| Skill | 命令 | 用途 |
|---|---|---|
| 初始化 | /init |
为新项目初始化 CLAUDE.md |
| 帮助 | /help |
显示可用命令 |
| 清除 | /clear |
清空对话上下文 |
| 配置 | /config |
查看或编辑配置 |
| 权限 | /permissions |
管理工具权限 |
| 诊断 | /doctor |
诊断 Claude Code 问题 |
开发 Skills
| Skill | 命令 | 用途 |
|---|---|---|
| 提交 | /commit |
使用规范的消息创建 Git 提交 |
| 审查 | /review |
审查当前变更 |
| 测试 | /test |
运行测试并分析结果 |
| 构建 | /build |
构建项目并检查错误 |
| Lint | /lint |
运行 Lint 并修复问题 |
记忆 Skills
| Skill | 命令 | 用途 |
|---|---|---|
| 保存记忆 | /memory-save |
把知识保存到 Memory MCP |
| 搜索记忆 | /memory-search |
搜索已保存的知识 |
| 记忆列表 | /memory-list |
列出全部已保存实体 |
| 记忆审计 | /memory-audit |
检查记忆健康状况 |
使用 Skills
基础用法
直接输入斜杠命令：
/commit
Claude 会执行该 Skill 的工作流。
携带参数
部分 Skills 接受参数：
/commit -m "feat: add user authentication"
/review --security
/test --coverage
串联 Skills
Skills 可以按顺序使用：
用户：完成我们讨论过的修改，然后运行 /commit
Claude：
→ 完成修改
→ 执行 /commit Skill
→ 创建规范的提交消息
Skill 文件结构
Skills 定义在 .claude/skills/ 目录中：
.claude/
├── skills/
│ ├── commit.md # Git 提交 Skill
│ ├── review.md # 代码审查 Skill
│ ├── deploy.md # 部署 Skill
│ └── my-custom-skill.md # 你的自定义 Skills
└── settings.json
Skill 定义格式
---
name: commit
description: 使用 Conventional Commit 消息创建 Git 提交
trigger: /commit
---
# 提交 Skill
## 指令
1. 检查 Git 状态，确认已暂存的变更
2. 分析变更，了解修改内容
3. 生成一条 Conventional Commit 消息：
- feat：新功能
- fix：错误修复
- docs：文档
- refactor：代码重构
- test：测试变更
- chore：维护
4. 使用生成的消息创建提交
5. 显示提交结果
## 格式
使用以下提交消息格式：
```
type(scope): description
• 详细内容 1<br>
• 详细内容 2<br>
Co-Authored-By: Claude <noreply@anthropic.com>
```
## 输出示例
```
已创建提交：abc1234
feat(auth): add JWT token refresh mechanism
• 在过期前自动刷新 Token<br>
• 增加刷新 Token 轮换机制，提升安全性<br>
• 更新身份验证中间件，以处理刷新流程<br>
Co-Authored-By: Claude <noreply@anthropic.com>
```
创建自定义 Skills
第 1 步：创建文件
在 .claude/skills/ 中新建一个 .md 文件：
touch .claude/skills/deploy.md
第 2 步：定义 Skill
---
name: deploy
description: 部署到预发布环境
trigger: /deploy
---
# 部署到预发布环境
## 前置条件检查
1. 验证所有测试都已通过
2. 检查是否存在未提交的变更
3. 确认当前分支
## 部署步骤
1. 构建项目：
```bash
npm run build
```
2. 运行部署前测试：
```bash
npm run test:e2e
```
3. 部署到预发布环境：
```bash
npm run deploy:staging
```
4. 验证部署：
- 检查健康端点
- 运行冒烟测试
## 部署后操作
- 报告部署状态
- 显示部署后的 URL
- 说明所有警告
第 3 步：使用 Skill
/deploy
Skills 的高级模式
模式 1：参数化 Skills
让 Skill 接受参数：
---
name: feature
description: 创建新的功能分支
trigger: /feature
args:
- name: feature-name
required: true
description: 功能名称
---
# 新功能工作流
## 步骤
1. 创建分支：`feature/{{feature-name}}`
2. 建立功能目录结构
3. 创建初始文件
4. 创建 PR 草稿
模式 2：条件式 Skills
根据上下文采用不同的行为：
---
name: review
description: 审查代码变更
trigger: /review
---
# 代码审查
## 判断审查类型
如果审查 PR：
- 获取 PR 变更
- 与基础分支比较
如果审查本地变更：
- 检查 Git Diff
- 审查已暂存和未暂存的内容
## 审查清单
- [ ] 代码质量
- [ ] 安全性考量
- [ ] 测试覆盖率
- [ ] 文档
- [ ] 性能影响
模式 3：多智能体 Skills
编排多个智能体的 Skills：
---
name: audit
description: 全面审计代码库
trigger: /audit
---
# 代码库审计
## 阶段 1：并行分析
同时启动以下智能体：
1. **Explore 智能体（快速）**：绘制代码库结构
2. **Explore 智能体（中等）**：查找代码模式
3. **security-auditor**：安全扫描
4. **code-reviewer**：质量检查
5. **test-runner**：覆盖率分析
## 阶段 2：汇总结果
把发现整理为：
- 安全问题（按严重程度分类）
- 质量隐患
- 覆盖率缺口
- 改进建议
## 输出格式
```
# 审计报告
## 安全（X 个问题）
• 严重：……<br>
• 高危：……<br>
## 质量（X 项隐患）
• ……<br>
## 覆盖率（X%）
• 缺失：……<br>
## 建议
1、……<br>
2、……<br>
```
模式 4：交互式 Skills
会向用户提问的 Skills：
---
name: scaffold
description: 为新组件或功能搭建骨架
trigger: /scaffold
---
# 骨架生成器
## 问题
询问用户：
1. 类型是什么？（component/api/service/hook）
2. 名称是什么？
3. 放在哪里？（根据类型给出建议）
## 根据回答生成
如果是组件：
- 创建组件文件
- 创建测试文件
- 创建样式文件
- 从索引导出
如果是 API：
- 创建路由处理程序
- 创建验证 Schema
- 创建测试文件
- 更新 API 路由索引
项目专用 Skills
示例：电子商务 Skills
# .claude/skills/add-product.md
---
name: add-product
description: 向商品目录添加新商品
trigger: /add-product
---
## 商品创建工作流
1. 创建商品迁移
2. 添加商品 Schema
3. 创建 API 端点
4. 添加管理界面组件
5. 编写测试
示例：API 开发 Skills
# .claude/skills/new-endpoint.md
---
name: new-endpoint
description: 创建配置完整的新 API 端点
trigger: /new-endpoint
---
## 创建端点
1. 创建路由处理程序
2. 添加输入验证（Zod）
3. 实现业务逻辑
4. 添加错误处理
5. 编写测试
6. 更新 API 文档
7. 运行 security-auditor
Skill 分类
工作流 Skills
/workflow # 完整开发工作流
/focus-problem # 问题分析
/test-first # TDD 工作流
/smart-commit # 智能 Git 提交
质量 Skills
/self-review # 自我审查和修复循环
/code-review # 代码审查
/security-check # 安全扫描
/doc-audit # 文档检查
Git Skills
/commit-push-pr # 提交、推送并创建 PR
/smart-commit # Conventional Commits
AI 互操作 Skills
/handoff-codex # 移交给 Codex CLI
/handoff-gemini # 移交给 Gemini CLI
/interop-broker # 路由至最合适的 CLI
Skills、Agents 与 MCP 对比
| 特性 | Skills | Agents | MCP |
|---|---|---|---|
| 用途 | 工作流自动化 | 执行任务 | 扩展工具 |
| 触发方式 | /command |
Task 工具 | 自动 |
| 作用域 | 项目专用 | 内置类型 | 外部服务 |
| 定制难度 | 简单（Markdown） | 有限 | 中等（代码） |
| 上下文成本 | 低 | 中等 | 不固定 |
分别该在什么时候使用
以下情况使用 Skills：
• 有可重复的工作流
• 需要斜杠命令快捷入口
• 需要项目专用命令
• 希望编码团队模式
以下情况使用 Agents：
• 需要并行执行
• 需要专业分析
• 需要自主处理任务
• 希望灵活选择模型
以下情况使用 MCP：
• 需要访问外部数据
• 需要持久化存储
• 需要 API 集成
• 需要访问数据库
Skill 最佳实践
1. 让 Skill 保持聚焦
# 推荐：单一用途
/deploy-staging # 部署到预发布环境
/deploy-prod # 部署到生产环境
# 避免：范围太宽
/deploy # 部署到……哪里？
2. 编写完整文档
---
name: my-skill
description: 清晰的单行描述
trigger: /my-skill
---
# Skill 名称
## 用途
这项 Skill 做什么，以及什么时候使用。
## 前置条件
运行之前需要准备什么。
## 步骤
详细的工作流步骤。
## 示例
使用示例和预期输出。
3. 加入错误处理
## 错误处理
如果构建失败：
- 显示错误详情
- 建议修复方法
- 不要继续部署
如果测试失败：
- 报告失败的测试
- 继续之前先询问用户
4. 恰当使用 Agents
## 质量检查
实现完成后：
- 运行 code-reviewer 智能体检查质量
- 运行 test-runner 智能体分析覆盖率
- 如果涉及身份验证或支付，运行 security-auditor
发现 Skills
列出可用 Skills
/help
这会显示包括自定义 Skills 在内的全部可用技能。
查看 Skill 定义
在 .claude/skills/ 中查看自定义 Skill 定义。
内置 Skill 文档
内置 Skills 记录在 Claude Code 官方文档中。
开始行动
今天：
1、在下一次变更时试用 /commit
2、使用 /help 查看可用 Skills
3、了解内置 Skills
本周：
1、为自己的工作流创建一项自定义 Skill
2、在项目中加入团队专用 Skills
3、在 README 中记录 Skills
本月：
1、建立项目 Skills 库
2、在团队项目之间共享 Skills
3、为复杂工作流创建多智能体 Skills
Skills 能把你的专业经验编码成可复用命令。一次构建，永久使用。
