Skill 构建指南:AI 智能体扩展包开发
引言
在人工智能时代,如何让智能体具备更强的专业能力和更丰富的工作流程?答案就是 Skill——一种为智能体设计的能力扩展包。本文将详细介绍如何从零开始构建符合规范的 Skill,让你的创意变成可分发的工具。
什么是 Skill?
核心定位
Skill 是被智能体加载和执行的能力扩展包,而非独立运行的应用程序。
执行模式
- Skill 在智能体的会话上下文中被动态加载
- 智能体读取 SKILL.md 的指导,调用 scripts/ 中的脚本,参考 references/ 中的文档
- Skill 的所有交互都通过智能体与用户的对话完成
Skill 提供的能力
- ✅ 专门工作流程(多步骤程序与条件逻辑)
- ✅ 工具集成(文件格式与 API 的使用方式)
- ✅ 领域专家知识(公司或系统特有的架构与逻辑)
- ✅ 打包资源(脚本、参考、资产)
Skill 不是什么
- ❌ 独立应用程序(不需要 main 函数或启动入口)
- ❌ Web 服务(不需要 web server、API endpoint、HTTP 路由)
- ❌ 持久化服务(不需要后台进程、守护线程、常驻内存)
- ❌ 用户界面(不需要 GUI、命令行交互式菜单)
目录结构
Skill 完整路径结构
/workspace/projects/ └── <skill-name>/ # Skill 根目录
├── SKILL.md # 必需:入口与指南
├── scripts/ # 可选:可执行代码
├── references/ # 可选:参考文档
└── assets/ # 可选:静态资源
Skill 固定结构
严格统一使用以下结构,Skill 不允许包含任何额外的文件或文件夹:
| 路径 | 必需性 | 说明 |
|---|---|---|
<skill-name>/SKILL.md | 必需 | 入口与指南,含 YAML 前言区 |
<skill-name>/scripts/ | 可选 | 可执行代码(Python/Bash 等) |
<skill-name>/references/ | 可选 | 长参考与细节文档 |
<skill-name>/assets/ | 可选 | 资源文件(模板/图标等) |
命名规范
- Skill 目录名格式:
<skill-name>(必须使用英文小写字母和连字符拼接,例如:exam-grading、pdf-parser) - 禁止使用
-skill后缀:目录名不应以-skill结尾 - 打包文件名格式:(目录名 + 扩展名)

