超级麦吉AI技能未触发是因平台未识别Skill文件；需检查路径是否为根目录下skills/、文件名合法、YAML语法正确、必备字段齐全、环境变量启用、上下文未超长、步骤动词明确、工具名匹配且无注释。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
超级麦吉AI技能提示文件写好了却始终不触发执行，不是Skill内容写得不好，而是平台根本没识别到这个文件——这种问题在本地部署环境中高频出现，尤其当文件名、路径、格式或权限任一环节出错时，AI会完全无视该Skill。
确认Skill文件是否被正确加载
打开终端，进入超级麦吉项目根目录，执行：./bin/magic.sh logs super-magic | grep -i "skill"。
观察输出中是否出现类似 Loaded skill: meeting_summary_v2 的日志行；若无任何 skill 相关日志，说明文件未被扫描加载。
检查 skills/ 目录是否存在且位于项目根目录下——【必须是根目录下的 skills/ 子目录，不能嵌套在 config/ 或 src/ 内】。
确认该目录下 Skill 文件名以 .yaml 或 .yml 结尾，且不含空格、中文、特殊符号（如括号、@、#）；例如 data_clean_v1.yaml 合法，数据清洗_v1.yml 或 report (final).yaml 会导致加载失败。
验证Skill文件语法与结构合规性
方法一：用在线 YAML 校验器（如 yamllint.com）粘贴 Skill 文件全文，确认无缩进错误、冒号后缺少空格、引号不闭合等基础语法问题。
方法二：在终端执行 python3 -c "import yaml; print(yaml.safe_load(open('skills/your_skill.yaml')))"，若报错则说明 YAML 解析失败，需修正后再试。
方法三：检查文件开头是否包含标准 Skill 声明块——必须有 name:、description:、trigger: 三项，缺一不可；trigger 值必须为字符串（如 trigger: "生成会议纪要"），不能是数组或空值。
排查上下文干扰导致Skill丢失
第一步：在超级麦吉 Web 界面中，新建一个空白对话，仅输入触发词（如“生成会议纪要”），不附加任何其他文本、不 @ 文件、不上传附件。
第二步：发送后立即打开浏览器开发者工具（F12）→ Network 标签页，筛选 XHR 请求，找到 /v1/chat/completions 对应的请求，点击 → Payload → 查看 messages 数组中是否包含 skills 字段及对应 Skill 名称。
第三步：若该字段为空或缺失，说明当前对话上下文未注入 Skill；此时需确认 config/.env_super_magic 中 SUPER_MAGIC_SKILLS_ENABLED=true 已启用，且未被注释。
注意：如果对话中已存在超长历史消息（>8000 token），模型上下文窗口会被占满，Skill 配置可能被自动截断丢弃——此时需清空对话重试。
检查Skill结构是否适配模型注意力机制
打开你的 Skill 文件，定位到 steps: 下的每个子项。
确保每个步骤都以短句开头，且首句动词明确（如“提取参会人姓名”“识别决议事项”“按时间顺序排列”），避免使用“请…”“建议…”“可以考虑…”等弱指令表述。
检查所有 tool_calls: 调用是否声明了真实存在的工具名——运行 ./bin/magic.sh logs super-magic | grep "registered tool" 可列出当前已注册工具清单，【工具名必须完全一致，大小写敏感】。
删除 Skill 文件中所有注释行（以 # 开头的行），部分 YAML 解析器在生产模式下会因注释导致结构解析异常。
