Claude Code Skills 详解：打造你的专属命令库
为什么需要 Skills
用 Claude Code 开发，你迟早会遇到这些场景：
每次做代码审查，都要打一大段提示词告诉 Claude 该看什么、怎么看。每次写博客，都要重新描述格式、风格、目录结构。每次写测试，都要解释一遍项目的测试规范。
同样的话说了十遍，你不烦，Claude 也不累，但你的时间在流失。
更头疼的是团队协作——你摸索出了一套高效的 Claude 使用方式，但团队里其他人还在各玩各的。知识没法沉淀，效率没法拉齐。
这时候你需要 Skills。
Skills 是什么
Skills 是 Claude Code 的自定义斜杠命令功能。简单说，就是把你常用的提示词写成一个 Markdown 文件，然后用 /命令名 一键调用。
比如你创建了一个叫 review 的 Skill，之后只需要输入：
/reviewClaude 就会按照你预设的规则做代码审查——不用每次重新描述，不用担心遗漏步骤。
Skills 的本质就是：可复用、可共享、可版本管理的提示词模板。
关于历史：Claude Code 早期有两个概念——commands（命令）和 skills（技能），分别放在不同目录。现在它们已经合并了，统一叫 Skills，但旧的 .claude/commands/ 目录仍然兼容。
目录结构与作用域
Skills 有两个作用域：项目级和个人级。
项目级 Skills
放在项目的 .claude/skills/ 目录下，跟随代码仓库一起版本管理，团队所有人共享：
项目根目录/
.claude/
skills/
review/
SKILL.md # Skill 定义文件
gen-test/
SKILL.md
template.ts # 辅助文件每个 Skill 是一个文件夹，文件夹名就是命令名。核心文件是 SKILL.md，其他文件都是可选的辅助材料。
个人级 Skills
放在 ~/.claude/skills/ 目录下，只有你自己能用，不会提交到代码仓库：
~/.claude/
skills/
my-style/
SKILL.md
daily-report/
SKILL.md适合放一些个人习惯相关的命令，比如你偏好的代码风格、日报模板等。
优先级
当项目级和个人级存在同名 Skill 时，项目级优先。这很合理——项目规范应该覆盖个人偏好。
SKILL.md 文件格式
每个 SKILL.md 由两部分组成：YAML frontmatter 和 Markdown 正文。
Frontmatter 字段
---
name: review
description: 按照团队规范做代码审查，检查安全性、性能和可维护性
allowed-tools:
- Read
- Glob
- Grep
disable-model-invocation: false
---各字段含义：
| 字段 | 必填 | 说明 |
|---|---|---|
name | 是 | 命令名，输入 /name 触发 |
description | 是 | 描述这个 Skill 做什么，也是 Claude 判断是否自动触发的依据 |
allowed-tools | 否 | Skill 激活时自动授权的工具列表，免去逐次确认 |
disable-model-invocation | 否 | 设为 true 则 Claude 不会自动触发，只能手动 /name 调用 |
name：变成 /斜杠命令。比如 name: review，调用时就是 /review。
description：这个字段很关键。Claude 会读取所有 Skill 的描述，判断当前任务是否匹配某个 Skill。写得好，Claude 能在合适的时机自动帮你调用。
allowed-tools：Skill 运行时自动放行的工具。比如一个只读类的审查 Skill，可以授权 Read、Glob、Grep，这样 Claude 执行时不会每次都弹确认框。
disable-model-invocation：默认 false，即 Claude 可以根据上下文自动触发。设为 true 后，只有你手动输入 /命令名 才会执行。敏感操作建议开启。
Markdown 正文
Frontmatter 下面就是给 Claude 的指令，用 Markdown 写：
## 审查步骤
1. 先用 Grep 搜索本次改动涉及的文件
2. 逐个文件检查以下内容：
- 是否存在安全漏洞（SQL 注入、XSS 等）
- 是否有性能问题（N+1 查询、不必要的渲染等）
- 命名是否清晰，逻辑是否可维护
3. 输出审查报告，按严重程度排列问题
## 输出格式
用表格列出问题，包含：文件名、行号、严重程度、问题描述、修复建议把 frontmatter 和正文组合起来，就是一个完整的 SKILL.md。
辅助文件
SKILL.md 所在的文件夹里，可以放额外的辅助文件来增强 Skill 的能力：
| 文件类型 | 用途 | 示例 |
|---|---|---|
| 模板文件 | 让 Claude 按模板填充内容 | template.md、component.tsx |
| 示例输出 | 告诉 Claude 期望的输出格式 | example-output.md |
| 脚本文件 | 让 Claude 执行特定脚本 | run-check.sh |
| 参考文档 | 提供领域知识或规范说明 | style-guide.md |
在 SKILL.md 正文里引用这些文件即可：
## 模板
请参考同目录下的 `template.tsx` 作为组件模板。
## 示例
期望的输出格式见 `example-output.md`。这样 Claude 就知道去读取这些文件，按照模板和示例来执行任务。
实际使用场景
场景一：代码审查 Skill
团队统一的代码审查标准，所有人用同一个命令：
.claude/skills/review/SKILL.md---
name: review
description: 按照团队标准审查代码变更，检查安全性、性能和代码质量
allowed-tools:
- Read
- Glob
- Grep
- Bash
---## 任务
审查当前分支相对于 main 的所有变更。
## 检查项
1. **安全性**：注入攻击、敏感信息泄露、权限检查
2. **性能**：N+1 查询、大量数据加载、不必要的重渲染
3. **代码质量**：命名规范、函数长度、重复代码
4. **测试覆盖**：新增逻辑是否有对应测试
## 输出
按严重程度输出问题列表，每个问题包含文件、行号和修复建议。团队里任何人输入 /review，都能得到一致标准的代码审查。
场景二：博客写作 Skill
把你写博客的规范固化成 Skill：
.claude/skills/blog/SKILL.md---
name: blog
description: 按照项目规范写中文博客文章
allowed-tools:
- Read
- Glob
- Write
disable-model-invocation: true
---## 任务
根据用户提供的主题写一篇中文博客。
## 规范
- 文件位置：src/data/blog/zh/<slug>.md
- frontmatter 必填：title, description, date, tags, lang: zh
- 风格：口语化，第二人称，多用加粗强调关键点
- 结构：为什么需要 → 是什么 → 怎么用 → 实际场景 → 技巧 → 总结以后写博客，/blog 一键启动，格式、风格全部自动对齐。
场景三：测试生成 Skill
项目的测试有特定的写法和规范，用 Skill 固化下来：
.claude/skills/gen-test/SKILL.md---
name: gen-test
description: 为指定文件生成单元测试，遵循项目测试规范
allowed-tools:
- Read
- Glob
- Grep
- Write
---## 任务
为用户指定的源文件生成单元测试。
## 规范
- 测试框架：Jest
- 文件命名：<原文件名>.test.ts
- 每个导出函数至少 3 个测试用例：正常输入、边界值、异常输入
- 使用 describe/it 嵌套结构
- Mock 外部依赖，不要发真实网络请求输入 /gen-test src/utils/format.ts，Claude 自动按规范生成测试。
实用技巧
技巧一：善用 allowed-tools 免确认
如果一个 Skill 只做读取和分析，把 Read、Glob、Grep 加到 allowed-tools 里。这样 Claude 执行时不会反复弹确认框，体验丝滑很多。
但要注意：写入类工具（Write、Edit）谨慎授权，尤其是会修改代码的 Skill，保留人工确认更安全。
技巧二：用 disable-model-invocation 防误触
有些 Skill 的 description 写得比较宽泛，Claude 可能在不该触发的时候自动触发了。把 disable-model-invocation 设为 true，确保只有你手动输入 /命令名 才会执行。
经验法则：只读类的 Skill 可以让 Claude 自动触发，写入类或敏感操作的 Skill 建议手动触发。
技巧三：利用 Anthropic 官方 Skills 仓库
Anthropic 在 GitHub 上维护了一个官方 Skills 仓库（anthropics/skills），里面有不少开箱即用的 Skill，比如 skill-creator——一个专门帮你创建新 Skill 的 Skill。
可以直接复制到你的项目里，或者参考它们的写法来创建自己的 Skill。
技巧四：注意上下文预算
Claude 会把所有 Skill 的名称和描述加载到上下文中。如果 Skill 太多，描述会被截断。默认预算是上下文窗口的 1%，可以通过环境变量调整：
export SLASH_COMMAND_TOOL_CHAR_BUDGET=16000所以 description 要写得精炼有效——用最少的字说清楚这个 Skill 干什么、什么时候该用。
写在最后
Skills 解决的问题很简单：把你的经验变成可复用的命令。
用 Claude Code 做开发，每个人都会积累出一套自己的”最佳实践”——怎么审查代码、怎么写测试、怎么做重构。但如果这些经验只存在你的脑子里，每次都靠手打提示词来传达，那它就是不可扩展的。
把它写成 Skill，团队共享，版本管理，一个 /命令 就能调用。个人经验变成团队能力，一次沉淀永久复用。
一个文件夹，一个 SKILL.md，撬动整个团队的 AI 效率。
相关推荐
AI-first 创业公司，为什么只需要一种编程语言？
技术架构越简单 = AI Coding 效率越高。从 Java 的"防人"设计到 TypeScript 全栈通吃，聊聊 AI 时代创业公司的编程语言选择。
cc-ping：一行命令 Ping 所有 Claude Code 配置
用多个 Claude Code API Key 或中继？cc-ping 帮你管理配置、一键切换，还能并行 Ping 所有节点比速度。
震惊！程序员用这个工具，4分钟干完95分钟的活！效率暴涨24倍
躺床上发3条消息，4分钟搞定3个项目。传统方式需要95分钟，这就是冷兵器和热兵器的差距。
CCBot - 研发提效 24 倍
通过 IM 机器人控制 Claude Code，3 个项目 4 分钟全部搞定。传统编程需要 95 分钟，效率提升 24 倍。
Claude Code /add-dir：被低估的 Monorepo 神器
Claude Code 默认只能看到当前目录。/add-dir 打破这个限制——分享我每天跨 5 个仓库使用的经验。
Claude Code 省 Token 小技巧：感叹号的妙用
一个简单却容易被忽略的技巧——用感叹号直接执行命令，省 token、提速度、更可控。
我做了个机器人，让团队在飞书里用 Claude Code
CCBot 让你的团队在飞书群聊里直接用 Claude Code——不需要终端、不需要 SSH。开源、自部署、五分钟搞定。
Claude Code /btw 命令详解：不打扰主线的快问快答
详细介绍 Claude Code 的 /btw 命令——它是什么、怎么用、什么时候该用，以及它和子代理、/compact 的区别。
Claude Code /compact：释放上下文，不丢进度
任务做到一半上下文满了？/compact 帮你压缩对话继续干活——和 /clear、/rewind 的区别一次讲清。
Claude Code /config：一文搞懂所有可调设置
用 Claude Code 却从没打开过 /config？这篇带你逐项拆解——从权限模式到自动压缩，从主题切换到通知配置，帮你打造最顺手的 AI 编程环境。
Claude Code /context：你的上下文都被什么吃了？
对话到一半 Claude Code 说上下文不够了？/context 用一张可视化网格告诉你：上下文被什么占了、占了多少、怎么优化。
Claude Code /diff：这次对话改了什么，一目了然
Claude Code 帮你改了一堆文件，但你不确定到底改了什么？/diff 用交互式界面展示所有改动——既有 git 视角的全量 diff，也有按对话轮次拆分的逐步 diff。
Claude Code /fast：同样的 Opus，两倍速——值不值？
/fast 不会降级模型，还是 Opus，只是更快。什么时候该开、什么时候该关，以及实际体验差异。
Claude Code 引用外部知识的最佳实践：GitHub MCP + Context7
用 GitHub MCP 和 Context7 MCP 两个工具组合，解决 Claude Code 知识过时导致的代码错误问题。
Claude Code /hooks：让 AI 按你的规矩办事
想在 Claude Code 执行命令前自动检查？想在任务完成后自动通知？/hooks 让你用脚本、AI 甚至 HTTP 请求，在关键节点插入自定义逻辑。
Claude Code /init：10 秒自动生成 CLAUDE.md
别再手写 CLAUDE.md 了。看看 /init 自动生成的效果、怎么自定义输出，以及一个让 Claude Code 效率翻倍的小技巧。
Claude Code MCP：让 AI 连接 GitHub、数据库等一切工具
MCP 把 Claude Code 从代码阅读器升级为全栈 Agent。哪些 MCP 服务器值得装、配置怎么写，实测分享。
Claude Code /memory 详解：让 AI 真正记住你的项目
详细介绍 Claude Code 的 /memory 命令和记忆系统——CLAUDE.md 手动指令、Auto Memory 自动记忆、模块化规则，让 Claude 跨会话记住项目规范和个人偏好。
Claude Code /model：Opus、Sonnet、Haiku 怎么选？
不是每个任务都需要 Opus。怎么切换模型、哪个场景用哪个、怎么省 token 又不掉质量。
Claude Code /permissions：谁能干什么，你说了算
每次 Claude Code 要跑命令都弹窗问你？嫌烦又不敢全放开？/permissions 帮你精细控制每个工具的权限——该放的放，该拦的拦。
Claude Code /plan 详解：先想清楚再动手
详细介绍 Claude Code 的 /plan 命令和 Plan Mode——只读规划模式，让 Claude 先分析代码、制定方案，确认后再动手，避免复杂任务翻车。
Claude Code + Playwright MCP：AI 终于能"看见"页面了
一个 Modal 溢出的 bug，Claude Code 反复修了 5 次都没搞定。直到接入 Playwright MCP 让它真正看到页面，一次定位，一次修复。
Claude Code /resume 命令详解：别让对话白聊
详细介绍 Claude Code 的 /resume 命令——恢复历史对话、管理会话、实用技巧，让你的每一轮对话都不浪费。
Claude Code /review：让 AI 帮你做 Code Review
提了 PR 没人看？想在合并前多一道把关？/review 让 Claude Code 像一个资深开发者一样审查你的代码——还有 /ultrareview 和 /security-review 两个进阶选择。
Claude Code /stats：看看 AI 到底帮你写了多少代码
好奇 Claude Code 到底写了多少行代码？/stats 给你完整数据——token、编辑次数、工具调用，教你怎么看。
Claude Code /status 命令详解：一眼看清会话全貌
详细介绍 Claude Code 的 /status 命令——它是什么、怎么用、能看到哪些信息，以及它在日常工作流中的实际价值。
Claude Code /tasks 命令详解：后台任务尽在掌控
详细介绍 Claude Code 的 /tasks 命令——查看后台任务、管理并行 Agent、掌控长时间运行的进程，让多任务开发井井有条。
Claude Code /usage 命令详解：你的额度还剩多少
详细介绍 Claude Code 的 /usage 命令——查看用量、了解限额、避免突然被限速，让你对自己的额度心中有数。
Claude Code /vim：在 AI 编程助手里用 Vim 键位
习惯了 Vim 的操作方式？/vim 让你在 Claude Code 的输入框里用 hjkl 移动、dd 删行、ciw 替换单词——不用改变肌肉记忆。
Claude Code 使用指南：从安装到实战，一篇就够（2026）
用了半年 Claude Code 的经验总结——5 分钟安装配置、最常用的命令、CLAUDE.md 编写技巧，以及没人告诉你的实战心得。
Claude 全家桶：从聊天到写代码到自动办公，一文讲清楚
一篇文章带你了解 Anthropic 的 Claude 全家桶——Claude.ai、Claude Code、Claude Cowork，以及 Opus、Sonnet、Haiku 三大模型家族。
Claude Code /agents 详解：自定义 AI 子代理，各司其职
详细介绍 Claude Code 的 /agents 命令——查看、管理和创建自定义 Agent，让不同任务由专门的 AI 角色来执行，从代码探索到架构规划各司其职。
Claude Code /doctor 详解：一键诊断你的开发环境
详细介绍 Claude Code 的 /doctor 命令——自动检测安装状态、API 连接、MCP 配置、上下文用量等问题，帮你快速定位和修复环境故障。
Claude Code /effort 详解：控制 AI 思考的深度
详细介绍 Claude Code 的 /effort 命令——调节 Claude 的推理努力程度，在速度和质量之间找到最佳平衡点，让每一次对话都恰到好处。
Claude Code /cost 详解：你的 AI 编程到底花了多少钱
详细介绍 Claude Code 的 /cost 命令——实时查看会话 API 成本，了解各模型定价和 Token 消耗明细，让每一分钱都花得明明白白。
Claude Code /export 详解：把 AI 对话带走
详细介绍 Claude Code 的 /export 命令——将对话导出为文件或复制到剪贴板，方便分享、存档和复盘，让每一次有价值的对话都不浪费。
Claude Code /rewind 详解：AI 改错了？一键回退
详细介绍 Claude Code 的 /rewind 命令——将代码和对话回退到任意历史节点，支持只回退代码、只回退对话、或两者同时回退，是你和 AI 协作时的后悔药。
Claude Code /plugin 详解：给你的 AI 编程助手装插件
详细介绍 Claude Code 的 /plugin 命令——管理插件的安装、启用、禁用和更新，通过插件扩展 Claude Code 的命令、技能、Agent 和 Hook，打造你专属的 AI 编程工具链。
Claude Code /theme 详解：给你的终端换个好看的皮肤
详细介绍 Claude Code 的 /theme 命令——6 种预设主题 + 自动模式，支持深色/浅色、色盲友好、ANSI 兼容，60+ 色值覆盖终端全部 UI 元素。
Claude Code /insights 详解：用 AI 分析你自己用 AI 的方式
详细介绍 Claude Code 的 /insights 命令——五阶段数据分析流水线、七大洞察章节、多维度会话统计，用 Claude Opus 生成专属 HTML 使用报告。
Claude Code /rename 详解：给你的会话取个有意义的名字
详细介绍 Claude Code 的 /rename 命令——手动命名、AI 自动生成（Haiku 模型）、启动参数命名、Plan 模式自动命名，以及双标题系统与 Bridge 同步机制。
Claude Code settings.json 详解（一）：配置文件在哪里、谁说了算
全面介绍 Claude Code 的配置文件体系——五个配置来源的路径、优先级规则、数组合并与单值覆盖的区别、企业管理设置的多种下发方式。
Claude Code settings.json 详解（二）：permissions 权限系统全解析
深入解析 Claude Code 的 permissions 配置——allow/deny/ask 三类规则、通配符语法、MCP 工具权限、defaultMode 各模式含义，以及 additionalDirectories 的作用。
Claude Code settings.json 详解（三）：hooks 钩子全解析
深入解析 Claude Code 的 hooks 配置——四种钩子类型、核心事件（PreToolUse/PostToolUse/Stop/Notification）、stdin/stdout 协议、exit code 语义，以及实用配置示例。
Claude Code settings.json 详解（四）：env、模型、认证与其他实用字段
全面介绍 Claude Code settings.json 中的 env 环境变量注入、模型配置、身份认证辅助、Git 提交署名、会话清理、语言与界面、思考深度、自动更新、记忆系统等实用字段。
Claude Code Agent Loop：拆解 AI 编程助手的心脏
Claude Code 是怎么一步步理解你的需求、调用工具、自我修复的？从源码角度拆解 Agent Loop 的核心架构——流式响应、并行工具执行、自动压缩、错误恢复，一次讲透。