教程

Claude Code Skills 自定义命令:打造你的团队专属 AI 工作流

Claude Code Skills 自定义命令完整教程:Skills vs CLAUDE.md 使用场景对比、内置 Skills 速览(/batch/simplify/loop)、SKILL.md 文件格式与 Frontmatter 配置、四大实用 Skills 示例(代码审查/部署检查/功能开发/团队 OnBoarding)、传参方式、子代理执行与 Git 团队共享。

2026/3/145分钟 阅读ClaudeEagle

每个团队都有自己的开发流程:代码审查规范、部署步骤、文档模板……每次都要把这些背景信息喂给 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 文件格式

markdown
---
name: review-pr
description: 审查 PR 代码质量。当用户说"审查这个PR"、"code review"或提到代码质量时自动调用
---

按以下维度审查这个 PR:

## 1. 安全性检查
- SQL 注入:所有查询使用参数化?
- XSS:用户输入是否正确转义?
- 认证:所有敏感端点是否有权限验证?

## 2. 代码质量
- 是否有重复代码可以提取?
- 错误处理是否完整?
- 命名是否清晰表达意图?

## 3. 测试覆盖
- 新功能是否有对应测试?
- 边界条件是否覆盖?

## 输出格式
按严重程度(Critical/High/Medium/Low)排列问题,
每个问题注明文件和行号,
附修复建议。

最后给出 0-10 分的总体评分和一句话总结。

Frontmatter 中的 description 字段决定 Claude 何时自动加载这个 Skill。

调用方式

bash
# 直接调用
/review-pr

# 带参数调用
/deploy staging
/batch 将所有 console.log 替换为 logger.info

实用 Skills 示例库

1. 部署检查清单

markdown
---
name: pre-deploy
description: 部署前检查清单。在用户说"部署"或"上线"时使用
---

执行以下部署前检查:

1. **运行完整测试套件**
   ```bash
   npm test

确认全部通过,记录覆盖率

  1. 检查环境变量 确认 .env.example 里的所有变量在目标环境已配置

  2. 安全扫描 检查是否有硬编码的密钥或敏感信息

  3. 依赖检查

    bash
    npm audit

    修复所有 high/critical 漏洞

  4. 生成 Changelog 条目 根据本次 commit 自动生成,放入 CHANGELOG.md

所有检查通过后,给出部署许可或阻止清单。

### 2. 代码解释(图文并茂) ```markdown --- name: explain-code description: 用图表和类比解释代码。当用户问"这是什么意思"、"怎么运作的"时自动触发 --- 解释代码时必须包含: 1. **日常类比**:用生活中的例子比喻这段代码做的事情 2. **ASCII 流程图**:展示数据流向或函数调用链 3. **逐步讲解**:每个关键步骤一句话 4. **常见误区**:这里最容易犯什么错误? 风格:像讲给刚入行一年的同事,技术准确但不卖弄。

3. 新功能开发模板

markdown
---
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 助手

markdown
---
name: onboard
description: 帮助新成员理解项目。当有人说"我是新来的"或"帮我了解这个项目"时使用
---

为新成员生成项目快速入门:

1. **项目概览**:这个项目是做什么的,解决什么问题
2. **架构图**:用 ASCII 图展示主要模块和数据流
3. **快速上手**:从 clone 到本地运行跑通的步骤
4. **关键文件导览**:最重要的 5-10 个文件及其作用
5. **开发规范速查**:最需要注意的编码约定
6. **常见问题**:新人最容易踩的坑

输出为 Markdown,可以直接保存为 ONBOARDING.md。

传参给 Skills

在 SKILL.md 里用 $ARGUMENTS 接收调用时传入的参数:

markdown
---
name: review-file
---

审查文件:$ARGUMENTS

重点检查:
- 与同目录其他文件的风格一致性
- 是否有未处理的错误情况

调用:/review-file src/auth/login.ts

在子代理里运行 Skill

复杂任务可以让 Skill 在独立的子代理上下文里运行,避免污染主对话:

markdown
---
name: security-audit
agent: subagent  # 在子代理里运行
description: 完整安全审计,在隔离环境运行
---

对整个代码库进行安全审计...
(详细指令)

分享和复用

项目 Skills 通过 Git 自动共享给团队,放在 .claude/skills/

bash
git add .claude/skills/
git commit -m "add team skills: review-pr, pre-deploy, onboard"

社区也有大量开源 Skills,可以直接安装使用。


来源:Extend Claude with Skills - Claude Code Docs | Anthropic 官方文档

相关文章推荐

教程Claude Code Slack 集成完全指南:让团队在工作频道里直接触发 AI 编程任务Claude Code Slack 集成完整指南:5 大核心能力(代码问答/任务执行/代码审查/CI 通知/团队协作)、按频道设置权限(read/write/execute/pr 四级)、人工审批工作流配置、GitHub Actions CI 失败自动触发 Claude 分析和修复、4 个团队场景(技术支持/新人上手/PM 提需求/凌晨紧急修复),以及 Slack 集成安全最佳实践。2026/4/26教程Claude Code Routines 深度指南:在 CLAUDE.md 中定义团队级可复用工作流Claude Code CLAUDE.md Routines 完整教程:与 Cloud Routines 的区别厘清、10 个真实项目模板(组件脚手架/API 端点/Debug 溯源/安全审查/完整功能实现等),以及团队 Routine 与个人 Routine 的最佳实践。2026/4/17教程Claude Code 自定义斜杠命令完全指南:用 /命令 封装常用工作流Claude Code 自定义斜杠命令(slash commands)完整教程:命令文件创建位置(.claude/commands/)、Markdown 格式规范、$ARGUMENTS 参数传递、项目级命令 vs 用户全局命令的区别、实用命令示例(/review、/test、/deploy-check、/refactor、/standup)、命令组合调用,以及如何在团队中共享和版本管理自定义命令。2026/3/18教程Claude Code Skills 完全指南:创建自定义技能、内置技能与子代理执行Claude Code Skills 完全指南:三个内置技能(/simplify、/batch、/debug)、创建自定义 Skill 的完整步骤、Frontmatter 字段参考(invocation/tools 控制)、动态上下文注入、子代理执行,以及 Skills 的共享和发现方式。2026/3/2教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10教程Claude Code Slack 集成完整指南:团队协作、CI 通知和权限管理Claude Code Slack 集成完整指南:5 大核心功能(频道触发任务/代码问答/CI 通知/PR 审查/Routines 结果推送);安装配置步骤;4 个权限等级(read/write/execute/pr)及频道级配置;人工审批工作流;GitHub Actions + Slack 通知自动化;4 个团队协作场景(新人上手/PM 提需求/频道分工规范/结构化请求模板);以及官方 Slack 集成 vs OpenClaw 方案的对比。2026/5/8