Skill 创作· 教程
如何创建你的第一个 Agent Skill
一步步带你设计一个聚焦的 Agent Skill：写 SKILL.md、配置触发条件，并验证它会不会被正确调用。
入门阅读约 8 分钟更新于 2026年5月4日
一句话回答
做一份好 Skill 的步骤：选一个边界清晰的可重复任务、写一段简洁明确的 SKILL.md 描述、只引入工作流真正需要的脚本或参考，再用真实 prompt 验证它是否在该触发的时候被触发。
从一个具体任务出发
做 Skill 最容易出问题的方式，就是从一个宽泛的分类开始。换个思路——先锁定一件事：评审账单相关 PR、QA 结账流程、更新 release notes、调查不稳定的测试。
- 好：当一个分支上线前需要浏览器 QA 时使用本 Skill。
- 好：当 changelog 与 README 必须跟随代码 diff 同步更新时使用本 Skill。
- 弱：用本 Skill 让代码写得更好。
- 弱：用户求助时随便用本 Skill。
写一份最小可用的 SKILL.md
description 字段就是触发面。它需要说明：什么场景下用、产出什么、边界在哪里。
---
name: release-notes-helper
description: Use when a merged branch or release needs concise release notes, user impact, risk notes, and follow-up checks. Do not use for deep code review.
---
Follow these steps:
1. Inspect the commit range or PR list.
2. Group changes by user-visible impact.
3. Identify operational risks and rollout notes.
4. Draft release notes in plain language.
5. List any claims that still need human verification.资源只在真正用得上时再加
| 资源 | 什么时候加 | 什么时候不加 |
|---|---|---|
| scripts/ | 某项检查必须每次以同样方式执行。 | 工作流主要靠判断而非脚本。 |
| references/ | Skill 需要长示例或策略说明。 | 一份简短清单就够用。 |
| assets/ | 工作流会用到模板或起始文件。 | 素材只是装饰性内容。 |
| agents/openai.yaml | 需要声明 UI 元数据或依赖。 | 本地创作已经够用。 |
验证触发
- 写三条应该触发该 Skill 的 prompt。
- 写三条不应该触发该 Skill 的 prompt。
- 持续打磨描述，直到边界对模型来说一目了然。
- 在用于生产工作前，先在临时仓库或临时分支上跑一遍。
好 Skill 是「无聊」的
它应该被稳定触发、产出形态稳定的输出，并把自己的假设说清楚。