摘要：模板给的 Skill 总差一口气，真正顺手的工具得自己搓。本文不绕弯子，讲清三件事：Skill（技能包）的本质就是一个 SKILL.md 文件，靠 name / description / 触发词 + 工作流约定把自己封装出来；再接入福昕 PDF 转 Word MCP（服务名 foxit-pdf365-convert），搓一个「老板甩 PDF 合同 → 自动转 Word + 抽表」的日常专属 Skill；最后教你怎么在描述、触发词、执行约定里加自己的诉求。全程通用范式、零虚构，配 YAML 示例与 MCP 配置，文末埋了续篇。

一、模板给不了你「顺手」

先对号入座。你是不是也这样：从平台装了一堆 Skill，用起来总觉得差口气——那个报错脚本的，没按你的格式输出；那个能做表格的，触发词老对不上你说话的方式；你想给它加一句「合同抽关键条款」，翻遍设置也没地儿写。

原因是这些 Skill 是别人搓给你用的。它照顾的是大多数人的普遍场景，不会专门迁就你手上那堆活儿。可你的痛点偏偏最私人：你天天在转合同 PDF，你那句「把老板甩来的 PDF 转成 Word 顺便抽个表格」，就是你的高频动作，别人没这份需求模板，当然覆盖不到。

这就是很多人没想通的一层：Skill 不一定要靠别人给，自己也能搓一个，而且搓出来的才是真正贴合你日常的。

这篇就拿福昕 PDF 转 Word MCP（服务名 foxit-pdf365-convert）当底子，手把手带你把一个「转合同 + 抽表格」的专属 Skill 搓出来。Skill 本身的写法用通用范式讲，保证你在别的平台也能照做。

二、先把「Skill 到底是个啥」说清

这是全文唯一绕不开的概念，讲清一次，后面全是动手。

Skill（技能）是指 WorkBuddy 这类 Agent 办公/开发平台上，一种可重复使用、随装随用的「能力包」：把「某个能力 + 它的一句自然语言描述 + 什么话能触发它 + 该怎么做的工作流」打包成一份文件。AI 装上它，遇上对应场景就自动调起来，完成对应任务。

大白话：Skill 是写给 AI 的一段「说明书」——它不一定要带复杂代码，核心是那份「规定」。AI 遇到符合触发词的话，就照着执行约定帮你把它干了。

它的实体，通常就是一个文件：SKILL.md。往里写清楚这四个部分，一个 Skill 的框架就立起来了：

写什么	是什么	有什么用
name	Skill 的名字（服务名）	让 AI / 系统识别它是谁
description	一段自然语言的能力描述	决定 AI 什么时候该想起来用它
触发词	keywords + patterns	用户说到什么，就是叫它上岗
执行约定	工作流 / 步骤 / 前置条件	规定它具体怎么干、先干哪步

而 Skill 底下要真的把「活」干出来，常常还要接一个 MCP。MCP（Model Context Protocol，模型上下文协议），你可以理解成「AI 的 USB 接口」：定一套标准协议，各种外部工具即插即用，AI 不用给每个工具单独写对接代码。一句话记住：Skill 是「能力包」，MCP 是它调用外部工具的那根「插座」。

三、先看真的：福昕 PDF 转 Word 的 SKILL.md 长什么样

既然说「一个 Skill 就是一个 SKILL.md」，那最直观的办法，是拆一份真实存在的给你看。下面这份以福昕官方 foxit-pdf365-convert/SKILL.md 为蓝本：

---
name: foxit-pdf365-convert        # Skill 名，服务名
description: PDF 转 Word 文档格式转换
metadata:
  version: 1.1.x
  author: Foxit
---
# 触发词（keywords）
keywords:
  - pdf转word
  - pdf to word
  - pdf to docx
  - pdf convert

# 触发条件（patterns，正则）
patterns:
  - "(pdf|PDF).*(转|convert|转换).*(word|Word|docx|doc|文档)"

# 执行约定（简化示意）
工作流：
  1. 检查本地 API Key 是否存在
  2. 让用户提供 PDF（≤100MB）
  3. 上传 → 建任务 → 轮询（每 3000ms，最多 60 次）
  4. 下载结果，返回原文件目录

注意拿到这份文件，你其实已经握住了 Skill 的全部骨架：身份（name/description）、触发（keywords/patterns）、干活（执行约定）。剩下三件具体的事——怎么接福昕 MCP、怎么改造成自己的——下面挨个来。

四、接入福昕 PDF 转 Word MCP

Skill 的「魂」在触发与流程，但要真的把活干出来，得让它能调到转换服务。这一步就是接 MCP。

福昕这个服务名是 foxit-pdf365-mcp-server，接入方式 streamableHttp，接入地址 open.pdf365.cn，认证走 X-API-KEY 请求头。Key 的格式是 pdf365_mcp_xxxxxxxx，注意 pdf365_mcp_ 是不可分割的前缀，漏了或截断，直接认证失败。

一份可用的 MCP 配置（示意/通用范式，把 Key 换成你自己的 pdf365_mcp_ 开头的真实 Key）：

{
  "mcpServers": {
    "foxit-pdf365-mcp-server": {
      "type": "streamableHttp",
      "url": "https://open.pdf365.cn/mcp",
      "headers": {
        "X-API-KEY": "pdf365_mcp_xxxxxxxx"   // [示意/需替换] 你的真实 Key，前缀 pdf365_mcp_ 不能改
      }
    }
  }
}

服务名按官方写法是 foxit-pdf365-mcp-server，Key 前缀是 pdf365_mcp_，且绝不省略。

接上之后，一次 PDF 转 Word 的完整闭环长这样：

