ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;"> ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;">说实话,之前第一次了解到 Claude Agent Skills 这个功能时,我还有点不以为然。不就是个提示词模板吗?能有多大用处?ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;">结果真香。。ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;">用了一段时间后,我发现这玩意儿简直是工作流神器。ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;">比如以前每次跟 Claude Code 对话都要重新解释一遍项目规范,现在直接把专业知识打包成 Skill,Claude Code 自动就懂了。当然Skills的能力远不止于此。ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;">今天这篇文章,我就给大家讲讲Claude Agent Skills到底是什么,为什么这么好用,以及作为小白如何快速上手。ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;">PS:这篇文章适合所有想提升效率的朋友阅读,建议收藏~ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-size: 18px;font-weight: 700;color: rgb(255, 0, 51);margin: 40px 0px 20px;padding: 0px 5px 5px;border-bottom: 4px solid rgb(221, 221, 221);display: inline-block;letter-spacing: 1px;visibility: visible;">首先,Claude Agent Skills 到底是个啥?ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;margin: 15px 0px;letter-spacing: 0.5px;visibility: visible;">还记得你第一次用 Claude Code 写代码的场景吗?ingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;font-size: 16px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;orphans: 2;text-align: justify;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;visibility: visible;">你可能得告诉他:我们团队用 TypeScript,代码风格要用 Prettier,函数命名要 camelCase,组件放在 components 目录,测试文件要加 .spec 后缀...然后过两天你又开了一个新对话,这些话可能又得再说一遍。 烦不烦?太烦了。 Claude Agent Skills 就可以来解决这个问题(虽然Claude.md也可以,但功能有限)。 简单来说,Skills 就是一个个「专业能力包」。你可以把团队的开发规范、项目架构、API 使用说明这些专业知识,打包成一个 Skill 文件夹。 当 Claude 发现你的需求跟某个 Skill 相关时,它会自动加载这个 Skill 的内容,就像给 Claude 配备了一本专业「工作手册」。 打个比方: 没有 Skills 时,Claude Code就像一个通用的程序员助手,什么都能干,但什么都不精通。 有了 Skills 后,Claude Code就像变成了你团队的资深工程师,熟悉你们的所有规范和最佳实践,还能按照你给定的流程去执行任务。 ▲ Claude Skills 工作原理:将团队知识转化为 AI 可理解的「能力包」 那么 Skills 能做什么呢?Skills 的应用场景其实非常广泛,我来举几个实用的例子: 场景一:统一团队代码规范如果你是一个技术团队的管理者,肯定遇到过这样的问题:小张写代码喜欢用双引号,小李喜欢用单引号;老王习惯用 var,新来的实习生只会用 const。 代码风格五花八门,review 的时候头都大了。 有了 Skills,你可以创建一个「编码规范」Skill,里面写清楚: --- name: coding-standards description: 应用团队编码规范,包括命名规则、代码格式和最佳实践。 当编写或审查代码时使用此技能。 ---
# 团队编码规范
## 命名规则 - 变量:camelCase(userName) - 常量:UPPER_SNAKE_CASE(MAX_RETRY) - 函数:camelCase(fetchData) - 类:PascalCase(UserService)
## 代码格式 - 缩进:2 个空格 - 行长度:80 字符 - 字符串:优先使用单引号
以后团队成员用 Claude Code 写代码,Claude Code 就会自动按照这套规范来生成代码。统一规范,so easy! 场景二:代码审查自动化代码审查是开发流程中重要但耗时的一环。你可以创建一个「代码审查」Skill,让 Claude Code 帮你做第一轮审查: --- name: code-reviewer description: 审查代码的最佳实践和潜在问题。 当代码审查、检查 PR 或分析代码质量时使用此技能。 ---
# 代码审查指南
## 审查清单
### 1. 安全性 - 检查注入漏洞(SQL、命令、XSS) - 验证输入验证和清理 - 确保敏感数据处理正确
### 2. 性能 - 识别不必要的计算 - 检查 N+1 查询问题 - 审查算法复杂度
### 3. 可维护性 - 评估代码清晰度 - 检查适当的抽象 - 验证错误处理完整性
以后提交代码前,先让 Claude Code 用这个 Skill 帮你 review 一下,能发现不少低级错误。 场景三:项目架构指南新同事入职,最头疼的就是理解项目结构。你可以把项目的架构说明做成 Skill: --- name: project-architecture description: 提供项目架构指南和目录结构说明。 当创建新文件、重构代码或理解项目结构时使用。 ---
# 项目架构指南
## 目录结构 src/ ├── components/ # 可复用组件 ├── pages/ # 页面组件 ├── services/ # API 服务 ├── utils/ # 工具函数 └── types/ # TypeScript 类型定义
## 文件放置规则 - 组件放在 components/ - 页面放在 pages/ - API 调用放在 services/
这样 Claude Code 在帮你创建新文件时,就会自动按照这个架构来组织代码。 ▲ Skill 目录结构:SKILL.md 是核心,references/ 和 examples/ 存放详细资料 以及Skill其实就是放在.claude/skills/目录下的文件夹 Skills 为什么这么好用?讲了这些场景,Skills 到底好在哪里?我觉得主要有三点: 1. 智能触发,无需手动Skills 不是那种你打/命令才能触发的斜杠命令(最新版本可以打命令了)。Claude 会根据你的问题和 Skill 的描述,自动判断什么时候该用哪个 Skill。 比如你问「帮我审查一下这段代码」,Claude 就会自动加载代码审查 Skill。 你不需要记住任何命令,自然对话就行了。 2. 渐进加载,节省上下文Skills 采用了「渐进式披露」的设计。 SKILL.md 只放核心内容(1500-2000字),包含meta(元数据,就是名称和描述)和指令,一开始只会加载meta数据。 详细的参考资料、完整示例都放在references/和examples/目录里,可执行的代码、脚本都放在script/目录。 Claude Code 只有在需要的时候才会读取这些额外文件,不会浪费宝贵的上下文窗口。 3. 团队共享,一键同步项目级 Skills 放在.claude/skills/目录,直接纳入 git 管理。 团队成员拉取代码后,Skills 自动生效。不用给每个人单独配置,团队规范瞬间统一。 ▲ Skill 智能触发机制:根据用户问题自动匹配并加载相关 Skill 小白如何创建第一个 Skill?好,重点来了。作为小白,怎么创建自己的第一个 Skill? 我手把手教你。 第一步:创建 Skill 目录Skills 分为两种: 个人 Skills:在你所有项目中都可用 mkdir-p~/.claude/skills/my-skill 项目 Skills:只在当前项目有效,团队共享 mkdir-p.claude/skills/my-skill 新手建议先从个人 Skill 开始练习。 第二步:编写 SKILL.mdSKILL.md 是 Skill 的核心,必须要有。格式如下: --- name: git-commit-helper description: 帮助编写清晰的 Git 提交消息。 当需要编写提交消息或查看暂存更改时使用此技能。 ---
# Git 提交消息助手
## 指导原则
1. 运行 `git diff --staged` 查看更改 2. 我会建议包含以下内容的提交消息: - 50 字符以内的摘要 - 详细描述 - 受影响的组件
## 最佳实践
- 使用现在时态 - 说明做了什么和为什么,而不是怎么做
重点说一下 description,这是 Skill 能否被正确触发的关键。 ❌ 不好的示例: description:用于Git提交 太模糊了,Claude Code很难判断什么时候用。 ✅ 好的示例: description: 当用户要求「编写提交消息」、「创建 commit」、 「写 git 提交」或查看暂存更改时使用此技能。
包含了具体的触发词和场景,Claude Code一看就懂。 第三步:测试 Skill创建好后,直接跟 Claude Code 对话测试: 「帮我看看这次改动了什么,写个提交消息」 如果 Skill 配置正确,Claude 会自动加载它,然后按照你定义的规则来生成提交消息。 第四步:添加配套资源(可选)如果 SKILL.md 写得太长,或者想添加一些完整的示例,可以创建配套目录: my-skill/ ├── SKILL.md # 核心说明(必需) ├── references/ # 参考文档(可选) │ └── advanced.md ├── examples/ # 示例文件(可选) │ └── good-commit.txt └── scripts/ # 工具脚本(可选) └── validate.sh
在 SKILL.md 中可以这样引用: ## 更多资源
详细的高级用法请查看 `references/advanced.md`。
参考示例请查看 `examples/good-commit.txt`。
Claude 只在需要时才会读取这些文件,不会占用上下文。 常见问题和小技巧用了一段时间 Skills,我总结了一些常见问题和解决方法。 Q1:Skill 不触发怎么办?首先检查 description 是否包含具体的触发词。如果太模糊,Claude Code很难判断。 比如: description:处理文档#太模糊 改成: description:当处理PDF文件、提取文本、填充表单时使用。 加上具体的文件类型和操作,触发就准确多了。 Q2:内容太多怎么办?SKILL.md 建议控制在 1500-2000 字。如果内容太多,考虑拆分或移到references/。 # ❌ 不好的做法 ## 高级模式 [3000 字的详细说明...]
## 边界情况 [2000 字的案例...]
# ✅ 好的做法 ## 高级模式 详细内容请查看 `references/advanced-patterns.md`。
## 边界情况 处理方法请查看 `references/edge-cases.md`。
Q3:如何让团队共享?把 Skills 放在项目的.claude/skills/目录,提交到 git: git add .claude/skills/ git commit -m "Add team coding standards Skill" git push
团队成员拉取代码后,Skills 立即可用。不用给每个人单独配置。 Q4:可以组合多个 Skills 吗?当然可以! 当你问「创建一个有测试的 React 组件」时,Claude 可能会同时加载: 多个 Skills 协同工作,效果更好。 ▲ Skills 完整工作流程:从创建到自动应用的闭环 最后今天给大家盘了盘 Claude Code Skills 的基础用法和实战场景。 它之所以这么强大,是因为把原本需要反复人工操作,且灵活度高的一些任务,变成了 Claude Code可以自动理解和应用的能力包(可以认为是一套工作流)。 对于个人开发者来说,Skills 能帮你建立个人的开发规范,提升代码质量。还可以实现各种各样的工作流。 对于团队来说,Skills 是统一规范、提升协作效率的工作流神器。 如果你还没试过 Skills,强烈建议从今天开始创建第一个 Skill。不用搞太复杂的,就从 Git 提交消息助手或者编码规范开始 |