必须确保技能文件结构合规、路径正确才能成功导入超级麦吉:根目录仅一个含name/description/input_schema/output_schema的SKILL.md;ZIP需扁平化;桌面端文件夹名禁用中文与特殊字符;导入后须经状态、调试、调用三步验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想把在其他平台写好的技能文件(比如 SKILL.md、配套脚本或参考资料)直接用到超级麦吉里,而不是重头在线编写——这一步必须确保文件结构合规、路径正确,否则导入后技能无法识别或调用失败。
确认技能文件是否符合规范
打开你的技能文件夹,检查是否存在 【根目录下必须有且仅有一个 SKILL.md 文件】;该文件需包含 name、description、input_schema、output_schema 四个必填字段,缺一不可。若你从 ChatGPT 或 Claude 导出的只是纯提示词文本,没有 YAML 结构声明和工具绑定定义,它不属于超级麦吉可识别的技能文件,不能直接导入。
ZIP 压缩包内禁止嵌套多层文件夹,所有内容(SKILL.md、scripts/、assets/ 等)必须位于压缩包顶层,否则导入时解析失败且不报错,只会静默跳过。
通过「导入文件」方式上传技能
方法一:上传 ZIP 压缩包
登录超级麦吉 → 进入「技能中心」→ 点击右上角「+ 新建技能」→ 选择「导入文件」→ 拖入已准备好的 ZIP 包 → 等待自动校验完成 → 校验通过后点击「确认导入」。
方法二:上传单个 SKILL.md 文件
同上路径进入导入页 → 不拖 ZIP,改选「上传 SKILL.md」→ 选中文件 → 系统会立即解析并显示技能元信息(名称、描述、输入项)→ 若提示“缺少 scripts 目录”或“未声明 tool_calls”,说明该技能依赖外部脚本但未一并提供,此时必须退回补全再压缩上传。
方法三:上传技能文件夹(仅限桌面客户端)
在超级麦吉桌面版中,「导入文件」按钮旁有「选择文件夹」小图标 → 点击后直接选取本地技能文件夹 → 文件夹名将作为技能标识符写入系统 → 【文件夹名不能含中文、空格或特殊符号】,否则后续调用时可能触发路径解析异常。
验证导入是否成功
第一步:回到技能中心首页,找到刚导入的技能卡片,确认状态为「已启用」而非「待配置」。
第二步:点击该技能卡片 → 查看「调试面板」→ 输入符合 input_schema 的 JSON 示例(例如 { "query": "Q3销售数据汇总" })→ 点击「运行测试」。
第三步:观察返回结果。若出现「执行超时」或「tool not found」,说明 scripts/ 下的 Python 或 JS 脚本未被正确加载,需检查 ZIP 内脚本文件扩展名是否为 .py 或 .js,且无隐藏的 .DS_Store 或 ~$ 临时文件混入。
第四步:在任意工作流中添加「调用技能」节点 → 搜索技能名 → 若能正常选中并展开参数配置区,即表示注册成功,可投入实际使用。











