9月初的时候，WorkBuddy的开放平台就正式上线了，首批引入了超过百家生态伙伴，面向智能硬件、行业应用与开发者等开放了底层的Agent能力。

老马一直没有去入驻体验一下，直到群里有小伙伴问到这个事情，怎么把自己做好的专家，发布到WorkBuddy的专家技能连接器上，给其它人使用。

刚好昨天又在群里看到另外一位博主老师已经入驻发布成功了一个专家，这么看来WorkBuddy的开放平台确实是上线，并且跑通了。所以今天就来手把手教大家入驻，以及发布自己的技能、应用啥的。

01 · REGISTER

注册入驻与资质认证

首先WorkBuddy开放平台的入驻需要注册登录，打开官网open.workbuddy.cn，点击立即入驻去注册登录就行了：

注册登录完，必须进行资质认证。认证支持个人开发者和企业开发者两种身份。区别在于，个人开发者无法创建Buddy应用和接入硬件，企业开发者可以。

个人认证需要大陆二代身份证 + 已实名手机号 + 邮箱 + 人脸识别。一个身份证全平台只能认证一个个人主体，港澳台及外籍证件暂不支持。

企业认证需要上传营业执照，三种方式三选一（法人扫码人脸核身 / 腾讯云快速认证 / 微信公众号或小程序快速认证）。一个账号最多认证10个企业主体：

老马为了给大家演示截图，就选择了企业认证。当然，有自己公司的还是建议企业认证，反正无论是个人认证还是企业认证都是不需要认证费用的：

企业认证老马是通过法人扫码人脸核身的方式去操作，只需要填写管理员的认证信息，这个管理员也就是超级管理员。然后上传营业执照，两次扫码做一下人脸识别，马上就认证完成了。

02 · BUDDY APP

发布管理五类入口与Buddy应用

认证完毕之后直接进入WorkBuddy开放平台的管理界面，在左侧菜单的发布管理里面可以看到，支持我们上传发布或者创建接入的有Buddy应用、专家、技能、连接器（MCP）、硬件接入这几类：

老马点击了一下Buddy应用，此时会提示要求补充一下开发者信息。你就根据实际情况去补充即可，但企业认证的账号，这里的开发者信息最好是填公司的，老马是随便填了个人的：

开发者信息补充完毕，就可以顺利进入Buddy应用的在线创建页面。Buddy应用是不需要上传什么技能包或者代码包的，直接在线配置相关信息即可：

有小伙伴可能到现在都没搞清楚WorkBuddy的Buddy应用到底是个什么东西，简单来说，它的定位是行业Harness，在现成已经有的WorkBuddy底座上，编排改成你自己的Agent。

你不需要重新去开发一个像WorkBuddy这样的Agent，而是直接在开放平台上填写表单配置5个模块即可。

这5个模块和配置流程老马整理了如下：

①创建应用（拿到Client ID/Secret，Secret只会显示一次）

②首页配置（Slogan、场景胶囊、工作模式建议3-5个）

③市场配置（选配可用的专家/技能/连接器）

④其他配置（模型池勾选排序等）

⑤预览调试。

简单地说，你是在创建一层壳，这层壳叫Buddy应用，在WorkBuddy上安装了，就等会把壳套上了，变成了你自己个性化定制的WorkBuddy。

这么说能理解吧？不能理解也没关系，因为Buddy应用的创建一般普通的小白用户也用不上，更不会去操作，企业级的专业用户可以搞搞。

03 · EXPERT

专家与专家团的规范要求

值得一提的是，WorkBuddy这种开放平台，目前来看规范还是做得不错的。就是接下来你要上传专家、专家团、技能都好，都得严格按照规范来准备好结构化的代码包，比如点开专家：

如上图可以看到，配置专家你只能上传压缩包，压缩包内就必须包括以下各种结构化文件：

①
.codebuddy-plugin/plugin.json（核心配置）+ agents/xxx.md（Agent 定义，frontmatter + 系统提示词正文）+ avatars/ 头像 + README。

② plugin.json 硬要求：expertType: “agent”；展示名称、职业头衔、描述全部中英双语；displayDescription 中文必须 40-50 字；tags 固定 3 个、quickPrompts 固定 3 个；defaultInitPrompt 必须和 quickPrompts 第一条一致；categoryId 从 15 个行业分类里选一个。

③ 头像：512×512正方形PNG，单张≤500KB，统一漫画/插画风格。

