用途:在创建或修订可复用 agent skill 之前阅读。它规定技能包的写作方式与结构,不提供具体技能内容。
主要能力与要求:
- 修订时先读现有 SKILL.md 及其直接加载的全部文件,再改结构或删除内容。
- 起草前检查可用技能,阅读在领域、产物或写作模式上实质适用的技能。
- 先定包范围。全局技能须跨工作区适用,可专精,但不能假定某仓库的路径、包、命令、版本、provider payload 或内部生命周期;项目机制留在项目范围技能。项目技能可只作增量补充,需另起名称,并提示 agent 发现并加载适用的通用技能。与全局技能同名会将其遮蔽,仅用于有意的完整替换。命名前查全局目录,不要复制或硬编码全局包。
- 基于两三个真实请求、观察到的失败或用户明确纠正,找出技能必须改变的决策、失败或质量线。
- 描述写成最短可靠调用触发,而非包摘要;面向选择时的阅读 agent,用 Read before…、Use for…、Must always apply 等直接句式,不写技能提供、改进、帮助或包含什么;只加避免最近真实冲突所需的边界;包内容、路由、示例和理由放正文。不堆砌提示同义词或能力清单。引用时目标 175 字符以内,176 至 200 需说明理由,超过 200 为错误。
- 每个技能和参考正文直接从执行开始,不加标题、文件名标题、用途、激活或其他重复触发或路由的前言。
- SKILL.md 保留每次运行都需要的常路与判断,分支细节放精确参考路径;仅当确定性代码比文字更简单可靠时用脚本。
- 需要其他能力时,提示读者发现并加载适用的可用技能,不硬编码其他包名。
- 只在改变决策、防止已知失败、保留用户意图或定义可观察完成时保留一行;删除模型默认、宿主保证、泛泛鼓励、重复检查和可从环境廉价获知的事实。
- 正文语域与执行方式匹配:操作、编码、工具、审查和 SOP 技能用简洁指令、明确条件、精确检查和可观察边界;创意、语气、品味和构思技能在语言直接影响输出时可使用有表现力或主观的语言,但调用触发仍直接简洁。
- 修订时保留已验证的领域判断和有用失败处理,用替换而非追加历史的方式处理过时或冲突指导。
- 演练随附脚本并验证每个引用路径。仅当触发实质变化或观察到选择失败时才复查调用与近冲突请求,不要构建只为证明技能存在的合成套件。
限制:本资料为英文写作规范,未提供具体技能模板、代码示例、安装命令或平台说明。