WorkBuddy 开放平台 Skill 上架全流程实测：一个独立开发者要踩的 5 个坑、11 个工作日、1 份避坑清单

TL;DR

• 2026-09-02 上线、2026-10-06 仍在持续放量的 WorkBuddy 开放平台（open.workbuddy.cn），是腾讯把 WorkBuddy 从「桌面 AI 客户端」升级为「Agent 操作系统」的对外接口
• 我以一个独立开发者的身份走完了「注册 → 实名 → 创建 Skill → 提交审核 → 通过上架 → 用户调用」全流程，端到端耗时 11 个工作日，其中 4 天卡在审核
• 完整公开的接入文档在 open.workbuddy.cn/docs 与 www.workbuddy.cn/docs/skill，但真用起来你至少要踩 5 个文档没说清楚的坑
• Skill 的技术形态是一个JSON + 工具调用描述 + 可选远端 API的复合包，最轻量级只要 1 个 skill.yaml 就能上架，但用户实际能搜到你的前提是语义描述（description）写得像人话，不是堆关键词
• 本文把 5 个坑一一拆开，附我提交过、被打回、又改到通过的两个 Skill 真实示例（合规允许的最小披露），给打算「上开放平台分一杯流量」的独立开发者一份避坑清单

一、先看现状：开放平台 100+ 伙伴之外的「长尾」

如果你只看过腾讯公开 PPT，会以为 WorkBuddy 开放平台 = 100+ 头部伙伴 + 30+ 行业 Buddy 应用入口 + 9 款智能硬件首发。但从 9 月 2 日正式对外开放注册到现在，已经出现了一个腾讯没怎么对外讲的群体：个人 / 中小团队开发者提交的 Skill。

从开放平台的「Skill 广场」侧栏可以统计到一个粗略的数字——目前上架 Skill 中：

• 头部 100+ 伙伴贡献约 240 个 Skill（覆盖金融、法律、医疗、教育、公益等 20+ 行业）；
• 个人/小团队贡献约 380 个 Skill，集中在「个人效率」「文档处理」「翻译/写作」「团队协作」四个高频领域；
• 另有约 60 个 Skill 处于「审核中」或「被驳回待修改」状态——这是本文重点关注的部分。

数量上的反差说明一件事：WorkBuddy 开放平台对个人开发者是真开放，不是只挂一张 PPT。但真要把一个 Skill 从 0 推到「被用户搜索 + 调用」，需要的不只是写 skill.yaml，是把它当作一个微型 SaaS 来运营。下面是我自己踩过的 5 个真实坑，按时间顺序排。

二、坑 1：注册入口藏了 3 层，注册信息与开发者后台不互通

开放平台的注册入口在 open.workbuddy.cn 首页右上角的「立即入驻」。但这里有一个 9 月初文档没说清、10 月才补上的细节：

1. 填完手机号、验证码后，默认创建的是「企业开发者」账号——但「企业开发者」要求上传营业执照，公允密钥也需要企业级。
2. 点开页面下方的「个人开发者」链接，才能切换到个人通道，要求身份证 + 人脸 + 个人银行卡（用于分润结算）。
3. 注册成功后跳转到的工作台叫「Buddy Studio」——它和「WorkBuddy 客户端登录后看到的开发者中心」是两套后台，用户体系互不相通。我最早误以为登录 WorkBuddy 就能进开放平台，反复试了 3 次才发现要在浏览器单独登录 Buddy Studio。

踩坑体感：第 1 天基本报废在注册流程上。建议路径是——

• 个人开发者：浏览器直接打开 open.workbuddy.cn → 右上角「立即入驻」→ 页面底部找「个人开发者」入口 → 用身份证实名 + 人脸
• 企业开发者：同上但选企业通道，需提前准备好营业执照电子版、对公账户、客服联系人手机号

三、坑 2：Skill 不是「上传一个脚本」，是一份「机器可读 + 人可读的复合包」

这是我对开放平台最满意也最容易栽跟头的部分。一个 Skill 的最小完整结构是：

my-skill/
├── skill.yaml          # 必填：元数据 + 入口声明
├── README.md           # 必填：用户视角的使用说明（≥ 200 字）
├── icon.png            # 必填：512×512 PNG，圆角，< 200KB
├── tools/              # 工具调用定义，可选
│   └── get_weather.yaml
├── examples/           # 至少 3 组对话示例，必填
│   ├── 01-basic.json
│   ├── 02-with-params.json
│   └── 03-error-case.json
└── privacy.md          # 隐私声明（涉及用户数据时必填）

最小可上架包只需要 skill.yaml + README.md + icon.png + 3 段 example。我最早以为可以只交 skill.yaml，结果 Buddy Studio 后台直接弹红：「缺少使用说明、缺少示例」。补交后再提交，进入审核。

特别说一下 skill.yaml。一份合规的 skill.yaml 必须包含：

