超级麦吉中自定义技能需经四步验证：①通过skill list确认状态为【active】；②用/use {skill_id}或skill run触发；③在执行历史中核验输入、耗时及result.status是否为【success】；④用自然语言指令端到端测试语义识别与执行效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在超级麦吉中完成自定义技能开发后，必须验证其是否能被正确识别、触发并稳定执行，否则该技能将始终处于“静默状态”，无法参与项目协作或响应用户指令。
确认技能已加载进运行时环境
打开超级麦吉Web控制台 → 点击左下角【开发者模式】开关 → 在弹出的终端窗口中输入 skill list 并回车。
若看到你命名的技能ID（如 weekly-review-v2）出现在列表中，且状态列为 【active】，说明技能文件已被成功加载；若显示 not found 或状态为 【inactive】，请立即检查技能目录路径是否符合规范：/skills/{skill_id}/manifest.yaml 必须存在且无语法错误。
用最小化测试指令触发技能
方法一：在任意项目的话题输入框中，直接发送纯文本指令，格式为 /use {skill_id} + 空格 + 任意测试参数，例如：/use weekly-review-v2 project=Q3复盘。
方法二：在开发者模式终端中执行 skill run --id weekly-review-v2 --input '{"project":"Q3复盘"}'，注意 JSON 字符串必须用单引号包裹，内部双引号不可省略。
这一步操作起来很简单，直接把指令粘贴进去就行。但要注意：如果技能依赖外部工具（如Excel读取器），而当前沙盒未开启对应权限，会返回 permission denied 错误——此时需前往【设置→沙盒策略】手动勾选该技能所需的工具调用白名单。
观察执行日志与输出产物
第一步：在话题界面右上角点击【执行历史】图标，筛选类型为 skill 的记录。
第二步：找到刚触发的那条记录，点击展开详情，重点核对三项内容：
① 输入参数是否与你发送的一致；
② 执行耗时是否在预期范围内（超过15秒需检查是否有阻塞IO）；
③ 输出字段 result.status 是否为 【success】，且 result.output 中包含你期望的结构化数据或文档链接。
若输出中出现 error: missing required field "template_id" 类提示，说明 manifest.yaml 中声明的必填参数未在调用时传入，不是代码逻辑问题，而是接口契约未对齐。
模拟真实协作场景做端到端验证
创建一个新项目 → 新建话题 → 在输入框中发送自然语言指令：“帮我把上周会议录音整理成带行动项的纪要，用标准复盘模板”。
等待3～8秒，观察是否自动调用你刚部署的技能，并在下方生成带编号行动项、责任人和截止时间的 Markdown 文档。
这一步是唯一能验证“AI是否真正理解技能语义”的环节。如果系统调用了其他内置技能（比如默认的 meeting-summary），说明你的技能 manifest.yaml 中 intent_keywords 配置过窄或存在歧义词冲突，需要重新调整关键词权重或增加负向排除规则。
