编写并检查一个 Agent Skill

目标

创建一个范围明确、可被目标Agent发现的技能目录。

步骤

1. 先查看目标Agent的技能根目录和加载约定，确认本次只为哪个Agent编写。 [agentskills-home]
2. 为技能选择短且唯一的目录名，在其中创建 SKILL.md。 [agentskills-spec]
3. 按规范加入 YAML frontmatter 的 name 与 description，正文写触发场景、边界及需要的步骤。 [agentskills-spec]
4. 检查frontmatter名称与目录名一致，确保描述清楚指出适用任务，避免空泛触发。 [agentskills-spec]
5. 将样例请求与不适用请求各跑一遍发现流程，确认它会在合适场景出现。 [agentskills-spec]
6. 审阅技能内的命令、外部访问和文件权限；未经单独批准不要执行附带脚本。 [agentskills-spec]

验证方式

用目标Agent列出或触发已安装技能，并确认只有匹配场景会调用；记录所测产品版本。

故障处理

若未发现，先核对根目录、frontmatter缩进和产品是否支持开放格式；不要通过复制多个同名目录掩盖问题。