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

紧接上一篇分享,今天的重点是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工具,它会告诉你的。

相关推荐
锋行天下18 分钟前
langgraph 全栈项目(二)
前端·人工智能·后端
大模型真好玩24 分钟前
用 Seedance 2.5 Flash 实现1分钟AI短剧,满足孩子的超级英雄对战梦
人工智能·aigc·deepseek
FengY_HYY43 分钟前
从人类组织到人类&大模型组织,我的位置在哪里?
人工智能·程序员·llm
Flynn Liang1 小时前
大模型成本优化:基于 Redis 的可验证语义缓存架构
人工智能·redis·缓存·架构·ai agent·智能体
锋行天下1 小时前
langgraph全栈项目(一)
前端·人工智能·后端
ZzT1 小时前
open-code-review 原理解读与 Claude Code 对比实测
ai编程·claude
程序员cxuan1 小时前
不得了,Google 造反了,Opus 5.5 又被干了
人工智能·后端·程序员
IT规划师1 小时前
AI 价值落地的架构决策:从四层技术栈到组织能力的最后一公里
ai编程
数字新视界2 小时前
能耗管理系统提升企业能源效率的实践与展望
大数据·人工智能·数据中心·机房管理·模块化机房
郝学胜-神的一滴2 小时前
Effective Python 条款36:优雅拼装迭代器与生成器
开发语言·数据结构·人工智能·python·numpy·scikit-learn