如果你最近在关注 AI Agent 的工程化落地一定绕不开一个词Agent Skills。过去一年我们讨论最多的方案是 MCPModel Context Protocol它帮 Claude、Cursor 这类 AI 编程工具接上了数据库、浏览器、各类 API解决的是“AI 能调用什么”的问题。而现在Anthropic 推出的 Agent Skills 则是在回答另一个问题AI 能不能像人一样学会一套固定的做事方法然后在项目里稳定复用一句话概括MCP 给 AI 装上了手Skills 给 AI 装上了大脑里的“工作手册”。这篇文章不打算只做概念科普。我会从实际开发场景出发讲清楚 Agent Skills 解决的是什么痛点、它和 MCP 有什么区别、如何创建一个属于自己的 Skill、如何从 marketplace 安装开箱即用的 Skills以及在什么时候应该用它、什么时候不应该用它。如果你是 AI 应用开发者、前端工程师、测试工程师或者正在研究 Agent 工作流落地这篇文章值得收藏。1. 这篇文章真正要解决的问题先讲一个真实场景。假设团队里有一个成熟的代码规范文档规定了 React 组件怎么命名、样式用 CSS Modules 还是 Tailwind、提交信息怎么写。你把这些内容贴给 Claude它能理解也能照做。但问题是每个新会话都要重新贴一次而且每次贴的内容可能不太一样Claude 的执行结果也就飘忽不定。再比如测试团队整理了一套接口测试用例生成规范先读接口文档再按边界值、异常值、正常值三类设计用例最后输出到指定格式的表格里。这些方法论完全可以用文字描述清楚但同样的问题——每次都要重新给 AI 讲一遍讲得清不清楚还取决于提问者的表达能力。Agent Skills 的核心价值就是把这类“可复用的做事方法”固化成文件让 AI 在合适的场景下自动加载。你不需要再手把手教它它会根据任务内容主动判断“这时候应该用前端开发那套规范了”。所以这篇文章真正想解决的问题有三个第一帮你看懂 Agent Skills 的技术本质它不是一个新框架也不是一个复杂协议它就是一组按约定组织的 Markdown、模板和脚本文件。第二帮你学会自己创建 Skill。不需要会写复杂的服务端代码纯 Markdown 就能写一个能用且好用的 Skill。第三帮你正确评估适用场景。Agent Skills 在代码生成、测试设计、知识密集任务上非常强但它并不适合做实时数据查询、身份认证、跨系统操作这些是 MCP 的领域。看清边界才能在真实项目里选对工具。2. Agent Skills 的核心概念与适用场景2.1 什么是 Agent Skills从 Anthropic 官方定义来看Agent Skills 是 Claude 的可扩展能力模块。它允许你把特定领域的工作流程、编码规范、命令用法、输出模板打包成一个“技能包”Claude 在回答相关问题时能够自动调用这些技能。从实现上看一个 Skill 其实就是一个目录目录里必须包含一个SKILL.md文件。这个文件用 Markdown 编写里面包含两部分YAML 格式的 frontmatter定义技能的name和description。Markdown 正文描述这个技能的使用方法、规则和流程。除了SKILL.md目录里还可以放辅助文件比如模板文件、示例代码、Python 脚本、Shell 脚本等。2.2 Skills 的加载机制这是很多人第一次接触 Skills 时最容易困惑的地方它到底是怎么被 Claude 发现的答案是靠description匹配。当你向 Claude 提出一个任务时Claude Code 会读取所有已安装技能的name和description然后根据当前任务内容判断是否需要加载某一个或某几个技能。一旦匹配成功SKILL.md的内容就会被注入到上下文里Claude 就相当于拿到了一份“操作手册”后续回答就会按照手册里的规则来。这个机制有一个重要含义description写得好不好直接决定了 Skill 会不会被触发。如果 description 写得太泛Claude 可能在该用的时候不加载如果写得太窄又可能在错误的时候加载。这部分后面我会专门讲。2.3 适用场景从适用性来看Agent Skills 适合以下五类场景第一编码规范和代码生成。把团队的前端规范、后端分层规范、命名规范写进 Skill。Claude 生成代码时自动遵守不需要每次重新解释。第二测试设计。把测试用例设计方法、字段覆盖策略、输出格式固化成 Skill。测试工程师只需要描述需求Claude 就能按既有方法论产出完整用例。第三文档撰写和格式转换。例如把技术方案、周报、接口文档的模板做成 Skill统一团队的输出格式。第四领域知识辅助。一些需要长期积累的专业知识比如数据库索引优化经验、SQL 排查套路、常见框架升级步骤都可以沉淀成 Skill。第五CLI 工作流封装。某些项目需要按固定顺序执行一组命令用自然语言描述不如直接让 Skill 引用一个脚本由 Claude 解释并执行。2.4 不合适的使用场景有两类场景不建议用 Skills一类是实时数据获取。Skill 本质是“静态知识包”它不负责连接外部系统。如果你需要查询数据库里的最新订单数据或者调用第三方 API 获取天气信息应该用 MCP 而不是 Skill。另一类是涉及身份认证和敏感操作的场景。Skill 不处理凭证、密钥、用户身份它只是一个指令集合。需要用户授权、鉴权、数据写入的操作应该放到 MCP Server 或者业务系统里处理。一句话总结Skill 管“怎么做得更好”MCP 管“能做什么事”。3. Skills 与 MCP 的对比这一节把 Skills 和 MCP 放在一起对比帮助你在架构选型时快速判断。对比维度MCPAgent Skills解决的核心问题让 AI 连接外部数据和工具让 AI 按固定方法完成任务实现方式需要开发并运行一个 Server通过协议通信一组 Markdown、模板和脚本文件开发门槛中等偏高需要写服务端代码较低会写 Markdown 就能开始触发机制用户或 Agent 显式调用某个 tool根据任务语义自动匹配并加载典型场景查询数据库、调用 REST API、操作浏览器代码规范、测试设计、文档模板、工作流维护成本需要维护 Server 的稳定性、鉴权、日志只需要维护文档和脚本与外部系统的关系直接连接不直接连接只提供指令这里要特别说明一个容易混淆的点。很多人看了表格之后会想既然 Skills 也能包含 Shell 脚本那它是不是也能执行命令严格说Skill 里的脚本是“被 Claude 读取和理解”的执行动作仍然发生在 Claude Code 的运行环境里。也就是说Skill 只是提供了脚本内容真正执行动作的是 Claude Code 本身。它没有把“执行任意代码”变成一个安全可控的外部服务接口。所以把 Skills 理解成“给 AI 阅读的方法论手册”比“给 AI 装上的外部插件”更准确。4. Agent Skills 的实际效果与生态现状从社区反馈看Agent Skills 发布之后热度上升得很快尤其是在前端开发、测试生成、PPT 设计、学术写作等领域出现了不少高星 Skills 仓库。社区里流行的 Skills 大致分几类前端开发 Skills包含 React 组件规范、Tailwind 类名约定、组件生成模板。PPT 生成 Skills封装了排版风格、结构大纲、颜色搭配规则让 Claude 输出更统一的演示文稿方案。测试应用 Skills封装测试用例设计方法论常用于接口测试、自动化测试脚本生成。学术研究 Skills封装了文献检索思路、论文结构、引用格式规范。通用效率 Skills比如代码审查清单、SQL 优化检查项、Git 提交信息规范。从这些方向能看出一个趋势Skills 正在把“AI 的使用经验”变成一种可分发、可安装的知识资产。以前一个人的高效用法只能留在他的对话记录里现在可以打包成一个文件夹发给团队所有人。但目前也有明显的成熟度问题首先Skills 的安装和分发还处于早期阶段虽然有 marketplace 形式但生态尚未像 npm 那样形成统一标准质量参差不齐。其次很多 Skills 只是把文档换了个目录结构并没有真正提炼出可执行的方法论效果自然会打折扣。所以与其盲目下载一堆 Skills不如先学会判断一个 Skill 的质量再学会自己写一个。下面进入实操环节。5. 环境准备与前置条件5.1 使用 Skills 的前置环境要运行 Agent Skills需要满足以下条件安装并配置好 Claude Code 环境。Claude Code 版本需要支持 Skills 功能。确保你的网络环境可以正常访问 Claude 服务。系统方面macOS、Linux、Windows通过 WSL 或 Git Bash都可以。注意具体版本号更新很快本文不写死版本。以官方文档和实际环境为准。5.2 Skill 存放位置官方推荐把个人 Skills 存放在~/.claude/skills/每个 Skill 是一个独立的子目录目录名就是 Skill 的名称。例如~/.claude/skills/ ├── frontend-dev/ │ ├── SKILL.md │ └── ... ├── api-testing/ │ ├── SKILL.md │ └── ... └── code-review/ ├── SKILL.md └── ...如果你的技能是跟某个具体项目绑定的也可以放在项目目录下的.claude/skills/里实现项目级隔离。这跟在项目根目录放.env有点类似——全局 Skills 服务所有项目项目级 Skills 只服务当前仓库。另外Claude Code 还支持从市场上安装社区仓库的 Skills。官方仓库地址是anthropics/skills里面包含一些官方示例可以作为学习参考。6. 从 Marketplace 安装现成 Skills6.1 安装官方示例仓库如果你想先看看社区里有哪些现成的 Skills可以在 Claude Code 中执行以下命令claude install skill anthropics/skills这个命令会把anthropics/skills仓库里的 Skills 安装到你的本地环境中。如果你只想安装一个特定的 Skill比如某个前端开发 Skill可以这样claude install skill your-name/your-skill-repo6.2 通过 npm 生态安装社区 Skills由于 Claude Code 支持 npm 生态很多开发者把自己的 Skills 发布成了 npm 包。这类 Skills 的安装方式一般是claude install package some-org/some-skill这里需要强调一点不是所有的 npm 包都值得信任。在安装任何第三方 Skills 之前建议先打开仓库看看SKILL.md内容确认它不会诱导 AI 执行危险操作。尤其是那些包含 Shell 脚本的 Skills一定要想清楚它会被用在什么场景下。6.3 安装后如何确认生效安装完成后可以输入以下命令查看当前已安装的 Skillsclaude skills list如果输出里能看到刚才安装的 Skill 名称说明安装成功。7. 创建你的第一个自定义 Skill前端开发规范从零开始写一个 Skill 是理解它的最好方式。下面我以一个前端开发 Skill 为例带你完整走一遍。7.1 确定 Skill 的目标和目录结构假设我们要做一个frontend-devSkill它包含三块能力React 组件生成规范Tailwind CSS 使用约定代码审查检查清单在~/.claude/skills/下创建目录mkdir -p ~/.claude/skills/frontend-dev/{rules,templates,scripts}目录结构如下~/.claude/skills/frontend-dev/ ├── SKILL.md ├── rules/ │ ├── react-components.md │ └── tailwind-usage.md ├── templates/ │ └── component.tsx.tpl └── scripts/ └── check-styles.sh这里的设计原则是SKILL.md 不要写得过长只写核心的触发条件和执行流程细节规则放到子文件里Claude 需要时再去读取。7.2 编写 SKILL.md文件路径~/.claude/skills/frontend-dev/SKILL.md--- name: frontend-dev description: 当用户需要创建、修改或审查前端 React 组件时使用。包括组件结构设计、Tailwind CSS 类名规范、代码审查清单。 --- # 前端开发技能 本技能用于确保 React 前端代码符合团队规范。 ## 使用流程 1. 先阅读 rules/react-components.md理解组件结构要求。 2. 如果涉及样式阅读 rules/tailwind-usage.md。 3. 生成组件时优先使用 templates/component.tsx.tpl 作为基础模板。 4. 完成后使用 scripts/check-styles.sh 检查类名命名是否合规。 ## 关键规范 - 组件使用 TypeScript 编写。 - 样式优先使用 Tailwind CSS不使用 CSS Modules。 - 组件命名使用 PascalCase。 - 禁止在组件内直接写内联样式。你发现没有这份SKILL.md本身没有包含全部细节它更像是一份“导读”。Claude 在加载这个 Skill 后会根据导读内容继续读取子文件。这样设计的好处是主文件清晰后续扩展时也不需要频繁改动主题。7.3 编写规则子文件文件路径~/.claude/skills/frontend-dev/rules/react-components.md# React 组件规范 ## 组件结构 每个组件文件必须遵循以下顺序 1. imports 2. 类型定义 3. 辅助函数 4. 组件主体 5. export ## 命名规范 - 组件名称使用 PascalCase。 - 事件处理函数使用 handle 前缀例如 handleClick。 - 布尔 props 命名使用 is、has、can 前缀。 ## Props 设计 - 优先使用 interface 而不是 type 定义 Props。 - 每个 prop 必须明确类型。 - 可选 prop 使用 ? 标记。文件路径~/.claude/skills/frontend-dev/rules/tailwind-usage.md# Tailwind CSS 使用约定 ## 类名优先级 工具类 组件类 页面类。 ## 常用模式 - 间距使用 p-、m-、gap- 体系不写自定义间距。 - 颜色从项目主题色板中选择不硬编码颜色值。 - 响应式使用 sm:、md:、lg: 前缀。 - 布局优先用 Flex 和 Grid不手动计算宽高。 ## 禁止事项 - 禁止在 JSX 中写 style{{}}。 - 禁止拼接动态类名时使用模板字符串生成未知类名。7.4 编写模板文件文件路径~/.claude/skills/frontend-dev/templates/component.tsx.tplimport React from react; interface ComponentNameProps { /** 标题文本 */ title: string; /** 是否显示边框 */ hasBorder?: boolean; /** 点击事件 */ onClose?: () void; } export function ComponentName({ title, hasBorder false, onClose, }: ComponentNameProps) { return ( div className{${hasBorder ? border border-gray-200 : } rounded-lg p-4} h2 classNametext-lg font-semibold text-gray-900{title}/h2 {onClose ? ( button typebutton onClick{onClose} classNamemt-2 rounded bg-blue-500 px-3 py-1 text-white 关闭 /button ) : null} /div ); } export default ComponentName;注意这个文件是模板不是直接可编译的组件文件。Claude 在生成具体组件时会基于这个模板做变量替换和逻辑补充。7.5 编写检查脚本文件路径~/.claude/skills/frontend-dev/scripts/check-styles.sh#!/bin/bash # 检查前端代码中是否包含禁止的 style 内联样式 echo 开始检查内联样式使用情况... grep -rn style{{ src/ 2/dev/null || echo 未发现内联样式 echo 检查完成在实际 Skill 中脚本不需要完美Claude 会理解脚本意图并在合适的时候执行它。不过要提醒一句如果脚本里有破坏性命令比如删除文件、重置数据库一定要在执行前明确提示并在 Skill 文档里写清楚风险。7.6 让 Claude 加载并使用这个 Skill完成以上文件后重新启动 Claude Code。然后输入一个实际任务帮我创建一个用户登录表单组件包含用户名、密码输入框和提交按钮使用 Tailwind CSS 设计样式。如果一切正常Claude 会识别出这个任务属于frontend-dev技能范围自动加载SKILL.md然后按照规范和模板生成组件。8. 运行结果与效果验证要确认 Skill 是否真的生效可以通过以下步骤验证。8.1 验证 Skill 是否被识别在 Claude Code 里输入claude skills list预期输出里能看到frontend-dev。如果你使用的是支持 GUI 的方式也可以直接查看版本信息或配置页面确认。8.2 验证 Skill 是否被加载这里有一个实用的技巧在对话中主动询问 Claude 当前使用了哪个 Skill。你可以这样问你现在是否加载了前端开发技能如果加载了请说出其中一条组件规范。如果 Claude 能准确说出“组件使用 TypeScript 编写”“组件命名使用 PascalCase”这类只有 SKILL.md 里才有的内容说明加载成功。8.3 验证输出质量是否提升拿同一个组件需求分别在有 Skill 和没有 Skill 的环境下让 Claude 生成两次然后对比组件命名是否符合 PascalCase。样式是否采用了 Tailwind 类名而不是内联样式。Props 是否使用了 interface 定义。是否遵循了模板中的组件结构顺序。如果以上维度都有明显改善说明你的 Skill 设计是有效的。8.4 如果没生效第一步查哪里优先检查三处第一SKILL.md的description是否写得够具体。描述过于宽泛时Claude 可能不会在需要时加载它。第二文件路径是否正确。Skill 必须放在~/.claude/skills/或项目级.claude/skills/下。第三当前会话是否已经重启。修改 Skill 文件后需要新开会话或重启才能生效。9. 常见问题与排查思路问题现象可能原因排查方式解决方案Skill 从未被自动加载description 写得太泛语义匹配不到查看当前 Skills 的 description对比任务描述重写 description明确触发场景关键词Skill 被错误加载description 写得太宽覆盖了不相关任务观察日志中加载了哪些 Skill缩小 description 范围增加排除条件修改 SKILL.md 后不生效会话未重启检查 Claude Code 会话状态新开会话或执行重启命令命令claude skills list找不到 Skill目录路径错误确认目录名和路径拼写将 Skill 移动到标准目录生成的代码不遵守规范规则文件内容可操作性差查看规则文件是否过于抽象把规则改成可检查的清单例如“禁止 xxx”Skill 里的脚本无法执行缺少执行权限查看文件权限执行chmod x script.sh第三方 Skill 质量差仓库维护不活跃查看仓库更新时间、Issue 区挑选热门、活跃维护的仓库或自己改写10. 最佳实践与工程建议10.1 description 是第一优先级Skill 的description决定了它是否会被加载。在写 description 时建议包含触发场景的动作词和领域词。反例description: 提供前端开发相关的帮助。正例description: 当用户需要创建、修改或审查 React 组件时使用。包括组件结构设计、Tailwind CSS 类名规范、代码审查清单。正例里包含了“创建、修改、审查”这些动作词也包含了“React、Tailwind CSS”这些领域词匹配成功率会高很多。10.2 SKILL.md 保持精简细节放子文件很多人第一次写 Skill 时容易把 SKILL.md 写成百科全书。这不是好习惯。SKILL.md 的理想长度是 30 到 60 行左右只包含技能名称、触发条件、执行主流程、关键规则摘要。细节规则、模板、示例代码应该拆分成子文件。这样做的好处有两个一是 Claude 加载更高效不会被大段文本冲淡注意力。 二是你维护起来更轻松改一个模板文件不需要改动主逻辑。10.3 把规则写成“可检查项”“保持代码整洁”不是好规则“禁止在 JSX 中写 style{{}}”才是好规则。好的规则应该是可以逐条检查的。如果你写的规则 Claude 看完之后无法判断“是否符合”那这条规则就是无效的。10.4 为 Skill 建立版本管理Skills 本身就是文件天然适合放进 Git。建议为你的 Skills 单独建一个仓库用于备份和同步到不同机器。团队成员共用同一套规范。追踪规则变更历史。一个可参考的仓库结构是my-skills/ ├── README.md ├── frontend-dev/ │ └── SKILL.md └── api-testing/ └── SKILL.md10.5 安全边界这是最容易被忽略的一点。Skill 里如果包含脚本要特别注意脚本的安全边界。删除文件、修改权限、运行 curl 并执行返回内容、连接数据库等操作都需要在 SKILL.md 中明确说明并提醒用户确认。同时不要把 API 密钥、数据库密码等敏感信息写进 Skill 文件。Skill 是给 AI 读取的指令一旦仓库公开敏感信息就会泄露。10.6 关注生态更新目前 Skills 生态还在快速迭代。官方的anthropics/skills仓库、社区讨论、Claude Code 的更新日志都是值得跟踪的渠道。我的建议是不要囤积大量 Skills而是先从团队最痛的两到三个场景切入做出真正能稳定复用的 Skill再逐步扩张。11. 总结与后续学习方向Agent Skills 真正改变的是 AI 使用的“经验层”。过去AI 的使用经验存在于少数人的提示词里靠复制粘贴传播既不稳定也没有标准结构。现在Skills 给了这种经验一个文件结构name、description、SKILL.md、辅助文件。它意味着你完全可以把一个优秀工程师的代码审查方法、一个测试专家的用例设计思路、一个前端团队的项目规范打包成一份可安装、可复用的资源。从工程实践的角度我的建议是第一先去安装一个社区里热门的 Skill 体验完整流程感受“自动加载”和“手动贴提示词”的差别。第二从自己最熟悉的场景开始写一个最简单的 Skill只包含一个SKILL.md文件不要一开始就追求复杂。第三跑通之后再把规则、模板、脚本逐步拆分形成一套有结构的 Skill 包。如果你想继续深入以下几个方向值得关注如何编写多文件复杂 Skill比如一个包含代码生成、测试、重构三种能力的完整开发 Skill。Skill 与 MCP 的混合架构什么时候由 Skill 提供方法论什么时候由 MCP 提供数据工具。团队级 Skill 仓库的治理和分发如何保证团队所有人使用同一个版本的规范。Skill 质量评估如何用一套标准衡量一个 Skill 是高质量的还是只是文档搬家。Agent Skills 的生态刚刚开始现在入局并不晚。真正的价值不在于收藏多少 Skill而在于你能不能把一个高频场景打磨到“每次 AI 都按最佳实践执行”的程度。这才是 Skills 对研发团队真正的意义。