跳到主要内容
版本：dev

Skills 总览

本页对 skill 的定义参考了 Agent Skills 的描述：skill 是一种轻量、自包含的能力包，智能体可以按需发现、加载并执行。

什么是 skill？​

在 DB-GPT 中，skill 是一种可复用的能力包，为智能体提供完成某类任务的结构化方式。

相比只依赖自由推理，skill 为特定类型的工作提供了更稳定、更可重复的执行模式。

DB-GPT 技能总览

Skill 的定义​

结合 Agent Skills 的定义，可以把 skill 理解为：

  • 一种为智能体提供专业知识和工作流的轻量扩展格式
  • 一种经验与方法的打包形式，而不只是事实、API 或 prompt
  • 一种渐进式暴露的能力单元：先发现，真正需要时再完整加载
  • 一个自包含的指令、脚本、模板和参考资料集合
  • 一种让智能体行为更稳定、可重复、具备领域感知的方式

在 DB-GPT 语境里，skill 不只是“模型知道什么”，而是一个打包好的工作流，帮助智能体决定：

  • 它要解决什么问题
  • 它应该调用哪些工具
  • 执行步骤应遵循怎样的顺序
  • 需要产出什么结果
  • 需要遵守哪些约束

一个 skill 通常包含什么​

一个 DB-GPT skill 包通常包括：

  • 名称
  • SKILL.md 中的说明与指令
  • 可选脚本
  • 可选模板
  • 可选静态资源或示例

从本质上说，skill 是一个包含 SKILL.md 的目录。这个文件定义元数据与执行指令，告诉智能体如何完成某类任务。skill 还可以附带脚本、模板和参考资料。

my-skill/
├── SKILL.md          # Required: instructions + metadata
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation loaded as needed
└── assets/           # Optional: templates, output resources, static files

Skill 结构​

按照 DB-GPT 当前 skill-creator 的实践，一个 skill 通常组织为一个小型、自包含的能力包：

部分必需作用
SKILL.md是定义 skill 的身份信息与执行指令
scripts/否存放可执行代码，如 Python 或 shell 辅助脚本
references/否存放按需加载进上下文的参考文档
assets/否存放模板、字体、图标、样板文件或其他输出资源

SKILL.md​

SKILL.md 是 skill 的入口文件，通常包含：

  • name、description 等元数据
  • 智能体应遵循的工作流指令
  • 什么时候读取附加参考资料或使用打包资源的说明

scripts/​

scripts/ 用于放置可执行辅助程序，例如：

  • Python 数据处理脚本
  • shell 脚本
  • 报告生成辅助代码
  • skill 运行中需要的自动化代码

references/​

references/ 用于保存不适合一直塞进 SKILL.md 的补充知识，例如：

  • API 文档
  • 业务逻辑说明
  • schema 定义
  • 工作流指南
  • 领域规范或策略文档

这样既能保持 SKILL.md 精简，又能在需要时为智能体提供更深的上下文。

assets/​

assets/ 用于存放更多面向输出而不是推理过程的资源，例如：

  • HTML 模板
  • 图标与 logo
  • 字体
  • 前端样板文件
  • 报告资源

为什么 skill 很重要​

在以下场景中，skill 很有价值：

  • 工作流需要标准化
  • 任务需要领域化推理
  • 报告或分析需要遵循固定模式
  • 希望智能体优先使用整理好的指令，而不是完全临场发挥

Skill 如何工作​

常见执行流程如下：

  1. 智能体识别当前任务适合某个 skill。
  2. 加载该 skill 的指令。
  3. 按照 skill 定义的工作流执行。
  4. 调用所需工具。
  5. 返回最终答案、报告或页面。

Skill 与内置工具​

skill 经常会编排多个内置执行工具一起工作：

  • load_skill → 加载 skill 指令
  • sql_query → 按需获取结构化数据
  • code_interpreter → 计算指标、转换数据、生成图表
  • shell_interpreter → 在需要时执行 shell 命令
  • html_interpreter → 渲染最终报告或网页

实际示例​

财报分析​

一个财报分析 skill 可以定义：

  • 如何检查上传的财报
  • 如何计算指标并进行期间对比
  • 如何生成图表与摘要
  • 如何渲染最终 HTML 报告

CSV / Excel 分析​

一个数据分析 skill 可以定义：

  • 如何检查数据集
  • 如何计算核心指标
  • 如何可视化结果
  • 如何把结果整理成可复用报告

最佳实践​

  • 当工作流需要可重复时，优先使用 skill
  • 严格遵循 skill 中定义的指令
  • 优先使用 skill 指定的工具，而不是临时替代方案
  • 当 skill 产出网页或报告时，优先使用 html_interpreter 做最终渲染

下一步​

想看具体使用方式，请继续阅读 How to Use Skill。