④ 不能自己加 tools，工具权限系统统一分配；依赖的 MCP/连接器通过 dependencies 或 .mcp.json 声明（可带x-workbuddy 展示元信息 + token 表单）；包内严禁硬编码真实 Token。

你要问老马是怎么知道这些看起来很复杂的规范要求的，等下下文会说。这些规范要求不需要我们自己去记忆，自己手动去调整，可以交给WorkBuddy帮我们去按照规范修改现有的专家技能。

就好像上面的规范要求内容，也不是老马一个个对照着，敲键盘打出来的，同样是让WorkBuddy根据官方文档去总结。

专家团跟专家的规范要求区别在于，比专家还多了三样要求：

① expertType: “team”，多了 teamInfo（leadAgent 主理人 + memberAgents 成员列表）和 members 数组（每个成员：id / 名称 / 头衔 / 头像 / role）。

② 主理人的agent文件名必须带专家团前缀（文档明确不可用通用 “team-lead”）；每个成员都要单独头像。

③ 主理人只负责编排调度，文档铁律：禁止代写成员的专业产出、禁止让成员互相直连。

所以在WorkBuddy开发平台上，专家跟专家团都是通过配置专家的页面，统一去上传解析后配置提交审核的，区别只是规范要求的结构化文件内容不同。

04 · SKILL & MCP

技能与连接器的规范要求

下面进入技能，技能的话好在规范要求没那么多，但其实细节也挺多的。后面你看老马演示的一次完整的技能上传就知道了，来来回回改了好多次的规范写法：

配置技能相关的结构化要求如下：

① 目录里SKILL.md必须有：references/（参考资料）、scripts/（脚本）、templates/（模板）可选。

② SKILL.md = YAML 头 + Markdown 正文。必填字段：description（写清用途和触发词）、description_zh、description_en、version、author；正文写清楚用户做 XX 时按什么步骤执行。

③ zip 解析失败先对照文档目录结构自查，搞不定发邮件 openworkbuddy@tencent.com 或扫码进开发者群。

因为大多数情况下，我们自己制作的Skill技能，都是让Agent帮我们生成的。比如用WorkBuddy，在WorkBuddy上先安装一个生成技能的skill-creator技能，即可方便我们随时创建技能。

但是，创建好的技能包，你在WorkBuddy开放平台上进行配置上传的时候，就必须得符合以上的规范要求。

好在哪里不规范平台会提示你，你复制提示继续让Agent去根据规范要求修改就行。这点老马在下面的演示中会给大家清楚地展示出来的，不用太担心搞不定。

然后接下来是连接器，也就是MCP。配置连接器的规范要求就稍微有点复杂一些，虽然也只是上传一个压缩包：

但压缩包根据规范要求，是有两种方案可以选择的，具体要求如下：

① MCP + Skill方案（推荐）：有 API 服务就走这条。必备 connector-meta.json + mcp.json + icon.svg；一个连接器只能配一个 MCP Server；远程服务必须 HTTPS（SSE 或 streamableHttp），单请求建议 30 秒内响应，可用性建议 ≥99.9%。

② CLI + Skill方案：已有成熟命令行工具才选。必备 cli.json；至少支持 macOS 和 Linux；必须提供非交互安装 + auth/status/unAuth 命令；认证 URL 要在 10 秒内输出到 stdout；登录态必须跨重启有效（强烈推荐配 Skill 教 AI 用 CLI）。

③ connector-meta.json 硬要求：source 全局唯一（kebab-case）；名称/描述/使用示例中英文齐全（示例各 2-5 条）；用了新字段必须声明 minWorkbuddyVersion。

④ 认证三种路子：MCP自带OAuth（服务端要实现 OAuth 2.1 + PKCE 的 5 个端点）/ 云端托管OAuth（需先和WorkBuddy团队确认）/ 用户自填 Token（auth_mode: “token” + token-schema.json 表单）。

⑤ 红线：任何文件不得写真实密钥、最小权限；图标 SVG建议 64×64透明底。审核通过进市场，更新重新提交审核，10-15分钟生效。

由于配置连接器这块是真得需要有点技术基础的人去操作，所以老马这里也不深入太多。懂技术的开发者，看完文档就知道怎样按规范要求去做了。

05 · HARDWARE

硬件接入与积分兑换

最后是硬件接入和积分兑换的界面，也稍微截图给大家看一眼。应该说从连接器到硬件接入、积分兑换，都不建议非技术人员去操作，确实有一定的知识认知门槛：

