Skills 自定义命令

Skills 系统让你把常用工作流封装成自定义斜杠命令，一键触发。

为什么用 Skills？

复用 — 把好的 prompt 变成可反复使用的工具
标准化 — 团队共享统一的工作流
高效 — 一条命令替代一大段描述
按需加载 — 不像 CLAUDE.md 每次都加载，Skills 只在需要时加载

创建项目级命令

在 .claude/commands/ 目录下创建 Markdown 文件：

示例：部署命令

.claude/commands/deploy.md：

按照以下步骤部署项目：
1. 先运行 pnpm typecheck 确保类型检查通过
2. 运行 pnpm test 确保所有测试通过
3. 运行 pnpm build 构建项目
4. 如果以上都成功，执行 pnpm deploy:prod
5. 部署成功后，通知我部署结果

使用方式：

/project:deploy

示例：代码审查

.claude/commands/review.md：

审查 $ARGUMENTS 中的代码变更：

1. 检查代码质量
   - 命名是否清晰
   - 逻辑是否简洁
   - 是否有重复代码

2. 检查安全性
   - SQL 注入
   - XSS 攻击
   - 硬编码密钥

3. 检查性能
   - 不必要的循环
   - 缺失的缓存
   - N+1 查询

输出格式：按严重程度分类，每条附带修复建议。

使用方式：

/project:review src/api/users.ts

$ARGUMENTS 会被替换为你传入的参数。

创建个人全局命令

放在 ~/.claude/commands/ 下，所有项目都能用：

示例：日报生成

~/.claude/commands/daily.md：

基于今天的 git commit 历史，生成一份简洁的工作日报：

1. 查看今天的所有 commit
2. 按功能模块分类
3. 用中文写一份简短的日报

格式：
## 今日工作
- [模块名] 具体做了什么

全局可用：

/user:daily

SKILL.md 文件

更正式的 Skills 放在 .claude/skills/ 目录下：

.claude/skills/SKILL.md：

---
name: api-generator
description: 自动生成 RESTful API 的路由、控制器和模型
---

根据用户描述的资源，生成完整的 RESTful API：

1. 创建数据模型 (src/models/)
2. 创建控制器 (src/controllers/)
3. 创建路由 (src/routes/)
4. 创建验证规则 (src/validators/)
5. 创建测试 (src/__tests__/)

遵循项目现有的代码风格和架构模式。

Skills 和 CLAUDE.md 的区别：

CLAUDE.md 每次都加载，适合通用规范
Skills 按需加载，适合特定领域知识
Skills 不消耗每次会话的基础上下文

团队协作

项目级的命令和 Skills 可以提交到 Git：

.claude/
├── commands/
│   ├── deploy.md
│   ├── review.md
│   └── test-e2e.md
└── skills/
    └── SKILL.md

团队成员 clone 项目后，立即拥有所有自定义命令。新人入职，/project:deploy 就能正确部署，不需要记住复杂的步骤。

Skills 自定义命令

On this page