导入超级麦吉自定义Skill前须完成五步验证：一查文件完整性（skill.yaml、README.md、prompt.txt、schema.json缺一不可）；二验skill.yaml语法（name无空格中文、version语义化、triggers含有效正则）；三检prompt.txt编码与完整性（UTF-8无BOM、末行完整）；四核schema.json字段与prompt变量严格一致；五做本地模拟加载测试，确认状态为“已加载”且版本匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在超级麦吉中导入自定义Skill前，必须确认文件包结构完整、权限声明清晰、配置无语法错误，否则AI根本不会加载该技能——你反复修改提示词也毫无意义，因为系统压根没读到它。
第一步：确认基础文件是否全部存在
打开Skill压缩包（.zip）或本地目录，检查以下【必须存在】的4个文件是否一个不少：skill.yaml（主配置）、README.md（说明）、prompt.txt（核心指令）、schema.json（输入输出结构定义）。缺任意一个，任务提交后会直接报错“Skill definition invalid”，且不提示具体缺哪项。
这一步操作起来很简单，直接双击解压→用文件管理器数一数就行。别信压缩包里看着“好像有”的缩略图，要逐个点开确认文件真实可读。
第二步：验证skill.yaml是否语法合规
用VS Code或记事本打开skill.yaml，重点检查三处：【name字段不能含空格或中文】、version必须是语义化格式（如1.0.0）、triggers下至少有一条有效正则表达式（例如- "^整理.*周报$"）。
常见坑：复制粘贴时带入全角冒号、缩进用了中文空格、trigger正则末尾漏了$符号——这些都会导致触发失败，但错误日志只显示“no matching skill”，不会告诉你yaml本身有病。
快速验证法：把skill.yaml内容全选→粘贴到 https://yamlchecker.com/ 在线校验，绿色对勾才过关。
第三步：检查prompt.txt是否被意外截断
用记事本打开prompt.txt，拖到底部看最后一行是否完整。尤其注意是否因编码问题（ANSI/UTF-8-BOM混用）导致末尾几行显示为乱码或空白——这种文件上传后，AI只会读取前半部分，后半段逻辑彻底丢失。
正确做法：用Notepad++打开→菜单栏“编码”→转为“UTF-8无BOM格式”→另存为同名文件。
第四步：确认schema.json字段与prompt.txt实际调用一致
方法一：人工比对
在prompt.txt里搜索{{input.*}}或{{context.*}}，把所有变量名提取出来；再打开schema.json，核对properties下是否每个变量都有对应定义，类型（string/number/array）是否匹配。比如prompt里写了{{input.meeting_minutes}}，schema里却只定义了input.transcript，那运行时就会报“missing input field”。
方法二：用命令行快速扫描
cd 进入Skill目录 → 执行 python -c "import json; print([k for k in json.load(open('schema.json'))['properties'].keys()])" → 再执行 grep -o '{{input\.[^}]*}}' prompt.txt | sed 's/{{input\.//; s/}}//' | sort -u → 两组结果必须完全一致。
这一步最容易被跳过。很多人只盯着prompt写得漂不漂亮，却忘了AI执行时根本不看文字美丑，只认schema里白纸黑字写的字段名。
第五步：模拟加载测试（无需启动超级麦吉）
① 把整个Skill文件夹复制到超级麦吉安装目录下的/skills/local/子目录中（路径示例：C:\SuperMagic\skills\local\weekly_report_v2）
② 启动超级麦吉桌面端 → 左侧导航栏点击「数字员工市场」→ 切换到「本地技能」标签页
③ 等待5秒，观察右上角是否出现绿色提示：“检测到3个新本地Skill”
④ 点击刷新按钮 → 查看列表中该Skill状态是否为“已加载”，且右侧显示版本号与yaml中一致
【若显示“加载失败”或根本不出现在列表，请立即返回第二步重查yaml】
