技能未显示是因识别闭环未完成:需确认./skills/下存在以ID命名的子目录及合规skill.json(含name、version、entry、description四字段),再开启开发者模式、重载索引、在本地技能页启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在超级麦吉中导入自定义或第三方技能后,界面里完全找不到调用入口、技能列表为空、输入指令也无响应——这不是技能失效,而是平台未完成识别闭环。
确认技能是否真正进入系统目录
打开超级麦吉安装根目录,进入 ./skills/ 子文件夹。这里必须存在以技能ID命名的独立子目录(如 weather-forecast-v2),且该目录内含有 skill.json 文件(非 SKILL.md 或 manifest.json)。
若目录结构缺失或文件名错误,AI启动时会直接跳过扫描——这一步不满足,后续所有操作都无效。
检查 skill.json 是否符合强制规范
用文本编辑器打开 skill.json,确认它至少包含四个必填字段:name、version、entry、description,且 entry 值为合法 Python 模块路径(如 "main:run"),不能是相对路径或 shell 命令。
字段缺失或格式错误会导致技能被静默过滤,不会报错也不会出现在列表中。
强制刷新技能索引与状态
第一步:在超级麦吉 Web 控制台左下角点击「设置」→「开发者模式」→ 开启开关;
第二步:返回首页,点击右上角用户头像 →「重载技能索引」;
第三步:等待顶部提示“索引更新完成”,再打开左侧导航栏「数字员工市场」→ 切换到「本地技能」标签页。
【必须完成全部三步,仅刷新页面无效】
验证技能启用状态
方法一:在「本地技能」列表中找到目标技能,右侧状态显示为「已启用」才可调用;
方法二:终端执行 magic-cli skills list --enabled,输出中应包含该技能 ID;
若状态为「已禁用」,点击技能卡片右上角「启用」按钮即可生效。
注意:部分技能依赖环境变量或外部 API Key,启用前需先在「设置 → 技能配置」中补全参数,否则启用后仍不可用。


















