跳转至

Skills介绍

1. 什么是 Claude Skills

Skills（也叫 Agent Skills）是 Anthropic 在 2025 年推出的功能，让用户可以为 Claude 编写可复用的"技能包"。

每个 Skill 是一个文件夹，里面包含：

  • 一份说明文档（SKILL.md）告诉 Claude "这个 skill 是干嘛用的、什么时候用、怎么用"
  • 可选：脚本、参考资料、模板等辅助文件

当 Claude 接到任务时，会自动判断是否需要调用某个 Skill；如果需要，就读取该 Skill 的指引来完成任务。

2. Skills 解决了什么问题

在 Skills 出现之前，让 Claude 完成专项任务有几种方式：

方式 问题
系统 Prompt 难以模块化，一个 prompt 容纳不了多个领域
MCP Server 适合接入"工具/数据"，不适合封装"工作流"
上下文文档 每次对话都要手动粘贴，效率低

Skills 提供了一个轻量但强大的方案：用 Markdown 写一个文件夹，Claude 自动按需加载。

3. Skills 与 MCP 的区别

容易混淆，但二者定位完全不同：

维度 MCP Skills
本质 协议（应用之间通信） 文件夹（指导 Claude 工作）
作用 提供工具和数据 封装工作流和知识
形式 运行的 Server 进程 一组 Markdown + 文件
触发 模型调用 Tool 模型读取 SKILL.md
类比 给手机插一个外设 给厨师一份食谱

简单理解：

  • 想让 Claude 能够做某事（比如查数据库）→ MCP
  • 想让 Claude 学会做某事（比如审查代码的方法论）→ Skills

它们是互补的，复杂场景常常组合使用。

4. Skills 的核心特性

渐进式加载（Progressive Disclosure）

Claude 不会一开始就把所有 Skill 内容塞进上下文，而是按需读取：

  1. 启动时，Claude 只看到所有 Skill 的"名称 + 描述"
  2. 当遇到匹配的任务时，Claude 主动读取 SKILL.md 详细内容
  3. 如果 SKILL.md 提示某些资源（参考文件、脚本），Claude 再读取它们

这种设计让你可以写很多很多 Skill，而不会撑爆上下文。

自动发现

Claude 启动时扫描配置的 Skill 目录，自动加载所有 SKILL.md。新增一个 Skill 只需要新建一个文件夹，不需要重启或注册。

跨会话持久

Skills 写在文件系统里，和具体对话无关。一次写好，所有会话都能用。

可移植

一个 Skill 文件夹可以打包分享给其他人，复制到对方的 Skills 目录就能直接用。

5. Skills 的典型使用场景

场景 Skill 内容
代码审查 公司的 code review 标准、常见反模式、检查清单
写文档 文档模板、风格指南、术语表
写测试 测试设计原则、用例命名规范、模板
API 设计 RESTful 规范、错误码、版本管理
故障排查 排查步骤、常见问题、监控查询
项目脚手架 自动用模板生成新项目结构
数据分析 查询模板、可视化建议、报告格式
写作助手 文章模板、SEO 检查、配图建议

6. Skill 在哪里使用

目前 Skills 在多个 Claude 产品中都支持：

  • Claude.ai（网页版/桌面应用）
  • Claude Code（命令行 AI 编程工具）
  • Claude API（通过 Skills API）
  • Claude Agent SDK（构建自定义 Agent）

不同产品配置位置略有差异，但 Skill 文件本身格式完全一致，一次编写到处使用。

7. 一个 Skill 长什么样

最小的 Skill 只需要一个文件夹和一个 SKILL.md：

my-code-reviewer/
└── SKILL.md

SKILL.md 内容：

---
name: code-reviewer
description: 当用户要求 code review 时使用，按公司规范进行严格的代码审查
---

# Code Reviewer

请按以下步骤对代码进行严格审查：

## 检查清单

1. **可读性**
   - 命名是否清晰？
   - 函数是否短小（< 50 行）？
   - 是否有不必要的注释？

2. **正确性**
   - 边界情况是否处理？
   - 异常路径是否考虑？

3. **性能**
   - 是否有 O(n²) 等可优化的算法？
   - 数据库查询是否有 N+1 问题？

## 输出格式

按以下结构输出：

## 总体评价
（1-2 句话）

## 问题列表
1. [严重程度] 文件:行号 - 问题描述 - 修复建议

就这么简单。Claude 看到这个 Skill 后，每当用户提到"代码审查"，就会自动按这套规范执行。

8. Skills 的优势

优势 说明
简单 写 Markdown 就行，不需要编程
强大 能引用脚本、模板、参考文档
可组合 多个 Skill 可以协作完成复杂任务
可分享 文件夹直接打包发给同事
不污染上下文 渐进式加载，需要才读
零运维 不需要启动 Server，不需要维护进程

9. Skills 的局限

局限 说明
不能执行代码 Skill 本身只是文档，不能像 Tool 一样直接执行
依赖模型理解 模型需要理解 SKILL.md 内容，质量有上限
静态指引 不能像 MCP Tool 那样实时获取动态数据

弥补的方式：在 Skill 中引用脚本让 Claude 来执行，或者配合 MCP Server使用。

10. 学习路径

本系列教程会带你从零掌握 Skills：

  1. 本文：Skills 介绍 （了解全貌）
  2. 快速入门：第一个 Skill （动手）
  3. Skill 的结构 （SKILL.md 详解）
  4. Skill 的触发与渐进式加载 （让 Claude 准确调用）
  5. Skill 中使用脚本和资源 （提升 Skill 能力上限）
  6. Skills 实战案例 （写一个完整的 Skill 套件）

总结

  • Skills 是一组文件夹，每个文件夹包含 SKILL.md 和可选辅助文件
  • 让 Claude 学会做事，与 MCP（让 Claude 能够做事）互补
  • 核心特性：渐进式加载、自动发现、跨会话持久、可移植
  • 适合封装代码审查、文档撰写、故障排查等专项工作流
  • 用 Markdown 编写，不需要编程，写完拷过去就能用

评论