前言：为什么要学 Agent Skills？

如果你最近关注 AI 编程，一定听过 Claude Code、Cursor、CodeBuddy 这些工具。它们确实很强——但光靠提示词，总感觉不够高效。

比如你让 AI "帮我写一个单元测试"，它可能：
- 不知道你项目的测试框架是什么
- 不理解你的命名规范
- 重复问同样的问题

Agent Skills 就是解决这些问题的钥匙——它能让 AI "记住"你的习惯、理解你的项目、执行你的流程。

一句话概括：Skill 是给 AI Agent 的一份"说明书"，告诉它在特定场景下该怎么干活。

skill的好处是

下面融入特征来讲解,可以找一下他们在哪个位置。

学完你将掌握：Skill 的原理、安装方法、实战使用、自制技巧。

---

一，Skill是什么？（必看，不要求太多计算机知识）

关于skill你只需要知道这些（这是全文的总结，也是AI帮你生成skill，你需要注意的）

1.1固定文件结构（也就是结构化）

首先是Skill名称是这个Skill的文件夹名称，然后是一个必选项（SKILL.md），和两个可选项(script和references)。
当然最新规定的Skill里面还有一个asset，但是在我使用过程中属于一个可有可无的角色，可以在SKILL中写好路径让他自己去找资源。

1.2一个必选项，两个可选项

我们来细看这个Skill。
SKILL.md是Agent的执行流程，也就是我们的提示词的标准形式。

reference是参考的意思，他来管理怎么输出，相当于我们说的“理想态“，里面是一些不同情景下的参考，比如输出参考，遇到问题解决的参考是什么，询问用户的参考是什么…

script是Agent运行的固定脚本，相当于agent的能力，通常是用python写死在里面的。

满足以上结构的就是Skill，平时Vibe coding，需要盯着ai给你写的内容，都是汉语，不对的可以手动修改。

说白了就是提示词+脚本

二、Agent Skills 到底是什么？

2.1 用"菜谱"比喻理解 Skill

想象你请了一个厨师来做菜。他厨艺精湛，但不知道你要吃什么、用什么食材、有什么口味偏好。

这时候你给他一份菜谱：
- 菜名：红烧肉
- 食材：五花肉、酱油、糖...
- 步骤：先焯水、再煸炒、最后焖煮...

Skill 就是给 AI Agent 的"菜谱"。AI 本身能力很强（会写代码、能理解文档），但需要你告诉它：
- 在什么场景下工作
- 按什么步骤执行
- 遵守什么规范

有了 Skill，AI 就像有了"工作手册"，不再每次都从零开始猜你的意图。

2.2 Skill 与 MCP、Prompt 的区别

很多新手会混淆这三个概念，我用表格帮你理清：

概念	作用	示例
Prompt	单次对话指令	“帮我写一个冒泡排序”
Skill	持久化的工作流程	一份"代码审查 Skill"，每次审查都按固定步骤
MCP	连接外部工具/数据	让 AI 能访问数据库、调用 API

简单理解：

• Prompt = 临时指令，说完就忘
• Skill = 持久方案，一直生效
• MCP = 工具桥梁，拓展能力边界

它们可以组合使用：比如一个 Skill 里调用 MCP 提供的工具。

2.3 Skill 的核心结构：SKILL.md 文件

Skill 的核心是一个叫 SKILL.md 的文件。打开任何一个 Skill，你都会看到类似这样的结构：

---
name: my-skill
description: 这个 Skill 做什么
---

# Skill 正文

你是一名专业的...助手。

## 工作流程
1. 第一步：...
2. 第二步：...

## 注意事项
- 要点1
- 要点2

关键组成部分：

1. Frontmatter（头部元数据）
   • name：Skill 的名称，调用时使用
   • description：一句话描述，部分 Agent 会根据 description 自动判断何时触发

！！！！！有个特点就是agent一开始只会读取你的元数据

2. 正文内容
   • 角色定义：告诉 AI “你是谁”
   • 工作流程：清晰的步骤指引
   • 注意事项/规则：必须遵守的约束

！！！agent在认为元数据该触发时才会看到这个内容，好处就是按需加载，减少token消耗。

3. 可选的辅助文件
   • references/：参考资料、模板
   • scripts/：配套脚本

---

三、快速上手：安装你的第一个 Skill

3.1 环境准备

需要一个IDE


等等都可以
在开始之前，确保你有以下工具：

工具	作用	安装方式
Node.js	Skills CLI 运行环境	nodejs.org 下载安装
Git	从 GitHub 安装 Skill	git-scm.com 下载安装
CodeBuddy Code / Claude Code	运行 Skill 的 Agent	按官网指引安装

验证环境：

node --version   # 应显示 v18+ 或更高
git --version    # 应显示 git version 2.x