除非你真的愿意折腾，或者借助WorkBuddy这类Agent，帮你一步步搞定。普通小白用户搞个开发者，在WorkBuddy开放平台上发布点技能专家啥的，给其它的WorkBuddy用户搜索安装上用用，还是可以的。

至此，WorkBuddy开放平台的管理界面上的功能入口，就给大家介绍完毕了。剩下那个运营数据的页面没啥好介绍的，无非就是对你上传发布的各种技能、专家、连接器啥的资产，提供安装趋势、使用趋势等数据统计。

06 · DOCS

开放文档丢给 WorkBuddy 解读

回到大家最关心的问题，老马是怎么知道上面那些看似很复杂的WorkBuddy开放平台规范要求。答案很简单，因为在首页，就有一个开放文档
open.workbuddy.cn/docs/what-is-open-platform：

开放文档是个好东西，有时候你遇到一个工具或者网站，根本不知道从何下手，如何操作的时候，你就去看看有没有产品文档，或者使用说明文档。

因此，老马把WorkBuddy开放平台的开放文档，丢给了WorkBuddy去解读和总结，总结的意义不只是辅助老马写本文时作为参考资料。

还包括待会老马要去上传发布技能的时候，遇到一些规范要求问题了，可以回到这个会话继续让WorkBuddy，根据已经解读过的文档上下文，帮忙解决问题。

所以，你可以先在WorkBuddy上新建一个任务，把下面的提示词发给它，让它先全面解读和了解WorkBuddy开放平台：

详细了解一下workbuddy开放平台的官方文档：
open.workbuddy.cn/docs/what-is-open-platform，我作为一个开发者，想把自己开发好的技能、连接器、专家、专家团、Buddy应用上传发布到开放平台，又或者根据文档的要求适配自己开发好的技能、连接器、专家、专家团、Buddy应用。请帮我总结一下具体的要求，简单明了，大白话描述，严格遵循官方文档，切忌凭空捏造

07 · IN ACTION

实战：上传 Skill 的三轮报错与修复

解读完毕之后，老马就找了一个前几天使用WorkBuddy制作的token看板Skill，等下上传到开放平台，如图：

这个Skill已经是打包成ZIP压缩包的，因此回到WorkBuddy开放平台的管理界面，点击技能，选择这个ZIP压缩包进行上传，结果马上就报错了：

解析失败的原因是缺少什么版本号，中文展示名等乱七八糟的，一堆红色的失败报错提示。怎么办呢？红色提示右上角是不是有个复制的按钮，点击把这些报错信息复制一下，回到刚才让WorkBuddy解读开放文档的会话。

把Skill的ZIP压缩包上传一下，粘贴刚才复制的报错信息，然后加多一句提示词，就说刚刚在workbuddy开放平台上传之前做的这个token看板的skill技能，提示缺少以下内容：

WorkBuddy收到你的这些报错信息和Skill的压缩包，就会进行修复：

修复完成后，重新打包了一个Skill的ZIP压缩包。老马就把这个新的压缩包，再次去WorkBuddy开放平台的技能配置页面上传一下，结果又报错了：

这次报错的原因是技能的名称被占用了，好家伙，也难怪，WorkBuddy上有那么多的技能，被人抢先使用了名称不奇怪。还是照样复制报错信息，丢给WorkBuddy继续修改：

修改后再次去技能配置页面上传，结果又又又报错了：

这次报错的原因是技能的名称写得不规范，WorkBuddy把名称写成大写字母了。阿西吧，继续复制报错休息，再让WorkBuddy去修改：

这次应该符合规范要求了吧，这来回折腾的。通过解析之后，会进入确认信息，你需要操作的是选择市场展示分类，以及服务类目，头像可上传可不上传：

确认完信息点击继续，就进入了提交审核阶段。审核时间预计需要7个工作日，只能慢慢等待了：

∞ · POSTSCRIPT

写在最后

到这里，老马就给大家完整地演示了一遍，如何注册入驻WorkBuddy开放平台，以及上传发布自己制作的Skill技能。其它的什么专家、专家团、连接器的操作都是差不多的，唯一的区别是规范要求和结构化文件内容不同。

重复提一嘴，Buddy应用、硬件接入、积分兑换这三类的创建是在线的，与技能、专家、专家团和连接器不同，需要一定的技术开发能力，以及现成的软硬件服务基础，非专业人士可以忽略，这不是你的菜。

好了，以上就是今天的分享。欢迎关注、点赞、转发一键三连。有任何问题和需求，请在评论区留言，回见！