每个团队都有自己的开发流程:代码审查规范、部署步骤、文档模板……每次都要把这些背景信息喂给 Claude,既麻烦又消耗 Token。
Skills(技能)就是解决方案:把你的工作流程封装成 /slash-command,一句话调用。
Skills 是什么?
Skills 是写在 SKILL.md 文件里的可复用工作流模板。创建后:
- 用
/skill-name直接调用 - 或让 Claude 在判断相关时自动加载
与 CLAUDE.md 的区别:
- CLAUDE.md:每次会话都加载,适合通用规则
- Skills:按需加载,适合特定场景的详细工作流
内置 Skills 速览
Claude Code 自带几个强力技能:
| 命令 | 功能 |
|---|---|
/batch <指令> | 大规模并行代码改动(自动分解任务、多代理并行、每个单元提 PR) |
/simplify | 并行审查近期改动的代码质量,找重复和效率问题 |
/loop 5m <提示> | 定时重复执行提示(监控部署、定期检查等) |
/debug | 分析当前 Session 调试日志 |
/claude-api | 加载 Claude API 参考资料(Python/TypeScript/Go 等) |
创建第一个自定义 Skill
目录结构
~/.claude/skills/ # 个人 Skills(所有项目可用)
explain-code/
SKILL.md
your-project/.claude/skills/ # 项目 Skills(Git 共享给团队)
review-pr/
SKILL.md
deploy/
SKILL.md
也支持旧的 commands 路径,两者等价:
.claude/commands/deploy.md ↔ .claude/skills/deploy/SKILL.md
SKILL.md 文件格式
---
name: review-pr
description: 审查 PR 代码质量。当用户说"审查这个PR"、"code review"或提到代码质量时自动调用
---
按以下维度审查这个 PR:
## 1. 安全性检查
- SQL 注入:所有查询使用参数化?
- XSS:用户输入是否正确转义?
- 认证:所有敏感端点是否有权限验证?
## 2. 代码质量
- 是否有重复代码可以提取?
- 错误处理是否完整?
- 命名是否清晰表达意图?
## 3. 测试覆盖
- 新功能是否有对应测试?
- 边界条件是否覆盖?
## 输出格式
按严重程度(Critical/High/Medium/Low)排列问题,
每个问题注明文件和行号,
附修复建议。
最后给出 0-10 分的总体评分和一句话总结。Frontmatter 中的 description 字段决定 Claude 何时自动加载这个 Skill。
调用方式
# 直接调用
/review-pr
# 带参数调用
/deploy staging
/batch 将所有 console.log 替换为 logger.info实用 Skills 示例库
1. 部署检查清单
---
name: pre-deploy
description: 部署前检查清单。在用户说"部署"或"上线"时使用
---
执行以下部署前检查:
1. **运行完整测试套件**
```bash
npm test确认全部通过,记录覆盖率
-
检查环境变量 确认 .env.example 里的所有变量在目标环境已配置
-
安全扫描 检查是否有硬编码的密钥或敏感信息
-
依赖检查
bashnpm audit修复所有 high/critical 漏洞
-
生成 Changelog 条目 根据本次 commit 自动生成,放入 CHANGELOG.md
所有检查通过后,给出部署许可或阻止清单。
### 2. 代码解释(图文并茂)
```markdown
---
name: explain-code
description: 用图表和类比解释代码。当用户问"这是什么意思"、"怎么运作的"时自动触发
---
解释代码时必须包含:
1. **日常类比**:用生活中的例子比喻这段代码做的事情
2. **ASCII 流程图**:展示数据流向或函数调用链
3. **逐步讲解**:每个关键步骤一句话
4. **常见误区**:这里最容易犯什么错误?
风格:像讲给刚入行一年的同事,技术准确但不卖弄。
3. 新功能开发模板
---
name: new-feature
description: 按规范开发新功能的完整流程
---
开发新功能时按以下步骤执行:
**参数**:`$ARGUMENTS`(功能描述)
## Step 1:探索阶段(Plan Mode)
- 读取相关现有代码,理解当前架构
- 识别需要修改的文件
- 评估对现有功能的影响
## Step 2:设计方案
制定实现计划,包含:
- 改动文件列表
- 数据库 Schema 变更(如有)
- API 接口设计
- 测试策略
等待用户确认方案再继续。
## Step 3:实现
按照项目的 CLAUDE.md 规范编写代码,
先写测试(TDD),再写实现。
## Step 4:验证
运行测试,确认覆盖率不低于现有水平。
## Step 5:提交
用 conventional commits 格式写 commit message:
`feat: <功能描述>`4. 团队 On-boarding 助手
---
name: onboard
description: 帮助新成员理解项目。当有人说"我是新来的"或"帮我了解这个项目"时使用
---
为新成员生成项目快速入门:
1. **项目概览**:这个项目是做什么的,解决什么问题
2. **架构图**:用 ASCII 图展示主要模块和数据流
3. **快速上手**:从 clone 到本地运行跑通的步骤
4. **关键文件导览**:最重要的 5-10 个文件及其作用
5. **开发规范速查**:最需要注意的编码约定
6. **常见问题**:新人最容易踩的坑
输出为 Markdown,可以直接保存为 ONBOARDING.md。传参给 Skills
在 SKILL.md 里用 $ARGUMENTS 接收调用时传入的参数:
---
name: review-file
---
审查文件:$ARGUMENTS
重点检查:
- 与同目录其他文件的风格一致性
- 是否有未处理的错误情况调用:/review-file src/auth/login.ts
在子代理里运行 Skill
复杂任务可以让 Skill 在独立的子代理上下文里运行,避免污染主对话:
---
name: security-audit
agent: subagent # 在子代理里运行
description: 完整安全审计,在隔离环境运行
---
对整个代码库进行安全审计...
(详细指令)分享和复用
项目 Skills 通过 Git 自动共享给团队,放在 .claude/skills/:
git add .claude/skills/
git commit -m "add team skills: review-pr, pre-deploy, onboard"社区也有大量开源 Skills,可以直接安装使用。
来源:Extend Claude with Skills - Claude Code Docs | Anthropic 官方文档