WorkBuddy导入自定义技能提示“格式错误”主因是JSON结构或文件扩展名不合规：文件名须严格为“.skill.json”结尾；顶层必须为含"name""description""triggers""steps"四字段的JSON对象；需用UTF-8无BOM编码；可用workbuddy skill validate命令精确定位错误。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy 导入自定义技能时提示“格式错误”，基本可以确定是 JSON 结构或文件扩展名不合规，不是权限或网络问题。

检查 .skill.json 文件扩展名与根字段是否齐全

WorkBuddy 对文件名和顶层字段有硬性要求，错一个就直接报“格式错误”，不会给出更具体的提示。

• 文件名必须严格以 .skill.json 结尾（注意中间不能有空格、下划线或版本号，例如 my_skill_v1.skill.json 会失败）
• 用文本编辑器打开该文件，确认最外层是 JSON 对象（即以 { 开头、} 结尾），且包含以下四个字段："name"、"description"、"triggers"、"steps"
• 如果文件里有 "mcp_version" 或 "actions" 字段但缺了 "triggers"，也会被判定为格式错误——WorkBuddy 当前只认这四个必填字段，多的不拦，少的不行

用 workbuddy skill validate 命令定位具体哪一行出错

图形界面拖拽导入只显示“格式错误”，但命令行能暴露真实原因。这个命令不依赖 GUI，也不需要先登录，适合快速验证。

WorkBuddy Visio — Visio 兼容架构图生成器

使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表

下载

• 先在终端执行 workbuddy --version，确认命令可用；若提示未找到，说明 CLI 模块未注册，需重装或修复 PATH
• 运行 workbuddy skill validate /path/to/your.skill.json（路径务必用绝对路径，Windows 用正斜杠或双反斜杠，如 C:/Users/me/skill.skill.json）
• 常见输出包括：ERR_MISSING_FIELD: triggers、ERR_INVALID_JSON: unexpected token '}' at line 42、ERR_SCHEMA_MISMATCH: steps must be array
• 如果提示 ERR_SIGNATURE_REQUIRED，说明该技能启用了签名校验，但你没配公钥或文件被篡改过，此时需联系技能提供方重新生成带签名的包

警惕编辑器自动保存导致的 BOM 头和编码问题

很多中文编辑器（如记事本、VS Code 默认设置）会在 UTF-8 文件开头插入不可见的 BOM 字节，WorkBuddy 解析 JSON 时会把它当成非法字符，直接报格式错误。

• 用 VS Code 打开文件 → 右下角查看编码显示，如果是 UTF-8 with BOM，点击它 → 选择 Save with Encoding → 改为 UTF-8
• Sublime Text 用户：菜单栏 File → Save with Encoding → UTF-8
• Notepad++ 用户：编码菜单选 Encode in UTF-8 without BOM
• 导入前可快速验证：用 head -c 5 your.skill.json | hexdump -C（macOS/Linux）或 PowerShell 中 Get-Content your.skill.json -Encoding Byte -TotalCount 5 | ForEach-Object { $_.ToString("X2") }，若开头出现 EF BB BF 就是 BOM

真正容易被忽略的是：即使 JSON 校验通过、字段齐全、无 BOM，如果 "triggers" 是空数组（[]）或 "steps" 里某个 step 缺了 "action" 字段，WorkBuddy 仍会统一归为“格式错误”而非细分提示。建议用官方示例模板比对结构，而不是仅靠肉眼扫一遍。