1. 传 PDF：≤100MB，作为 file 传上去；
2. 建任务：调 createConvertTask(fileUrl, "PDF_2_WORD")，拿到 taskId；
3. 轮询：调 getConvertTaskStatus(taskId)，每 3000ms 查一次、最多 60 次，等 state=FINISH && success=true；
4. 下载：调 downloadConvertResult(taskId)（只传 taskId），有额度就返回下载链接，没额度会让用户去支付页；
5. 回目录：把结果写回原 PDF 所在目录（如 ~/Desktop/报告.pdf → ~/Desktop/报告.docx）。

这套就是「老板甩 PDF → 自动转 Word」的底层全部。你自己搓的 Skill，只要把这一套流程约定写进 SKILL.md「执行约定」里，AI 就会照着串。

五、改造成你自己的：三处加诉求

接上了，还要让它「长成你的样子」。改三个地方就行，成本极低：

① 改 description——让它知道「该想起你」

你把福昕的 description「PDF 转 Word 文档格式转换」扩成你自己那套，AI 才知道什么时候调用你：

• 「把老板发来的 PDF 合同转成 Word，并尽可能保留表格」
• 「处理销售部日常的 PDF 报价单、合同扫描件」

描述写得越像你的日常，AI 越会在「对的时候」想起来用它，而不是装了一堆 Skill 却没一个出场。

② 改触发词——让它听得懂你说的话

你天天怎么说的，就怎么加。官方已带 pdf转word、pdf to word、pdf to docx 等通用词（来源：福昕官方 SKILL.md）。你可以再补几个你的「黑话」：

keywords:
  - 合同转word
  - 报价单转word
  - 把合同转成可编辑
patterns:
  - "(合同|报价单|文件).*(转|转换).*(word|可编辑)"

这样你以后随口一句「把这份合同转成能改的」，就能命中，而不是必须打字「pdf to word」。

③ 改执行约定——把你的流程「钉」进去

福昕默认是「转 Word → 返回原目录」。你要是想要「转 Word + 顺手抽表」，就在执行约定里补一条，例如：

- 4. 下载结果，返回原目录
   - 4.1 额外：用表格/数据提取思路，把 Word 里各表格的标题与关键列抽出来，整理成一段文字摘要

一句话总结它的诀窍：Skill 长得像你的，才是你的——描述写你的场景，触发词说你的黑话，工作流加你的步骤。三步大约五分钟，一套专属工具就落地了。

六、几个坑提前踩平

• pdf365_mcp_ 别手滑：它是不可分割部分，漏了直接认证失败；
• 轮询别写死循环：官方节奏是每 3000ms 一次、最多 60 次，大文件耐心等，别疯狂打接口；
• SKILL.md 的 YAML 头别乱：缺 name / description，Agent 可能都认不出这包 Skill；
• 敏感文档优先本地处理：合同、标书这类，优先选自己能掌控处理路径的方案。

七、小结（＋下一篇预告）

这篇带你把三件事走完了：Skill 的本质只是一份 SKILL.md（name / description / 触发词 / 工作流约定）；接一个福昕 PDF 转 Word MCP 让它能真正干活；再在描述、触发词、执行约定里塞进你自己的诉求，搓出专属工具。

可这里有个卡点：你搓的 Skill 住在你这一个 SKILL.md 里，你同事、你小组里的其他人，要怎么才能一键也装上它？ 总不能把文件挨个发过去、让每人手动配一遍 MCP。

所以下一篇，我接着教你把这一步走完——手把手把你自己搓好的这个 Skill 上架到 WorkBuddy，让同事能像装平台自带的一样直接安进来https://blog.csdn.net/m0_73982863/article/details/163700202?spm=1001.2014.3001.5502。等它上了架，你那份「合同 PDF 自动转 Word + 抽表」的专属技能，才算真正从「你一个人的」，变成「一群人随用随装的」。

---

FAQ

Q1：Skill 到底是什么？
A：Skill（技能）是各类 Agent 办公/开发平台上的可重复能力包，本质是一个 SKILL.md 文件，包含 name、description、触发词和执行约定，让 AI 用一句自然语言就调起来。可以理解成「给 AI 装的能力补丁」。

Q2：Skill 和 MCP 是什么关系？
A：MCP（Model Context Protocol，模型上下文协议）是 AI 与外部工具之间的标准协议，相当于「USB 接口」；很多 Skill 底层通过 MCP 去调用外部服务。所以 Skill 是「能力包」，MCP 是它调外部工具依赖的协议层。

Q3：Skill 的 SKILL.md 里要写哪几块？
A：四个块：name（名字）、description（能力描述）、触发词（keywords + patterns，决定 AI 何时调用）、执行约定（工作流 / 步骤 / 前置条件）。写全这四块，一个 Skill 的框架就立住了。

Q4：福昕 PDF 转 Word MCP 怎么接入？
A：服务名 foxit-pdf365-mcp-server，接入方式 streamableHttp，地址 https://open.pdf365.cn/mcp，认证头 X-API-KEY，Key 格式 pdf365_mcp_xxxxxxxx，前缀 pdf365_mcp_ 不可切割。支持多种客户端，配置后重载 MCP 生效。

Q5：PDF 转 Word 的调用流程是什么？
A：上传 PDF（≤100MB）→ createConvertTask(fileUrl, "PDF_2_WORD") 建任务拿 taskid → 每 3000ms 轮询 getConvertTaskStatus(taskId) 最多 60 次 → downloadConvertResult(taskId) 下载 → 结果回到原 PDF 目录。

Q6：想把这个 Skill 改成自己的，改哪几处？
A：三处：① description 改成贴合你业务的描述；② 触发词（keywords/patterns）加你自己的「黑话」或业务词汇；③ 执行约定里加你要的额外步骤（比如转 Word 后顺手抽表格）。三处改完，它就从通用的变成你专属的。

---

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