Skill 没有生效怎么办？排查触发、环境和输入问题
区分未触发、依赖缺失、输入不足和输出不合格四种情况，按证据定位问题，减少重复尝试。
Skill 没有达到预期时，先确认失败发生在哪一层。没有被读取、没有执行工具、工具执行失败和输出质量不足，属于不同问题。把现象分开，通常比重复发送同一条任务更有效。
情况一：方法没有被采用
检查目标客户端是否支持这类包，文件是否按说明放置，名称与描述是否匹配任务。有的客户端需要明确选择，有的会根据描述自动发现。先用一句清楚的任务描述，并要求按指定方法处理小样本。
如果客户端反馈找不到方法，先检查安装和路径。不要立刻增加复杂需求。客户下载包应跟随自己的说明使用，开放格式的安装方式不能直接套到所有包上。
情况二：方法被读取，但工具无法运行
保留最早出现的错误，区分缺运行时、缺系统程序、文件路径不存在、账号未登录或服务不可用。一次只修复明确的问题，再运行最小步骤验证。
视频任务可能需要媒体程序与渲染依赖，浏览器任务可能需要对应会话。检查说明中的环境组，确认当前机器和当前任务目录。不要把另一台机器上安装过的依赖当成这里已经具备。
情况三：输入不足或格式不匹配
核对工具实际读取的文件。多份同名材料、损坏的音频、只有截图而没有原始表格，都可能导致后续步骤无法完成。先打开输入文件，确认格式与内容。
缺少业务事实时，应补资料或明确标记待确认。让 AI 自己补出功能、日期或测试结果，可能得到一份完整但不正确的交付。明确输入边界有助于避免这类问题。
情况四：执行成功，但结果不合格
先按输出类型检查。音频要试听，视频要完整播放，表格要检查关键计算，会议记录要对照原文。把问题写成具体差异，例如“行动项没有保留负责人字段”“字幕在这一段遮住按钮”。
然后判断应该改输入、方法还是执行参数。资料不完整时补资料；标准没有写清时补方法；时序错误时检查真实音频与时间轴。不要把所有问题统一归结成“模型不够好”。
排查记录保留哪些信息
- 使用的包版本与客户端环境。
- 最小可复现输入，以及期望输出。
- 首个错误或具体缺陷的位置。
- 做过哪些调整，每次结果是否变化。
- 还没有验证的环境或步骤。
记录时去掉账号凭据、访问令牌和不必要的私人内容。需要向维护者反馈时，提供脱敏样例与错误现象，有助于复现问题。
什么时候值得重新尝试
环境修复、资料补齐或方法明确修改后，可以重新运行小样本。结果一直相同而条件没有变化时，先继续定位原因。跑通后再处理完整任务，并按照 使用指南检查最终交付。
准备换工具时，可用 挑选 Skill 的六项检查判断新方案是否真的能解决当前问题。