浏览 AI 知识库

Skill 不触发怎么办:用正例、反例和边界任务测试

Skill 不触发或过度触发,通常要回到描述和边界测试。用应该触发、不该触发和容易混淆的任务各跑一遍,比反复重装更能找到问题。

先认准故障

从完全不触发到什么都触发,只差了一句过宽的描述

Skill 文件存在,但明确请求“整理访谈”时不触发;改完描述后,任何“整理”任务又都会触发。问题在触发边界,而不是反复重装。

  • 固定正反例覆盖真实任务
  • 每轮只改一个触发因素
  • 误触发与漏触发均记录
按现象分支

Skill 不触发,先从“明确正例不触发”这一类现象查起

明确正例不触发

原因
description 没包含用户常用动作、对象或文件类型,或 Skill 未被当前作用域发现。
怎么改
先确认客户端能发现文件,再用用户原话改说明,不堆同义关键词。

相邻任务也触发

原因
说明只写了宽泛领域,没有排除条件和任务边界。
怎么改
加入具体交付、必要输入和不适用场景,用反例回归。

触发后流程跑偏

原因
触发正确,但 SKILL.md 的输入、步骤、停止和验收不完整。
怎么改
把问题归到工作流而非触发,补缺材料行为和输出契约。

只在作者环境触发

原因
作用域、路径、版本或依赖与测试环境不同。
怎么改
记录客户端版本与安装位置,在干净环境重复发现和触发测试。
本例材料

复测前,固定原始现象、环境和目标

需要确认本例内容
现有材料正例 3 个、反例 3 个、边界例 2 个;目标 Skill 只处理带录音/转写的访谈总结。
不能越过的边界一次只修改名称、描述或触发条件的一处;固定测试集;记录实际触发与期望,不靠印象。
要交付的结果触发测试表与修订结论
固定回归集

以‘打包微信公众号草稿’为例,同时测试该触发和不该触发

测试原话期望实际问题修改方向
把这篇中文文章排版后保存到公众号草稿箱触发旧说明只写 WeChat,中文原话未触发加入草稿、标题、摘要、正文和封面等真实任务
只帮我润色这段中文,不要打开浏览器不触发旧说明因‘中文文章’误触发明确纯改写且不操作公众号时不适用
把现有草稿的封面替换后保存,不发布触发能触发但流程误建新文章在步骤中区分新建与更新
直接群发这篇文章触发后停止旧流程继续到不可逆动作写明只能保存草稿,发布需另行明确授权
没有登录账号,先帮我准备正文不调用浏览器操作旧流程在登录页反复尝试缺前置时交付本地内容并说明阻塞
只改一个因素

说明要描述交付和边界,不堆同义关键词

Before

过宽且缺少停止条件

用于微信公众号、中文文章、内容创作、排版、发布、图片等相关任务。

After

触发对象和非适用场景可测试

当用户要求在已登录的微信公众号后台新建或更新文章草稿,并处理标题、摘要、正文、封面或保存验证时使用。纯文字润色、只生成图片、未授权的发布或群发不适用;缺少登录状态时停止浏览器操作。

示例说明用于展示边界写法,不替代具体 Skill 的完整 SKILL.md 和安全规则。

修复前后

Skill 不触发:按原条件复测的结果

Before

原始现象

正例命中 1/3,反例误触发 2/3;“整理文件夹”也调用了访谈 Skill。

After

触发测试表与修订结论

描述加入输入要求“访谈录音或转写”和输出“主题—证据—待确认”,删除泛词“整理任何内容”。复测正例 3/3、反例 0/3、边界例按预期询问材料。

验收方式

触发测试表与修订结论通过哪些检查才算完成

进一步核对

选择与使用:参考资料与核对入口