SKILL到底应该怎么写?10 分钟快速掌握 AI 智能体技能开发核心技巧

0 阅读3分钟

紧接上一篇分享,今天的重点是Skill。

你是否有过这样的困扰:

好不容易写了一个 AI Skill,却发现 AI 根本不按你的要求执行?

或者技能写好了,但 AI 从来不调用它?

问题可能出在 SKILL.md 上

今天这篇文章,就分享一些skill的编写知识点,打造你的听话AI助手~

Skill是什么?

Skill你完全可以理解成一个或者几个特定功能的组合,AI可以根据你编写的内容按照你的预期方式执行下去,避免AI自己按照自己的想法随意发挥,最后执行结果不尽如意。

Skill包括什么?

一个标准的skill包含以下几类文件:

  • SKILL.md文件(必备)

    这是我们任何一个skill技能必备的核心文件,没有它也就相当于没有skill。

  • Scripts脚本库(可选)

    这里主要存放一些skill所用到的技能脚本。

  • references资料库(可选)

    这里可以放一些行业规范、资料文档等,比如我们的开发规范指南内容

  • assets资源(可选)

    这里主要是一些脚本用到的资源素材,个人用得比较少

注:其实大多数时候就一个SKILL.md就能满足大部分的场景了,其余的都可以根据自己需求按需编写。

Skill应该怎么写

SKILL.md文件由以下几部分组成:

  • 技能元数据
  • 技能描述
  • 正文指令

技能元数据

技能元数据主要是包括技能的名称、技能版本号、以及维护者信息。

  • 技能名称

必须是英文、无空格、动宾结构的清晰命令,例如:search_web、zip_file等

  • 版本号

这个就是定义一个版本号,便于维护更新。

  • 维护者信息

这个不必须,如果是团队写作,建议还是添加上。

技能描述

技能描述对技能的效果是至关重要的,决定了你的skill是否好用,有效。 其主要内容包括:

  • 功能介绍

一句话简单介绍skill的作用就行。

  • 触发场景

明确告诉AI在遇到什么问题、执行什么指令时应该用这个技能去处理。

  • 禁用场景

明确告诉AI什么时候不能用,避免AI幻想,滥用skill影响预期效果。

正文指令

这个就是执行skill时具体应该按照什么步骤去干活,用Markdown格式编写就行。 当然这里面如果涉及到scripts脚本库的,也是一样描述清楚就行。

示例对比

错误示例

用于查询天气

正确示例

当你需要获取指定城市的实时天气数据时调用此工具。 必须提供城市的标准中文名称(如:重庆市)。 不支持查询历史天气

常见避坑指南

  • 正确命名

    命名不正确,skill脚本将无法生效。

  • 配置路径正确

不同ai工具可能有它自己的skill存放路径,路径不正确,skill脚本也是无法生效的,具体AI对应路径可以直接问ai工具,它会告诉你的。