超级麦吉AI技能无输出的主因是执行链路阻断。需依次确认：项目级技能是否启用、触发短语是否精准匹配、上下文是否超载、工具调用是否失败并添加错误报告语句。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
超级麦吉AI技能执行后界面空白、无输出、进度条卡住或只显示“正在思考”却迟迟不返回结果，不是技能写得不好，而是执行链路上某个环节被阻断了。
确认技能是否真正加载进当前会话
打开超级麦吉App → 点击左上角「项目」→ 进入目标项目详情页 → 滑动到底部「已启用技能」区域。
如果列表为空，或缺失你刚上传的SKILL.md文件名，说明该技能未被加载。此时即使你在输入框里反复输入触发词，AI也完全“看不见”这个技能。
【必须在项目级启用，而非全局】超级麦吉采用项目隔离机制，技能需逐个项目手动开启，不会自动继承到新项目中。
点击「+ 添加技能」→ 从本地选择SKILL.md → 完成导入后，务必点击右上角「保存设置」——仅导入不保存，下次进入仍不生效。
检查触发条件是否命中且无冲突
方法一：用frontmatter里声明的原生触发短语直接提问
打开你的SKILL.md文件，找到顶部---之间的description字段，例如：Triggers on "/summarize", "请帮我总结", "提炼重点"。这时不要说“把这段文字简要概括一下”，而要严格使用其中任一短语，比如直接输入“/summarize”。
方法二：显式调用，绕过模糊匹配
在输入框开头键入/skill-name（将skill-name替换为你的技能文件夹名，如deep-research），再跟具体指令。这会强制路由到指定技能，避免被同名或语义相近的其他技能劫持。
注意：若多个技能都配置了“分析”“总结”类泛化触发词，它们会在后台竞争路由权，优先级由安装顺序和匹配精度共同决定，不保证每次都调用你想要的那个。
验证上下文是否被挤占或截断
第一步：观察输出是否突然中断
如果AI返回了一半内容就停止，比如生成PPT时只出了封面和目录页，后面空白，大概率是token耗尽。超级麦吉默认单次响应上限为8192 token，含系统提示、历史对话、技能文档全文及输出。
第二步：临时精简输入
把原始输入压缩到300字以内，去掉修饰性描述，只保留核心指令+必要参数。若此时能完整返回结果，即可确认是上下文超载导致技能正文或输出被截断。
第三步：拆分执行
① 将长文档先用「AI文档解析」技能转为结构化摘要；
② 再把摘要喂给目标技能处理；
③ 必要时用write工具把中间结果存为临时文件，下一阶段明确读取该文件路径。
排查工具调用是否静默失败
很多技能依赖web_search、exec、read_file等工具，但超级麦吉默认不向用户暴露工具错误日志。
在你的SKILL.md末尾添加强制报告语句：“如果任意工具调用失败，必须明确输出‘工具错误：[错误类型]’，不得跳过或假装成功。”
执行后若看到“工具错误：network timeout”，说明搜索接口未连通；若出现“工具错误：file not found”，则路径填写有误或文件未上传至项目空间。
【路径必须用项目内相对路径】例如read_file("./data/report.pdf")才有效，绝对路径或桌面路径一律失败。
