摘要：上一篇带你在本地搓好了自己的 Skill，可它只住在你这儿，同事想用还得手动发文件、配 MCP。这篇把「从本地 Skill 到可被别人安装」的通用流程补齐：上架前自查 SKILL.md 是否完整、有没有执行约定、前置条件写没写清；再按平台发布通道打包提交、走人工审核；最后讲用户端装完怎么触发，以及发布后的三步 Checklist。

一、搓好了，但它还只住在你电脑里

上一篇我们搓了一个属于自己的 Skill——一个「老板甩 PDF 合同 → 自动转 Word + 抽表」的东西，本质就是一个 SKILL.md 文件，加上所接的福昕 PDF 转 Word MCP。
上一篇：https://blog.csdn.net/m0_73982863/article/details/163697138?spm=1001.2014.3001.5502

搓完确实顺手，但你很快就撞上一件事：

它住在你这儿。 你想让隔壁同事也用它，现在只能把文件发过去，让他手动存到对应目录、再逐个配一遍 MCP。一个人还行，五个人、十个销售每个人配一遍，这套「专属工具」马上变回「折腾人的工具」。

所以这篇我们把最后这一截走完：以workbuddy平台为例，怎么把这个 Skill 上架，让同事（甚至平台上的陌生用户）像装平台自带 Skill 一样，一键安进来就能用。

二、先把「上架」翻译成人话

上架两个字听起来很开发，其实背后就一件事：把你的本地 Skill，变成别人能在平台里搜索、安装到的东西。

拆开看就三步：

阶段	你要做的事	一句话
上架前自查	检查 SKILL.md 够不够格被拿走就用	别让「你自己用得好」等于「别人也能用」
打包与发布	整理成规范目录，走平台提交	把「你电脑上的文件」变成「库里的东西」
用户端体验	别人搜索安装、配 Key、开用	好装、好配、好触发
发布后	自测、登记、收集反馈	别发完就撒手不管

翻译通俗点：你要先把 Skill 整理到「别人拔来就能用」的份上，再交到平台手里，平台审核后变成可安装项。这篇按这个顺序捋。

三、上架前自查：别人「拔来就能用」吗

你自己用，出问题能自己补；别人用，他没你那份上下文。所以上架前，把 SKILL.md 当一份「接手续包」来验收，四件事过一遍。

① YAML 头完整吗

name / description / 触发词（keywords + patterns）缺一不可。缺了 name 系统认不出它是哪个 Skill；description 写得含糊，AI 不知道该不该调它；触发词不写，用户说了半天也戳不中。这段话是 Skill 的「身份证」，一个都不能少。

② 执行约定写清了吗

「先说流程图：传 PDF（≤100MB）→ 建任务 → 每 3000ms 轮询最多 60 次 → 下载 → 回原目录」这类步骤约定，要写成 AI 照着走就能走通的程度。千万别只写「把 PDF 转成 Word」七个字——那是描述，不是执行约定。

③ 前置条件写清了吗

这是最多人忽略、也最容易让用户卡住的一环。别默认别人懂：

• 福昕 PDF 转 Word MCP（服务名 foxit-pdf365-mcp-server）要不要先接好；
• API Key（格式 pdf365_mcp_xxxxxxxx，前缀 pdf365_mcp_ 不可分割）从哪申请、怎么填。

把这些前置写进 SKILL.md 的「前置条件/准备」里，用户第一次用才能不卡壳。具体可参考福昕官方 Skill 文档里 How Key 是第一步必须检查的设计。

四、打包与发布：按通用流程提上去

自查过了，就该把它变成「能分发的东西」。

① 整理成规范目录

一个 Skill 不只是单一个文件，把外围东西一起码整齐：

目录项	放什么	示例
SKILL.md	主文件，身份 + 触发 + 执行约定	上一篇那套
scripts/	可能需要跑的辅助脚本	转换脚本、过滤脚本
references/ 或 docs/	参考文档、说明	接口表、Key 申请指引
resources/	图标、模板等静态资源	封面、示例模板

一句话：让接手的人一眼能懂这套东西怎么跑，别把脚本、文档、说明全堆在根目录一个 SKILL.md 里。

一个「示意图/通用范式」的规范包长这样（文件仅为示意，字段以你实际 Skill 为准）：

my-contract-to-word/
├── SKILL.md            # 主文件：name/description/触发词/执行约定
├── scripts/
│   └── extract_table.py   # 可选的辅助脚本
├── references/
│   └── KEY_GUIDE.md       # Key 申请与填法说明（前置条件）
└── resources/
    └── icon.png           # 图标等素材

把这份结构交给平台，别人打开能看到「怎么装、怎么配、怎么跑」的完整线索，而不只是一坨散文件。

② 按平台规范提交

不同平台发布 Skill 的入口、字段、规范不一样，但动作是同一套：

1. 到支持发布 Skill 的平台，找到对应的「提交 / 发布 Skill」入口；
2. 填标题、简介、分类、触发词预览等元信息；
3. 上传skill安装包；
4. 按平台规范等待审核，审核通过后线上。

