Skill触发词不生效怎么办：按诊断顺序排查，别先卸了重装

触发词不生效，多数情况下不是“卸载重装”能解决的。它通常落在五类原因之一：触发条件与你说的不一致、输入变量缺失、调用通道不对、权限不足、文件位置或版本缓存问题。本文给你一棵诊断树，按验证成本从低到高走，每一步给最小验证和成功信号。

如果你需要一份可复跑的最小用例，可以用 Vibe Marketing 工具固定任务、输入与人工检查点，再用 营销周期例行任务工具补上触发条件、自检逻辑和停止开关。

排查前先收集四样东西

动手术之前先留证据，避免每排查一步都要重来一次：你输入的触发句原文、Skill 的返回或报错原文、调用时的完整上下文、以及当前 Skill 的版本号或安装路径。这四样东西齐了，诊断树才有输入。

先分清三种“不生效”

同样叫“不生效”，现象并不相同，先归类再排查，否则容易在错误的一层浪费半天。

• 完全无反应：Agent 像没装过这个 Skill，输出和普通对话无异。
• 被普通对话旁路接管：有输出，但绕过了 Skill 的指令流程，结果和没调用 Skill 时相同。
• 执行到一半失败：触发成功了，但某个环节报错或中断。

判断方法很简单：拿同一次输入，对比“调不调用 Skill”两种情况下的输出格式与报错。格式和内容完全不同，说明没有触发；格式相同但中途报错，才是执行环节的问题。

第一层：触发条件与关键词

最常见也最容易忽略。触发描述写的是“生成周报”，你却输“帮我写报告”；或者触发词带空格、大小写、中英文差异，Agent 无法完成精确匹配。

最小验证：用说明文档里的原样触发句测试一次。

修复：把常用说法变体补进触发描述；如果平台支持模糊触发，再考虑放宽匹配。不要为了“好触发”把触发词改得过于宽泛，它会误触发到不相关的任务。

第二层：输入变量缺失

指令里声明了必填变量，例如目标、受众、渠道，你没提供。很多 Skill 在这种情况下选择静默跳过，而不是主动追问。

最小验证：补齐所有必填变量后再触发一次。

修复：按变量契约给全信息；如果你自己写调用提示词，把变量逐个列出来，并注明哪一个是必填。

第三层：调用通道与 Agent 配置

Skill 可能只挂在某个入口，例如对话、终端、文件操作或快捷键。你用的入口不在它声明的范围内，自然不生效。

最小验证：换说明里声明支持的入口复测一次。

修复：在正确入口使用；长期不要两个入口混着触发同一个任务，避免结果不可复现。

第四层：权限、密钥与外部写入

Skill 执行到读文件、写文件或调用外部服务时，权限不足会中断，而且报错信息可能被界面折叠，看起来像“没生效”。

最小验证：先做一次只读检查，核对配置与授权状态，不要第一步就放开权限。

修复：按最小授权补齐需要的权限；仍失败则保留完整报错记录交给维护方，不反复尝试放开全部权限。

第五层：文件位置、版本与缓存

Skill 装进了错误的目录，或者旧版本被缓存覆盖，新改动没有真正加载。

最小验证：核对安装位置与文件更新时间，确认加载的是你改过的那个版本。

修复：重新加载而不是反复删除再安装；顺手记录当前版本号，下次排查先对版本。

修复后的成功信号与预防

成功信号是：同一个测试输入连续三次得到一致的正确输出，且每次都能从日志或输出里看到 Skill 确实被触发。

预防动作：给关键 Skill 写一条回归用例，改一次跑一次；把这次的诊断顺序存进团队笔记，下次同一个问题按同一棵诊断树走，不再从头摸索。

什么时候升级到人工通道

第一到第五层都过了仍无解，且影响业务，就带着版本号、触发句和完整报错升级到人工维护通道，而不是继续卸载重装。重装只在确认版本或安装路径出问题时才有意义，它解决不了变量、通道和权限层的问题。