展开知识库目录
Skill 没有触发怎么办：用小任务做正例、反例和边界测试
文件存在但不触发，通常是名称或说明没有描述真实用户请求；什么都触发则说明边界过宽。
触发问题要用正例和反例定位
文件存在但不触发，通常是名称或说明没有描述真实用户请求；什么都触发则说明边界过宽。先固定测试语句，再只改一个触发因素。
明确正例不触发
常见原因：description 没包含用户常用动作、对象或文件类型，或 Skill 未被当前作用域发现。
处理方法：先确认客户端能发现文件，再用用户原话改说明，不堆同义关键词。
记录客户端版本、Skill 版本、触发输入、实际步骤、工具调用和输出，正例与反例都要保留。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
相邻任务也触发
常见原因：说明只写了宽泛领域，没有排除条件和任务边界。
处理方法：加入具体交付、必要输入和不适用场景，用反例回归。
确认“相邻任务也触发”已经有可回查结果，再进入“触发后流程跑偏”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
触发后流程跑偏
常见原因：触发正确，但 SKILL.md 的输入、步骤、停止和验收不完整。
处理方法：把问题归到工作流而非触发，补缺材料行为和输出契约。
确认“触发后流程跑偏”已经有可回查结果，再进入“只在作者环境触发”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
只在作者环境触发
常见原因：作用域、路径、版本或依赖与测试环境不同。
处理方法：记录客户端版本与安装位置，在干净环境重复发现和触发测试。
脚本、网络、凭证和写操作必须在说明中可见；触发边界不清或结果不可验收时不要扩大使用范围。 完成后把证据归入“触发测试表与修订结论”。
只有实际现象和证据与这一分支吻合时才执行处理；不吻合就继续检查下一层。
固定测试集后再修说明
每次修改重跑应触发、不应触发、缺材料和相邻任务。只试一个成功例子无法证明边界稳定。