用途：本资料是一份技能设计指南，主题是让 AI 技能在正确时机被激活——既不过度触发（噪声），也不从不触发（沉默）。适用于调试不触发的技能、两个技能争抢同一触发词、技能在无关查询上误触发，以及设计包含多个相关技能的新技能套件。
激活信号层级：模型用四类信号匹配用户查询——名称（弱信号）、描述首句（强信号，说明“做什么”）、“Use this skill when”行（最强信号，说明“何时用”）、“Activate when”关键词列表（对查询短语做模式匹配）。应把主要精力投入后两者。
四种激活模式：1）错误驱动，用户粘贴或描述报错时触发，需包含错误中出现的字面 token；2）意图驱动，用户表达目标时触发，匹配祈使动词与目标短语；3）工具/技术驱动，用户提到具体工具时触发，点名技术及其关键概念；4）工作流驱动，在已知工作阶段触发，必须清晰限定该阶段，否则会频繁触发。
重叠技能消歧：若两个技能都可能对同一查询触发，应在描述中区分，并加入“NOT for...”路由提示。过度激活的成因是描述过宽，修复方式是收窄 WHEN；激活不足的成因是描述缺少用户词汇，修复方式是审计真实查询并补充其确切说法，混合术语、错误字符串与自然表述。负向触发用于明确不该激活的场景，减少与邻近技能的竞争。
测试激活：列出 10 条以上应激活的真实查询与 10 条以上不应激活的查询，对技能加载器运行并测量精确率与召回率，迭代描述直至两者都高。
常见失败模式：使用 help、handle、manage 等泛化动词；遗漏错误字符串；技能名撞上常见词；相关技能描述重复；缺少 WHEN 子句。最佳实践：以真实用户查询为参照写描述，关键词兼顾术语与自然表述，为每个相关技能加“NOT for X”守卫，用查询套件测试并迭代。资料未提供具体安装命令或平台信息。