template-skill

name	template-skill
description	新 skill 的起点模板。编写 skill 时以此结构为基准,写完后把本文件复制为你自己的 SKILL.md,再替换 frontmatter 与正文。不要把这个模板本身作为正式 skill 对外发布。 何时用(必写):一句话说明触发场景。何时不用(必写):排除相邻但无关的情形,避免与其它 skill 抢活。

Skill 名称

一句定位:这个 skill 让 agent 具备什么能力、解决哪类任务。

何时使用

• 触发场景 A
• 触发场景 B

何时不使用

• 相邻但应由另一 skill 处理的情形(具名指向,避免倾向性)

工作流

1. 第一步 → 预期产出
2. 第二步 → 预期产出
3. 第三步(可含校验/止损)

边界与质检

• 关键不变量 / 可验证的完成标准
• 失败时的回退路径

附加资源

• references/ 放按需检索的深度文档,正文保持精简,只放高频指令。
• 说明何时该打开哪些 references 文件。

编写约定(发布前删除)

• name:短横线 slug,全局唯一,一旦发布不可变。
• description:给智能体看,写「何时用/何时不用」,不要写给终端用户的营销文案。
• 保持项目无关;具体项目才有的路径/代号不要写死。
• 完整规范见 CONTRIBUTING.md。