腾讯云开发者社区 · WorkBuddy 生态实战

从零打包到过审：我被解析器拒了 12 次换来的完整 Schema 与避坑清单

WorkBuddy 开放平台允许开发者把自己的 AI 专家、技能、专家团发布到市场。但官方文档与实际校验器之间存在不少差异——本文的每一条规则都来自

，并用一个可复用的本地校验器固化。照着做，一次过审。

一、先分清四种发布物（90% 的人第一步就走错）

⚠️ 血泪教训：技能位和专家位的上传校验完全不同。拿专家结构传技能位，报"未找到 SKILL.md"；反之报"未找到 plugin.json"。上传前先确认你点的是哪个发布入口。

二、技能包：SKILL.md 的 8 个必填字段与 3 个隐形坑

---
name: "your-skill-name"              # 小写连字符，与目录名一致
display_name: "技能中文名"
display_name_en: "English Name"
description: "写清用途和触发词（命中即触发）"
description_zh: "详情页中文简介"
description_en: "English intro"
version: 1.0.0
author: "你的名字"
examples_zh: ["案例一", "案例二", "案例三"]   # 最多 3 条！
examples_en: ["Case 1", "Case 2", "Case 3"]
---

三个隐形坑（全部实测踩过）：

（参考资料，用 @references/xxx.md 引用）、

三、专家包：plugin.json 十六字段全家福

{
  "name": "my-expert",                    // 小写连字符（全局唯一，被占就换名）
  "version": "1.0.0",
  "description": "English short desc",
  "author": { "name": "xx", "email": "xx@xx.com" },
  "agents": ["./agents/my-expert.md"],
  "expertType": "agent",                  // 或 "team"
  "agentName": "my-expert",               // = agents 文件名（不含.md）
  "displayName":     { "zh": "中文名", "en": "Name" },
  "profession":      { "zh": "职业头衔", "en": "Title" },
  "displayDescription": { "zh": "40-50字的中文描述（硬校验！）", "en": "..." },
  "avatar": "avatars/expert.png",         // 512×512 PNG，≤500KB
  "categoryId": "02-Engineering",         // 15 个官方分类选一
  "defaultInitPrompt": { "zh": "开场白", "en": "Init" },   // 必须与 quickPrompts[0] 双语一致
  "plugin": "my-expert",                  // = name
  "tags":       [{ "zh": "标签1", "en": "T1" }, ×3],      // 恰好 3 个
  "quickPrompts": [{ "zh": "提示词1", "en": "P1" }, ×3]   // 恰好 3 个
}

① 中文描述不落在 40-50 字区间；② defaultInitPrompt 只对齐了中文没对齐英文（双语各自比对）；③ 头像不是 512×512；④ name 被占用（建议挂自创品牌前缀，撞名概率趋零）。

四、专家团：文档没写、报错才教你的五条铁律

Team 型是坑最密集的地方——官方文档只写了 teamInfo，实际校验器按另一套来。五条实测铁律：

的——Go 的 unmarshal 错误只报类型不报枚举，枚举校验在 validate 层。所以"类型过了仍报值非法"时，第一时间猜枚举。每次报错都精确到一个字段，逐条反推就是最快的文档。

五、把踩坑工程化：发布前本地校验器

与其每次上传赌运气，不如把全部规则写成本地校验脚本——我的 13 项规则覆盖了上面每一条（字段存在性 / i18n 结构 / 字数区间 / 双语对齐 / 头像规格实算 / lead 唯一性 / 三处一致 / YAML 冒号炸弹 / examples 计数 / 公司词扫描），打包前跑一遍，零成本拦截 90% 的拒审：

$ node audit.js
✓ my-expert [专家]
✓ my-team [专家]
✓ my-skill [技能]
=== 3/3 通过 ===   # 再上传，一次过

思路可复用到任何有上传校验的平台：

——把每条报错转成断言，你就拥有了一份官方永远不会写出来、但永远不会过时的 Schema 说明。校验器思路已随我的开源框架发布：

（配套 17 篇 AI 工程实战连载）。

《用 WorkBuddy 专家团搭一条"需求→上线"流水线》——五个 AI 角色如何靠 MCP 插槽接入任意云，换地址即适配

本文所有报错与规则均来自作者实际上传验证（2026 年 10-11 月），规则可能随平台迭代变化，以官方文档与最新报错为准。欢迎评论区交流你遇到的解析失败案例。

WorkBuddy 开放平台允许开发者把自己的 AI 专家、技能、专家团发布到市场。但官方文档与实际校验器之间存在不少差异——本文的每一条规则都来自真实上传报错逐条反推，并用一个可复用的本地校验器固化。照着做，一次过审。

WorkBuddy 专家/技能发布完全指南

人工智能

上传WorkBuddy开放平台常被解析器拒？本文基于真实报错反推，整理技能、专家、专家团四大发布物的完整Schema与13项本地校验清单，覆盖必填字段、YAML冒号炸弹、examples上限、头像规格、lead唯一性等高频坑点。照做一次过审，附可复用校验器，助你快速上架AI应用。

WorkBuddy 

CodeBuddy

GitHub

Redis

Agent

JSON

腾讯云双十一大促

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

WorkBuddy 专家/技能发布完全指南

WorkBuddy 专家/技能发布完全指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