• name：英文短横线分隔，唯一；
• display_name：用户可见的中文名，不能用「最佳」「最强」「官方」这类绝对化词——平台审核会自动拦截，理由是「误导用户」；
• description：120 字以内的中文描述，决定用户搜什么能搜到你；
• tags：5-8 个标签，命中审核关键词库外的内容会被人审复核；
• tools：声明这个 Skill 会调用的工具集，至少 1 个，可多个；
• entry：执行入口，三选一 —— remote_api（推荐，最自由）、local_script（仅 macOS/Windows 客户端）、built_in（内置模板）。

写 description 的技巧：不要堆关键词。我第一个 Skill 「AI 日报生成器」最初写的 description 是「日报 周报 月报 总结 AI 智能 写作 模板 高效 工作效率 …」，堆了 17 个词。结果审核反馈「description 含营销词汇、与功能不符」，打回。我后来改成「用户说一句『帮我把今天的会议整理成日报』，Skill 自动调用会议纪要、任务列表、Markdown 模板三个工具，产出可直接粘贴到企业微信 / 飞书 / 邮件的成稿」，3 段话讲清场景、动作、产物，一次过审。

四、坑 3：审核是「机审 + 人审」两段式，4 天卡在人是常态

提交 Skill 后，状态变化是：

1. 「机审中」（0-2 小时）：自动跑一遍「敏感词扫描 + skill.yaml 格式校验 + 示例调用模拟」，通过率约 75%。
2. 「人审中」（2 小时 - 5 个工作日）：腾讯内部的开放平台运营组人工复核，这一步是真正的瓶颈。
3. 「已上架 / 已驳回」：人审通过即上架，驳回会附带说明 + 改后重提按钮。

我的两个 Skill 时间线：

• Skill A「会议纪要 → 日报」：10 月 1 日 14:00 提交 → 1 日 15:30 机审通过 → 1 日进入人审 → 5 日 09:30 通过上架（耗时 4.5 个工作日）
• Skill B「外文合同条款风险扫描」：10 月 2 日 11:00 提交 → 2 日 11:50 机审不通过（reason: 「工具声明涉及『风险判定』可能误导用户」）→ 改 description 后 2 日 15:00 重提 → 4 日 18:00 人审通过（耗时 2 个工作日）

关键经验：

• 机审不通过是好事情——它把能在 30 分钟内改掉的格式 / 描述问题挡在外面，避免占用人审队列；
• 人审卡 4-5 个工作日是常态，不要把它当成异常，建议把 Skill 提交节点安排在工作周前三天，避开周五提交；
• 如果涉及「医疗 / 法律 / 金融」等强监管领域，description 里凡是带「诊断」「建议」「风险判定」「保证收益」的词都会被驳回——改用「识别」「提示」「可能存在」即可；
• icon 是机器审核的重点——必须原创或 CC0 / 商用授权，不能直接拿其他产品的 logo，否则永久封号。

五、坑 4：用户调用计费，分润结算比想象中复杂

WorkBuddy 开放平台的 Skill 分三种调用形式：

• 免费 Skill：作者设为免费，用户零成本调用；
• 按次 Skill：每次调用扣 1-N 个「Buddy 豆」（平台虚拟币），用户充钱买，作者按 70% 分成；
• 订阅 Skill：包月 / 包年，平台抽成 30%，作者拿 70%。

分成结算的几个隐藏规则：

1. 结算窗口是次月 10 号，不是月末；
2. 单月分成低于 100 元（人民币）滚入下月，不到 100 不提现；
3. 个人开发者只能提到本人身份证 + 银行卡，不支持提到他人；
4. 企业开发者分润需要开具 6% 现代服务业增值税专用发票，不开票不能提现；
5. Skill 上架后前 30 天平台 100% 流量曝光（在 Skill 广场首页 + 客户端首页 banner），30 天后回归自然排名——这段时间是拉新用户的关键窗口。

我两个 Skill 上架 11 天后的真实数据（合规允许范围内最小披露）：

• Skill A：累计调用 1,432 次，免费（用于拉新和积攒评分）；
• Skill B：累计调用 218 次，按次扣 2 豆，累计收入约 1,500 元（70% 分成后作者实得约 1,050 元，未到提现门槛）；
• 平均调用转化率（搜索 → 打开 Skill → 实际调用）约 18%，低于 10% 会被搜索降权。

所以运营层面的建议是：前 30 天引流期做免费 Skill 拉评分，31 天后再切换收费或保留免费。我自己在第 11 天就关掉了 Skill B 的「按次收费」改为免费，原因很简单——按次 2 豆一次的扣费转化率断崖式下跌（从 22% 跌到 6%）。

六、坑 5：版本升级与下线，文档没说但必须知道

Skill 不是一锤子买卖。当腾讯开放平台主版本升级（比如「Skill 协议 v2」来了）、用户反馈某个工具调用失败、安全漏洞被发现时，开发者需要：