3.2 两种安装Skill方式（体现出可复用，跨平台）

方式一：有些软件可以直接配置Skills（大佬可以用CLI）

直接在软件上搜索（这里用codebuddy举例）

方式二：手动导入

如果你有本地的 Skill 文件夹（比如朋友分享的），可以直接导入：

1. 将 Skill 文件夹放到技能目录：

   • CodeBuddy Code：~/.codebuddy/skills/<skill-name>/
   • Claude Code：~/.claude/skills/<skill-name>/

2. 确保文件夹里有 SKILL.md 文件

3. 重启 Agent 工具

3.3 验证 Skill 是否生效

安装后，用一句话测试：

使用 <skill-name> 帮我...

如果 AI 开始按照 Skill 定义的流程工作，说明安装成功！

---

四、实战演示：用 Skill 解决真实问题（这个技能是我自己创建的，顺便展示一下用法,三连来找主包要）

让我用 csdn-publisher 技能为例，展示完整的使用流程。

4.1 触发 Skill

在 CodeBuddy Code 或 Claude Code 中输入：

使用 csdn-publisher 创建一篇关于 Java 多线程的学习经历文章，内容思路是（写下你的思路）

AI 会识别到这是一个 CSDN 文章创作请求，自动加载 Skill。

4.2 Skill 工作流程

根据 csdn-publisher 的定义，AI 会按以下步骤和你互动：

第一步：询问文章类型

第二步：收集主题和字数要求

请告诉我文章的主题或核心内容
文章字数丰富度：精简版/标准版/深度版/长文版

告诉AI你的想法，生成后便于修改。提高我的效率！现在半个小时就可以沉淀一篇今日所学。

第三步：检测系列文章
如果检测到你已有相关系列，会询问是否续写。

第四步：生成大纲并确认
AI 会生成大纲，必须等你确认后才写正文——这是 Skill 的强制规则。

这个是主包的演示材料，所以大纲给的有些潦草。
第五步：撰写文章
按照大纲和 CSDN 风格规范写作。

第六步：审查报告（特意设置一个审查内容，主包还是太粗心了）
自动审查语言质量、技术准确性、原创性。

第七步：保存文章
保存到指定目录（如 ~/Desktop/CSDN/）。

4.3 常见问题排查

问题	可能原因	解决方法
Skill 没被触发	描述不够明确	明确说"使用 "
安装后找不到	目录放置错误	检查 ~/.codebuddy/skills/
工作流程中断	Skill 文件损坏	重新下载或检查 SKILL.md

---

五、进阶：如何制作自己的 Skill（特别推荐使用秋芝的生成器，我把内容放在结尾，推荐去她的网站下载）

现在你已经会用 Skill 了，是时候制作一个属于自己的技能！

5.1 从一个简单需求出发

假设你经常让 AI 帮你写 Git Commit Message，每次都要说同样的要求。可以制作一个 commit-helper Skill！

5.2 编写 SKILL.md

推荐把秋芝的skill-creator下载下来然后一步一步描述需求。
直接让AI制作，但注意审查格式和内容。
最后人工修改。

5.3 测试与迭代

1. 将文件保存到 ~/.codebuddy/skills/commit-helper/SKILL.md
2. 重启 CodeBuddy Code
3. 在项目中输入：“帮我写个 commit message”
4. 观察 AI 是否按流程执行
5. 根据实际效果修改 Skill 内容

5.4 进阶技巧

技巧一：添加参考资料

commit-helper/
├── SKILL.md
└── references/
    └── commit-templates.md   # 常用模板

在 SKILL.md 中引用：

详细模板见 [references/commit-templates.md](references/commit-templates.md)

技巧二：添加强制规则

## ⚠️ 强制规则
- 必须先运行 git diff，不能直接猜测
- commit message 必须用户确认后才输出

---

六、总结

本文带你从零搞懂了 Agent Skills：

知识点	核心内容
原理	Skill 是 AI Agent 的"工作手册"，告诉它怎么干活
结构	SKILL.md 文件 = frontmatter + 正文 + 可选辅助文件
安装	Skills CLI 或手动导入到技能目录
使用	明确触发 → 按流程执行 → 等待确认 → 输出结果
自制	从需求出发 → 编写 SKILL.md → 测试迭代

下一步建议：

1. 找几个开源 Skill 下载试用
2. 分析它们的结构，理解最佳实践
3. 从简单需求开始自制 Skill
4. 逐步增加复杂度（加入参考资料、脚本）

推荐资源：

• Skills 官网：skills.sh
• ClawHub 技能市场：clawhub.com
• 秋芝2046 Bilibili：搜索"Agent Skills 教程"

---

本文首发于 CSDN，作者：kingwu