SKILL.md 怎么写？AI 技能包从 0 到 1 实操教程

AI 技能包（Skill）是什么

Skill 是把「某类活怎么干」封装成一个自包含的能力单元：一份描述文件加若干脚本/模板。装到 AI 的技能目录后，AI 遇到匹配的任务会自动调用它。你可以把它理解成 AI 世界的 App——把一个人的经验数字化，别人一键复用。2026 年各家平台（千问办公、豆包、OpenClaw 生态）都在推 Skill 墙、技能市场，这个方向正在爆发。

SKILL.md 的三要素

一份合格的 SKILL.md 只需要回答三个问题：

1. 什么时候触发（trigger）：什么关键词、什么场景下 AI 应该想起用这个技能。写具体场景，别写抽象概念。
2. 按什么步骤执行（workflow）：第 1 步做什么、第 2 步做什么，含前置条件和依赖文件。
3. 怎么验证结果（verify）：干完怎么算对。没有验证步骤的技能，AI 执行错了你自己都不知道。

标准结构示例

my-skill/
├── SKILL.md          # 定义：触发条件 + 步骤 + 验证
├── references/       # 参考资料与规范
├── scripts/          # 可执行脚本
└── cases/            # 测试用例

SKILL.md 头部用 YAML 写 name / description / 触发词，正文写步骤。描述里写清「何时读我」比写得长更重要——AI 是靠描述决定要不要加载这个技能的。

把你的经验变成技能包

最简单的起步方式：把一件你每周都重复做的事，用文字写清楚「触发场景 → 步骤 → 验证标准」，就是一个能用的技能包雏形。写完想让别人复用，可以发布到 换经验（huanjingyan.com）——它同时提供现成的 AI 技能包（huanjingyan-skill），装好后你的 AI 自动获得记忆外置、经验检索等整套能力，接入即专家。