SKILL.md 触发机制与设计规范：避免“写了不触发”

文章目录

• [SKILL.md 触发机制与设计规范：避免"写了不触发"](#SKILL.md 触发机制与设计规范：避免“写了不触发”)
• • [0. 先看结论（1分钟）](#0. 先看结论（1分钟）)
  • [1. 为什么会"写了不触发"](#1. 为什么会“写了不触发”)
  • [2. 可触发 SKILL.md 最小骨架](#2. 可触发 SKILL.md 最小骨架)
  • [3. 触发机制设计（信号词+约束词）](#3. 触发机制设计（信号词+约束词）)
  • [4. 案例块：摄影点评 Skill](#4. 案例块：摄影点评 Skill)
  • [5. 排查清单](#5. 排查清单)
  • [6. CTA](#6. CTA)

SKILL.md 触发机制与设计规范：避免"写了不触发"

专栏：Agent Skills 商业化实战专栏

目标：让 Skill 从"偶尔命中"变成"稳定触发、可复用、可交付"。

0. 先看结论（1分钟）

• 触发条件具体
• 边界清晰可判定
• 输出结构可验收

否
是
用户请求
模型判断
匹配Skill?
通用回答
触发Skill
结构化输出

1. 为什么会"写了不触发"

• 触发描述太泛
• 没写排除条件
• 输入输出不标准

2. 可触发 SKILL.md 最小骨架

name: weekly-report-skill
description: 当用户要求周报/月报/复盘且提供数据来源时触发。

何时使用：任务词+输入约束
何时不要使用：纯问答/无数据/一句话总结
输入要求：时间范围+数据源+目标读者
输出格式：结论/数据/风险/行动项

3. 触发机制设计（信号词+约束词）

否
是
否
是
任务词命中
有时间范围?
补问
有数据源?
补问
执行Skill

4. 案例块：摄影点评 Skill

• 触发：用户上传照片 + 请求点评
• 输出：总评/优点/问题/下次建议

5. 排查清单

• 触发词可枚举
• 排除条件完整
• 最小输入明确
• 失败兜底存在

6. CTA

下一篇将提供：可复用模板 + 命中率优化实验表 + 验收清单。