技能文件导入WorkBuddy失败主因是格式不符：须为UTF-8编码、无BOM、以.skill.json结尾且命名合法；根对象严格含name、description、triggers、steps四字段；存放于本地非同步盘路径并确保读写权限；可用wb-cli命令行工具精准校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试将技能文件导入 WorkBuddy，但系统提示“校验失败”或“不支持的文件类型”，则可能是由于技能文件格式不符合平台强制规范。以下是确保技能文件可被正确识别与加载的关键要求和验证步骤：
一、确认技能文件扩展名与命名规范
WorkBuddy 仅接受以 .skill.json 为后缀的纯文本文件，且文件名中不得包含空格、中文字符或特殊符号（如@、#、$、%等），否则拖拽或选择时将无法被识别。
1、检查文件在资源管理器或访达中显示的完整名称，确认结尾为 .skill.json；
2、若文件实际为.txt、.json或无后缀，请重命名为合法格式（例如：data_analysis.skill.json）；
3、右键文件属性，确认“只读”属性未被勾选，且文件未被其他编辑器或进程锁定。
二、验证 JSON 内容结构合规性
文件必须是标准 UTF-8 编码的 JSON 文本，且根对象必须严格包含四个顶层字段："name"、"description"、"triggers" 和 "steps"，缺一不可，字段名大小写必须完全匹配。
1、用 VS Code、Notepad++ 或系统自带文本编辑器打开该文件；
2、确认首字符为 {，末字符为 }，无 BOM 头；
3、逐项检查是否存在以下字段并具备合法值：name（字符串）、description（字符串）、triggers（数组，至少含一个字符串元素）、steps（数组，至少含一个对象，每个对象含 type 和 config 字段）；
4、使用在线 JSON 校验工具（如 jsonlint.com）粘贴内容，确认无语法错误提示。
三、检查文件路径与访问权限
WorkBuddy 在解析时会读取文件元数据及内容流，若存放路径存在权限限制、网络挂载延迟或符号链接断裂，会导致静默校验失败，界面仅显示“文件无效”而无具体原因。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
1、将技能文件复制至本地非系统目录，例如桌面（Desktop）或文档（Documents）文件夹；
2、避免存放在 OneDrive、iCloud Drive、NAS 挂载盘或压缩包内；
3、在 Windows 上确认当前用户对所在文件夹具有“读取与执行”权限；在 macOS 上右键文件→“显示简介”，展开“共享与权限”，确保当前用户权限为“读与写”；
4、临时关闭杀毒软件实时扫描功能，防止其拦截文件读取操作。
四、通过命令行执行离线结构校验（高级）
对于批量验证或 CI/CD 集成场景，可调用 WorkBuddy 内置 CLI 工具进行无 GUI 环境下的静态校验，输出精确错误定位（如缺失字段位置、非法字符偏移量）。
1、打开终端（macOS/Linux）或 PowerShell（Windows），进入 WorkBuddy 安装目录下的 bin 子目录；
2、执行命令：./wb-cli skill validate /path/to/your.skill.json（macOS/Linux）或 wb-cli.exe skill validate C:\path\to\your.skill.json（Windows）；
3、观察返回结果：SUCCESS 表示结构合规；FAILURE 后跟随具体 JSONPath 错误描述（如 $.triggers[0]: expected string, got null）；
4、根据错误路径修改对应字段后重新运行命令，直至返回 SUCCESS。
