Claude Code Skill 最佳实战：EP01 初识 Skill

运维有术

发布于 2026-01-27 14:30:15

780

🚩 2026 年「术」系列实战文档 X 篇原创计划第 4 篇 Agent Skills 最佳实战「2026」系列第 3 篇

大家好，欢迎来到 术哥无界 ShugeX ｜运维有术。我是术哥，一名专注于 AI编程、AI智能体、Agent Skills、MCP、云原生、Milvus 向量数据库的技术实践者与开源布道者！ Talk is cheap, let's explore。无界探索，有术而行。

一个熟悉的场景

周一早上，你打开 Claude Code 准备写代码。写完一个功能，准备提交：

帮我写个 commit message

Claude 给了你一段还不错的提交信息。

周二，又一个功能完成：

帮我写个 commit message，要符合 Conventional Commits 规范

周三：

帮我写个 commit message，Conventional Commits 规范，中文描述，带 scope

周四，你开始烦了-每次都要重复说明这些要求，Claude 又不会记住你的偏好。

这时候，你需要的就是 Skill。

什么是 Skill

Skill 是 Claude Code 的一种扩展机制，本质上是一个包含指令的 Markdown 文件。它的特别之处在于：Claude 会根据对话上下文自动判断是否需要加载这个 Skill。

你不需要每次都告诉 Claude "用某某规范"，只要 Skill 存在，当你说"帮我写 commit message"时，Claude 会自动发现并应用你预设的规范。

一个 Skill 文件长这样：

---
name: my-skill
description: 这里描述 Skill 的功能和触发时机
---

# Skill 标题

具体的指令内容...

文件头部的 name 和 description 是必需的元数据，Claude 会始终读取这部分来判断是否需要加载完整内容。

Skill 的三个核心能力

1. 自动触发

不像 Slash Command 需要你手动输入 /command-name，Skill 是被动触发的。Claude 会根据你的对话内容，自动判断哪些 Skill 与当前任务相关，然后加载它们。

2. 渐进式加载

Skill 采用三级加载架构：

元数据（name + description）始终加载，大约 100 tokens
主体指令在触发时加载，建议控制在 5000 tokens 以内
附带的脚本、模板等资源按需加载

这意味着你可以创建很多 Skill，但只有真正用到的才会消耗上下文窗口。

3. 可复用

一次创建，永久生效。放在 ~/.claude/skills/ 目录下的 Skill 对所有项目生效，放在项目的 .claude/skills/ 目录下则只对当前项目生效。

Skill 和其他机制有什么区别

Claude Code 有好几种扩展机制，初看容易混淆：

机制	加载时机	典型用途
CLAUDE.md	每次对话都加载	项目约定、编码规范
Slash Commands	手动输入触发	固定流程，如 /commit
Skills	自动按需触发	领域专业知识
Subagents	调用时启动	委托独立子任务

简单说：

CLAUDE.md 是始终生效的规则
Commands 是我要你现在做这件事
Skills 是当遇到这类问题时，用这套方法

举个例子：你可以在 CLAUDE.md 里写本项目使用 TypeScript，创建一个 /deploy Command 来执行部署流程，再创建一个 api-design Skill 来指导 API 设计规范。

动手实践：创建你的第一个 Skill

说了这么多，不如直接上手。我们来创建一个 Git Commit Message 规范化的 Skill。

第一步：创建目录

mkdir -p ~/.claude/skills/commit-message

第二步：创建 Skill 文件

在 ~/.claude/skills/commit-message/ 目录下创建 SKILL.md 文件：

---
name: commit-message
description: 生成规范的 Git commit message。当用户请求编写提交信息、commit message、或完成代码修改准备提交时自动触发。
---

# Git Commit Message 规范

## 格式要求

遵循 Conventional Commits 规范，格式如下：

<type>(<scope>): <subject>

<body>

## Type 类型

- feat: 新功能
- fix: Bug 修复
- docs: 文档更新
- style: 代码格式调整（不影响逻辑）
- refactor: 重构（既不是新功能也不是修复）
- perf: 性能优化
- test: 测试相关
- chore: 构建过程或辅助工具变动

## 规则

1. subject 使用中文，不超过 50 字
2. subject 不要以句号结尾
3. scope 用英文小写，表示影响范围（如 auth、api、ui）
4. body 部分可选，用于解释 why 而不是 what
5. 如果有 Breaking Change，必须在 body 中说明

## 示例

feat(auth): 添加微信扫码登录功能

fix(api): 修复用户列表分页参数错误

refactor(utils): 重构日期格式化工具函数

提取公共逻辑，支持更多日期格式

第三步：测试效果

打开 Claude Code，随便改点代码，然后说：

帮我写个 commit message

你会发现 Claude 自动按照你定义的规范生成了提交信息——中文描述、Conventional Commits 格式、带 scope。

不需要每次都重复说明要求，Skill 会自动生效。

几个实用技巧

1. description 要写清楚触发条件

description 是 Claude 判断是否加载 Skill 的关键依据。写得太模糊，可能该触发时不触发；写得太宽泛，可能不该触发时乱触发。

好的写法：

description: 生成规范的 Git commit message。当用户请求编写提交信息、commit message、或完成代码修改准备提交时自动触发。

不好的写法：

description: 帮助写代码

2. 指令要具体可执行

不要写生成高质量的代码这种空话，要写具体的规则和示例。Claude 需要明确的指令才能稳定输出。

3. 控制 Skill 的大小

主体指令建议控制在 5000 tokens 以内。如果内容太多，考虑拆分成多个 Skill，或者把详细文档放到单独的资源文件中。

什么时候该创建 Skill

一个简单的判断标准：当你发现自己向 Claude 解释同一件事超过 3 次，就该考虑创建 Skill 了。

适合创建 Skill 的场景：

团队有固定的代码规范或文档标准
某类任务有特定的处理流程
需要 Claude 记住某个领域的专业知识

不适合创建 Skill 的场景：

一次性任务
每次上下文都不一样
还在摸索最佳实践，流程不稳定

小结

Skill 的核心价值在于：把重复的指令封装起来，让 Claude 自动应用。

它不是什么高深的技术，就是一个 Markdown 文件。但用好了，能显著提升你和 Claude 协作的效率——不用每次都重复说明要求，不用担心 Claude 忘记你的偏好。

今天介绍的是最基础的 Skill 用法：一个 SKILL.md 文件搞定一切。但 Skill 的能力远不止于此。

下篇预告

下一篇文章，我们会深入 Skill 的进阶用法：

如何在 Skill 中引用外部脚本
如何组织多文件资源（模板、配置、文档）
如何让 Skill 调用 MCP 工具
实战案例：创建一个带模板的周报生成 Skill

敬请期待。

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。

原始发表：2026-01-24，如有侵权请联系 cloudcommunity@tencent.com 删除

工具

本文分享自运维有术微信公众号，前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度