Skill怎么写，Skill目录结构和参数详解

写AI Skill容易陷入过度设计的坑，其实最小可用结构非常简单：一个独立文件夹，加上一个SKILL.md文件就能跑起来。不要一开始就堆砌一堆没用的文件。

SKILL.md的灵魂在于头部参数。name必须保持稳定，不要随意改动；description是触发关键，要写清楚“什么时候该用这个Skill”，这直接决定了Agent的意图匹配准确度。

正文部分建议直接写成SOP，依次明确目标、步骤、规则、输出格式和质量检查。这种结构化指令比长篇大论的Prompt更能让模型稳定执行。

随着任务变复杂，再按需引入references/（参考文档）、scripts/（执行脚本）和assets/（素材资源）。这种“渐进式披露”机制能避免一次性加载过多信息撑爆上下文，有效节省Token消耗。

目前这套规范更偏向Claude Code、Spring AI Alibaba等支持Skill机制的Agent框架。如果你的Agent还不支持动态加载技能包，生搬硬套可能效果有限。

怎么用

• 适用开发AI Agent应用、需要规范化技能包的开发者
• 创建入口：新建文件夹并编写SKILL.md即可
• 核心门槛：需要Agent框架支持Skill动态加载机制
• 扩展建议：复杂逻辑再考虑添加scripts和references目录

图片来源：mp.weixin.qq.com