教程

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 自定义斜杠命令完全指南:用 /命令 封装常用工作流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教程OpenClaw Skills 开发指南:从零打造你的专属 AI 工作流插件OpenClaw Skills 完整开发教程:Skills 工作原理、SKILL.md 文件格式、触发机制(关键词/描述匹配)、脚本和资源文件组织、发布到 ClaWHub 市场,以及 5 个实用 Skill 开发案例(天气/代码审查/日报生成/数据监控/自动翻译)。2026/3/15教程Claude Code 插件开发指南:plugin.json 结构、Skills/Hooks/MCP 集成与官方市场提交Claude Code 插件开发完整指南:独立配置 vs 插件对比(命名空间/适用场景)、5 步快速创建(目录/plugin.json 清单字段/Skill/本地 --plugin-dir 测试/分享)、完整插件目录结构(.claude-plugin/commands/skills/agents/hooks/mcp/.lsp.json/settings.json)、各组件配置示例(Skills SKILL.md/LSP 服务器.lsp.json/默认 settings.json agent 键)、从独立配置迁移步骤对比表、三步调试方法,以及通过 claude.ai 和 Console 提交官方市场的方式。2026/3/8教程Claude Code Skills 完全指南:创建自定义技能、Bundled Skills 与高级模式Claude Code Skills 完全指南:5 个内置 Bundled Skills(/simplify 并行 3 Agent/\batch Git Worktree 并行/\debug 会话日志/\loop 定时执行/\claude-api 自动激活)、3 步创建自定义 Skill(目录/SKILL.md/测试)、存储位置与优先级(Enterprise/Personal/Project/Plugin 命名空间)、Frontmatter 完整配置(name/description/disable-model-invocation/tools)、两种内容类型(参考型内联/任务型手动)、高级模式($ARGUMENTS 字符串替换/支持文件目录/动态注入上下文/子 Agent 执行),以及三种共享方式和故障排查。2026/3/8教程Claude Code Hooks 实战指南:5 大自动化场景、三种 Hook 类型与故障排查Claude Code Hooks 实战指南:/hooks 交互菜单四步创建桌面通知 Hook、5 大常用自动化场景(等待通知/编辑后 Prettier 格式化/退出码 2 阻止受保护文件/PostCompact 重注入上下文/ConfigChange 审计日志)、四种 Hook 类型(command/prompt-based/agent-based/HTTP Webhook)、输入/输出机制(stdin JSON/stdout 注入上下文/退出码 0 继续/2 阻止/非零警告)、结构化 JSON 输出、Matcher 过滤器语法(Edit|Write/Bash(git *)/*/空字符串)、四级存储位置,以及五大故障排查方法和调试技巧。2026/3/8