具体我们以workbuddy为例，如果希望你的skill在workbuddy被搜索，那么需要把skill上架到腾讯的skillhub。
1、访问skillhub.cn，点击右上角发布团队skill

2、选择发布类型（以免费版为例）

3、上传skill问题件，并且填写基本信息，点击发布skill，等待审核结果

4、审核分为：平台的安全审核->如果是企业账号管理员审核

5、审核通过后，在【技能列表】选择上架即可

6、发布后，就可以在workbuddy里的技能入口，搜索到你的上架的技能了

五、用户端体验：别人装完长什么样

上架成功后：

1. 搜到：用户在平台的 Skill 列表里搜到你的 Skill。
2. 安装：点安装/启用，导入到自己的环境。
3. 配 Key：第一次用被引导去申请并填入福昕 PDF 转 Word 的 Key（pdf365_mcp_ 开头，在 pdf365.cn/skill_key 申请）。
4. 开用：装完就能用了。用户一命中触发词——比如说「把合同 PDF 转成 Word」或「pdf转word」——Skill 就被自动调起，按执行约定把活干完（传 PDF → 建任务 → 轮询 → 下载 → 回原目录）。

也就是说，用户在价值上体验不到你上架时操的那些心：他只觉得「装了个 Skill，说句话就能把 PDF 转成 Word」。你前前后后的功夫，最终换来的是用户一行字。

六、发布后 Checklist：3 件事，别发完就撒手

上线不是终点，是不监测的开始。发布后至少把这三件办踏实：

#	做什么	为什么
1	跑通自测	上线初期自己完整走一遍：装、触发转换、收结果，确认没漏
2	登记版本	给 Skill 记个版本号、发布日期，后续迭代能对账
3	收集反馈迭代	看用户怎么用、哪里卡；把高频诉求回写进 SKILL.md 再发新版本

很多 Skill 死在发布即失手：没人回访、触发词没覆盖到真实用户说话的习惯、Key 配置没写清。这三个动作，就是让 Skill 从「上架了」到「真有人用」。

七、小结：系列收官

第一篇教你搓：Skill 的本质就是一份 SKILL.md（name / description / 触发词 / 工作流约定），再接一个福昕 PDF 转 Word MCP 让它能干真活，然后把描述、触发词、工作流改成你自己的。

第二篇教你发：上架前自查完整性，整理成规范目录，按平台通用通道提交审核，用户端装完配个 Key 就能用，发布后再跑通 / 登记 / 收反馈。

底子从头到尾是一条：福昕 PDF 转 Word MCP（服务名 foxit-pdf365-convert，接入 foxit-pdf365-mcp-server / streamableHttp / open.pdf365.cn / X-API-KEY，Key 前缀 pdf365_mcp_ 不可分割）。有这份底子打底，办公人就算不太会写代码，也照着手把手搓一个自己天天用、还能分给大家装的工具。

别再只当「AI 的使用者」了——从一份 SKILL.md 开始学习，你自己也能当「AI 工具的搭建人」。

---

FAQ

Q1：Skill 有背景要「上架」，是什么意思？
A：把本地的一份 SKILL.md（连同相关文件）整理成规范包，提交到支持发布 Skill 的平台，经审核上线后，变成别人能在平台里搜索、安装的东西。一句话：从「你电脑里的文件」变成「大家能装的库」。

Q2：上架前要自检哪几样？
A：三样：① YAML 头完整（name / description / 触发词 keywords+patterns）；② 执行约定写清，AI 能照着跑完；③ 前置条件写清，比如福昕 MCP 服务名与 API Key 从哪申请（pdf365_mcp_ 前缀不可分割）。

Q3：福昕 PDF 转 Word MCP 的前置是什么？
A：需要先接好 foxit-pdf365-mcp-server（streamableHttp，https://open.pdf365.cn/mcp），并准备 API Key（格式 pdf365_mcp_xxxxxxxx，在 pdf365.cn/skill_key 申请，前缀 pdf365_mcp_ 不能省）。首次调用必须检查并配置好 Key。

Q4：什么是「按平台通用频道提交」？
A：指填好元信息（标题/描述/分类/附件）上传 Skill 包，走平台人工审核、审核通过后上线。本文以workbuddy为例——但各家细节不一致，以平台官方发布文档为准。

Q5：用户装完怎么才能用起来？
A：用户在平台「安装/启用」该 Skill，导入后按引导填一次福昕 PDF 的 API Key，之后只要说触发词（如「把合同 PDF 转成 Word」「pdf转word」）就会自动调起，按上传→建任务→轮询（每 3000ms、最多 60 次）→下载→回原目录的流程跑完。

Q6：发布后要做哪三件事？
A：跑通自测（自己完整装一遍并转换）、登记版本（版本号 / 日期一记下）、收集反馈迭代（把高频请求回写进 SKILL.md）。这三件事让 Skill 从「上线了」变成「真有人用」。

---

标签：办公自动化 Skill WorkBuddy MCP PDF转Word