QUOTE
把自己做好的 Skill 传上商城——流程不复杂, 跟着走一遍基本就会。
—— 扣子
今天分享一下,我是怎么把自己做好的 CNKI-SKILLS 上传到 WorkBuddy 的 Skill 商城的。整个流程不复杂,跟着走一遍基本就会。这篇把每一步和几个容易卡住的地方都写清楚。
本文看点
01
开发者账号
02
打包两坑
03
上架之后
01
DEVELOPER ACCOUNT
开发者账号:建议直接用 WorkBuddy 账号注册
入口是 WorkBuddy 开发者开放平台(open.workbuddy.cn)。点登录,第一次使用需要先完成开发者账号的注册和认证。
我的建议是:直接用你自己的 WorkBuddy 账号注册。这样注册完成后会自动关联到你的 WorkBuddy 账号,后面管理 Skill、看数据都方便很多。
认证完成后进入后台,找到发布管理。平台支持发布的内容类型不止一种——应用、专家、Skill、连接器都在里面。我们这次选 Skill。
02
PACKAGING
打包:3MB 是硬限制,还有一件更重要的事
点「创建」,然后把你写好的 Skill 打包成 ZIP 上传。这里有两个坑:
坑 1:体积。压缩包不能超过 3MB。如果你的 Skill 里有比较大的图片、文档或资源文件,上传前一定要先检查大小。
坑 2:敏感信息。打包前请务必清掉 API Key、密码、Cookie 这类只属于你自己的东西——它们一旦被打进包里,上架后就等于公开了。这是比 3MB 更值得停下来检查的一步。
附:官方要求的包结构
{skill-name}/
├── SKILL.md # 技能定义(必须)
├── references/ # 参考资料(可选)
├── scripts/ # 可执行脚本(可选)
└── templates/ # 模板文件(可选)
要点:目录最多两个层级;SKILL.md 用 YAML frontmatter + Markdown 正文,其中 description、description_zh、description_en、version、author 是必填。
顺带说一句:description 里把触发词写清楚,别偷懒。它直接决定两件事——用户在商城里能不能搜到你,以及 AI 会不会在合适的场景自动调起你。
03
SUBMIT & REVIEW
填信息、提交、等审核
上传完成后填写基本信息:名称、分类、相关介绍。填完直接提交审核。
之后就进入审核状态。按我这次的经验,审核大概 3 天(官方口径是 1–3 个工作日,具体以后台实际进度为准)。无论通过与否,平台都会通过邮件把审核结果发给你,所以提交之后记得看邮箱。
如果上传后提示解析失败,先按上面的包结构和目录层级逐项排查;定位不到问题,可以发邮件到 openworkbuddy@tencent.com 找运营同学。
04
AFTER LAUNCH
上架之后:不是结束
审核通过后,你的 Skill 就上架到 WorkBuddy Skill 商城了。其他用户的路径是:WorkBuddy 左侧【专家·技能·连接器】→【技能】→【技能市场】,搜索到你的 Skill,点右上角加号安装,然后在对话里直接调用。
发布之后还能继续做两件事
迭代:加新功能、升版本,都在同一个开发者后台更新和管理;
看数据:有多少用户在使用、相关的运营数据,也都能在后台直接查看。
∞
EPILOGUE
写在最后
如果你自己也做了一些顺手的 Skill,不妨上传到 WorkBuddy 的 Skill 商城试试。它不只是「给别人用」——对你自己来说,商城也是一个现成的分发和更新通道,不用再手动发压缩包给别人。
END
我是扣子,一个热衷于把 AI 真正用进科研的人。
关注「扣子说AI」,持续分享能帮科研提效的 AI 工具和玩法。

