<skill-name-kebab-case>

<一句话说清『这个 skill 做什么 + 何时调用』。把最关键的触发场景放最前面。结尾给 2-3 个用户会说的关键词。>

SKILL.md

GitHub

<Skill Display Name>

单行用途描述。

何时使用

  • 触发场景 1
  • 触发场景 2
  • 不适用于:<明确的反向边界>

工作流程

  1. <步骤 1>
  2. <步骤 2>
  3. <步骤 3>

输入

参数 类型 说明
arg1 string …

输出

<期望输出格式,markdown / json / 文件>

引用资源

  • references/<file>.md:<说明>
  • scripts/<file>.sh:<说明>
  • examples/<file>:<说明>

错误处理

场景 处理
输入缺字段 escalate-user,不要猜测
工具失败 重试 ≤ N 次,仍失败则记录到 .handoff/

检查清单

  • 描述里有 3+ 触发关键词
  • 主体 ≤ 2000 词;超出移到 references/
  • 输出格式可被下游 skill / agent 直接消费
  • 边界明确("不"适用于 X)