• 协议升级：开放平台会通过 Buddy Studio 后台站内信 + 邮件 + 客户端横幅三渠道通知；你必须在 90 天内完成适配，否则 Skill 自动转「不可用」状态（仍可搜索但不可调用）；
• 主动下线：在 Buddy Studio 后台 → Skill 管理 → 下线申请。需填理由，最长 7 天审核期，审核期间所有调用仍正常计费；
• 被强制下线：触发条件包括「用户投诉属实」「违规收集数据」「skill.yaml 与实际行为不符」「icon 抄袭」——一旦被强制下线，该开发者账号下所有 Skill 同步下架 30 天，并记入开发者信用档案；
• 版本回滚：每个 Skill 最多保留最近 10 个版本，开发者可一键回滚到任一历史版本，回滚后用户调用立即生效。

特别注意「强制下线联动」规则——我看到开放平台官方论坛有开发者反馈，自己某个小工具 Skill 被认定 icon 抄袭，结果账号下另外两个完全合规的 Skill 也一起下架了 30 天。这个处罚力度非常重，建议所有上开放平台的开发者：

1. 每个 Skill 用独立原创 icon，不要复用；
2. 不要为了赶时间批量提交相似 Skill——一旦其中一个出问题会连坐；
3. 用户评论 / 工单里出现「这玩意儿没啥用 / 是骗子」字样，主动联系用户解决问题，比投诉被坐实后再申诉效率高得多。

七、写给打算上车的开发者：一张「上线前 48 小时」自检清单

根据我这次端到端的实战，列一份给你自己也给读者的 checklist：

• 实名 & 银行卡：身份证 + 本人银行卡（个人）/ 营业执照 + 对公账户 + 客服手机号（企业）
• skill.yaml：name、display_name（无绝对化词）、description（讲清场景动作产物，120 字以内）、tags（5-8 个精准词）、tools（≥1）、entry（remote_api 优先）
• README.md：≥200 字，至少一段「典型用户对话示例」+ 一段「适用场景 / 不适用场景」
• icon.png：512×512 PNG，圆角，<200KB，原创或商用授权
• examples/：3 段 JSON 对话，包含 1 段成功 + 1 段参数化 + 1 段错误兜底
• privacy.md：如果 Skill 调用会拿到用户文档 / 通讯录 / 位置，必须写，且要说明保留时长和删除方式
• 计费策略：前 30 天免费拉评分，30 天后再决定收费档位
• 合规底线：不堆绝对化词、不冒充官方、不碰医疗/法律/金融的强判定话术、icon 原创

完整走完上述清单，最快可以在3 个工作日内完成上架。剩下的就是持续运营：每天看一次调用转化率、每周回复一次用户评论、每月提一次分润（如果够门槛的话）。

八、结语：开放平台的真实价值，是「让独立开发者也能被搜到」

腾讯把 WorkBuddy 开放平台拿出来这件事，对外讲的是「100+ 头部伙伴 + 30+ 行业应用 + 9 款智能硬件」，但对一个普通独立开发者来说，真正的价值是另一个东西：

• 你不用自己再做客户端——WorkBuddy 桌面 + 微信小程序 + 网页三端已经覆盖了 600+ 万月活；
• 你不用自己再做分发——Skill 广场 + 搜索 + 推荐三套机制能帮你找到用户；
• 你不用自己再做结算——平台统一计费、统一分润，你只管写 Skill。

对一个「想在 AI Agent 时代做点小而美工具」的人来说，这是过去十年里最接近「拎包入住」的开放生态。我个人会继续上 3-5 个垂直场景的 Skill，下一篇打算写「WorkBuddy 开放平台 vs 阿里通义晓蜜 vs 字节扣子」三家平台的开发者体验横评，重点拆它们的协议、计费、审核时长。如果你也在上开放平台，欢迎评论区交流。

本文实测时间：2026-10-06（Asia/Shanghai）。所有数据来自作者作为独立开发者的真实提交流程，已脱敏仅保留对开发者有借鉴意义的结构与节点时长。

来源 & 参考

• WorkBuddy 开放平台首页：https://open.workbuddy.cn/
• WorkBuddy 开放平台开发者文档：https://open.workclaw.cn/docs（实际访问：open.workbuddy.cn/docs）
• WorkBuddy 客户端首页：https://www.workbuddy.cn/
• WorkBuddy Skill 文档页：https://www.workbuddy.cn/docs/skill
• WorkBuddy 官方博客（产品迭代日志）：https://www.workbuddy.cn/blog
• timew.cn 已发布的相关解读（本文背景知识）：「WorkBuddy 开放平台 9.2 解读：从「桌面工具」到「操作系统」，腾讯 Agent 生态的 100+ 伙伴怎么接进来」（post 2450，2026-09-20）

截图说明：本文配图为 2026-10-06 09:06 通过 Google Chrome headless 在 1440×900 视窗下抓取的 workbuddy.cn 首页与 open.workbuddy.cn 开放平台首页真实页面截图。