超级麦吉AI技能需明确使用前提以避免失败：【仅支持：.xlsx、.csv；不支持：.xls、加密文件、在线表格链接】；【必需字段：客户ID（文本）、下单时间（ISO 8601格式）】；【需已授权：飞书多维表格读取权限、企业微信成员信息API】；【前提：用户近7天内至少提交过1份含‘本周进展’‘下周计划’字段的周报】；【运行环境：麦吉AI Core v3.8.2-r214】。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
给超级麦吉AI的技能写清使用前提，是为了避免用户在不满足条件时触发失败、报错或输出无效结果，比如上传了PDF却要求“直接编辑表格”，而该技能根本不支持PDF解析——这种情况下必须提前拦住。
明确技能依赖的输入类型与格式
第一步：确认该技能实际能接收的文件类型。例如“Excel数据清洗”技能仅支持.xlsx和.csv，不接受.xls、.xlsb或带密码的Excel文件。
第二步：在技能描述首行用括号注明硬性限制，格式统一为【仅支持：.xlsx、.csv；不支持：.xls、加密文件、在线表格链接】。
第三步：若技能需特定列名结构（如必须含“客户ID”“下单时间”两列），在第二行写明【必需字段：客户ID（文本）、下单时间（ISO 8601格式，如2024-03-15T09:30:00）】——漏掉格式要求会导致时间解析全错。
标注运行所需的上下文权限
方法一：检查是否需访问外部数据源。若技能要调用企业微信通讯录或飞书多维表格，必须写明【需已授权：飞书多维表格读取权限、企业微信成员信息API】。
方法二：判断是否依赖用户历史行为。例如“智能续写上周周报”技能，必须声明【前提：用户近7天内至少提交过1份含‘本周进展’‘下周计划’字段的周报】——没有历史数据，续写就是无源之水。
【注意：权限未开启时，技能不会自动弹窗申请，而是静默失败】
说明环境与版本约束
打开超级麦吉AI后台的「技能配置→运行环境」页，复制当前绑定的引擎版本号（如v3.8.2-r214），粘贴到技能说明末尾，格式为【运行环境：麦吉AI Core v3.8.2-r214】。
若该技能调用了新引入的向量缓存接口，而旧版引擎不支持，则必须加一句：低于v3.8.2-r214版本将跳过缓存步骤，响应延迟增加40%以上。
这一步不能省——用户若在v3.7.0环境部署，技能表面能运行，但关键功能已降级失效。
