若外部技能导入后无法被识别触发，可能是关键词匹配未达阈值、语义解析失败或注册元数据异常；需依次检查keywords字段完整性、格式合规性及动态触发阈值抑制情况。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功将外部技能导入WorkBuddy，但该技能在对话或消息中始终无法被识别与触发，则可能是由于关键词匹配未达触发阈值、语义解析失败或注册元数据异常所致。以下是针对性排查与校验步骤：
一、检查技能关键词注册完整性与格式合规性
WorkBuddy依赖技能包内 manifest.json 或 skill.yaml 中声明的 keywords 字段进行意图初筛，若字段缺失、为空数组、含非法字符或长度超限（单个关键词超过32字符），将导致触发器跳过该技能。
1、打开WorkBuddy主界面，点击左下角【Skills】图标进入技能管理页。
2、找到目标技能，点击右侧【详情】按钮，展开元数据面板。
3、核对「触发关键词」列表是否非空，且每项均为纯中文、英文或中英混合短语（禁止含通配符*、正则表达式、空格开头/结尾）。
4、若关键词显示为“未配置”或为空白，说明技能包未正确声明keywords，需联系分享方补全 manifest.json 中的 keywords: ["生成摘要", "会议纪要"] 字段并重新打包。
二、验证自然语言触发阈值是否被动态抑制
WorkBuddy默认启用语义置信度动态阈值机制：当当前上下文存在更高匹配度技能、或历史调用频次偏高时，会临时提升该技能的触发门槛，防止误激活。此行为不修改关键词本身，但影响实际命中率。
1、在聊天输入框中，输入明确包含已注册关键词的指令，例如：“请用会议纪要技能整理以下录音文本”。
2、发送后立即打开右上角头像 → 【Claw 设置】→ 【调试日志】，筛选关键词 “intent_match”。
3、查找对应时间戳日志行，确认是否存在类似 "score: 0.68 的提示，表明当前语义得分低于动态阈值。
4、如确认阈值抑制，可在指令前添加强制前缀 [force]，例如：[force]会议纪要整理，绕过阈值校验直接调度。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、校验技能ID与关键词绑定关系是否注册成功
导入过程中若发生元数据解析中断（如YAML缩进错误、JSON语法破损），可能导致 keywords 字段被忽略，仅注册了技能ID而未建立关键词索引，造成“技能存在但不可触达”的现象。
1、关闭WorkBuddy客户端。
2、定位本地技能目录：Windows路径为 %APPDATA%\Tencent\WorkBuddy\skills\{skill_id}\manifest.json；macOS路径为 ~/Library/Application Support/WorkBuddy/skills/{skill_id}/manifest.json。
3、用文本编辑器打开 manifest.json，确认根级存在 keywords 字段，且其值为字符串数组，例如："keywords": ["查天气", "天气预报"]。
4、若 keywords 字段缺失或类型错误（如写成字符串而非数组），手动修正后保存文件，重启WorkBuddy并点击该技能卡片上的【重载】按钮。
四、测试关键词最小可触发单元与边界条件
WorkBuddy对关键词匹配采用前缀+子串混合策略，但要求关键词必须为独立语义单元——若关键词嵌套于长句中且前后无标点/空格分隔，可能被NLP分词器切碎而失效。
1、在空白对话中单独发送仅含关键词的消息，例如：会议纪要（不带任何其他字、标点或空格）。
2、观察是否立即弹出技能执行确认面板或直接启动流程。
3、若单独发送可触发，但在复合句中失效（如“帮我做会议纪要”无响应），说明分词未识别该词为完整意图单元，需在 manifest.json 中补充更短、更原子化的关键词，例如增加 "纪要" 和 "会议"。
4、避免使用易被泛化为通用动词的词汇（如“处理”“分析”“查看”），此类词默认被系统降权，须配合强限定词组合使用（如“Excel处理”“PDF分析”）。
