
## 起点：一个简单的 Word 转换需求

故事要从一次日常工作说起。

那天我写完一份 Word 报告，领导突然说「发我一份 PDF 版本」。我打开 Word，点了导出，选了格式，保存到指定目录... 看起来很简单对吧？

但如果这样的需求每天出现三五次呢？如果文件分布在不同的目录呢？如果要批量处理十个文件呢？

于是我开始思考：**能不能让 AI 帮我做这件事？**

### 第一次尝试：在 WorkBuddy 中实现 Word 转 PDF

WorkBuddy 是 AI 原生的桌面智能体工作台，理论上它可以帮我写代码、执行脚本。我试着提了一个需求：

```
帮我把这个word文档转成 PDF
```

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/b1905c1c335cc037ef69fcd68bbc02ef.png' width=100%>

AI 很快给我写了一个 Python 脚本，使用 Windows COM 接口调用 Word 进行转换。脚本跑通了，问题解决了。

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/6641c2fb9aecd03eb6bdbbd0572c766d.png' width=100%>

但很快我又遇到了新问题：PDF 转 Markdown 怎么办？Markdown 转 Word 呢？每次都要重新解释需求、重新生成脚本？

这时候我意识到：**需要把这些转换能力「固化」下来。**

## 进阶：封装成标准 Skill

WorkBuddy 提供了一个强大的机制 — **Skill（技能包）**。

Skill 本质上就是把「工作流程 + 工具脚本 + 使用说明」打包成一个标准化的配置文档（SKILL.md）。当你在对话中提到相关任务时，AI 会自动加载这个 Skill，理解你的需求并调用对应的脚本。

### 第一步：创建最小可用的 Skill

我从最简单的 Word 转 PDF 开始，我试着对WorkBuddy提了一个需求：

```
帮我把这个功能封装成skill
```
如图：
<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/843d9927c9a17049259cc9f9420964be.png' width=100%>

就这么简单！现在当我说「把这个 Word 转成 PDF」，AI 会自动识别并加载这个 Skill，然后调用脚本完成任务。

### 第二步：扩展转换能力

有了这个框架，扩展新功能就变得很容易。我又添加了几个常见需求：

- Word 转 Markdown（保留图片和表格）
- PDF 转 Markdown（提取文本）
- Markdown 转 Word

每次只需要：
1. 写一个新的转换脚本
2. 在 SKILL.md 中添加使用说明

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/2f64dbe47096b52820a33107e2210593.png' width=100%>




### 第三步：优化配置文档

随着功能增多，SKILL.md 需要更完善。我重新组织了文档结构：
关键的优化点：
1. **description 更精准** — 让 AI 更容易识别何时加载这个 Skill
2. **转换矩阵表格** — AI 能快速找到对应的脚本
3. **使用示例** — 提供自然语言的调用方式

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/47fce476d0c839e4e3301b9055fe7a86.png' width=100%>

转换矩阵表格

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/6dc2b2095e661b87b299eb46390ae62b.png' width=100%>

## 完善：支持更多文件类型

基本的文档转换能力有了，但日常工作中还有更多场景：

- 网页文档需要转成 Markdown
- 纯文本笔记需要格式化
- Excel 表格需要导出成 JSON
- 图片需要压缩、转格式

我决定把这个 Skill 打造成一个**全能格式转换工具**。

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/1a297ac46591fb10a5d3f3646e35471e.png' width=100%>


### 最终目录结构

```md
doc-converter/
├── SKILL.md                      # 技能配置文档（含触发词）
├── README.md                     # 项目说明
│
├── scripts/                      # 核心脚本目录
│   ├── convert.py                # 主入口 CLI（350 行）
│   │
│   ├── converters/               # 8 个转换器模块
│   │   ├── __init__.py          # 模块导出
│   │   ├── word_to_pdf.py       # Word → PDF 转换器
│   │   ├── word_to_markdown.py  # Word → Markdown 转换器（含图片提取）
│   │   ├── pdf_to_markdown.py   # PDF → Markdown 转换器
│   │   ├── markdown_to_word.py  # Markdown → Word 转换器
│   │   ├── web_to_markdown.py   # 网页 → Markdown 转换器
│   │   ├── text_formatter.py    # 文本格式化工具
│   │   ├── excel_to_json.py     # Excel → JSON 转换器
│   │   └── image_processor.py   # 图片处理器（压缩/转换/调整）
│   │
│   └── utils/                    # 工具模块
│       ├── __init__.py          # 工具导出
│       ├── dependencies.py      # 依赖管理
│       └── helpers.py           # 辅助函数
│
└── __pycache__/                  # Python 缓存（自动生成）
```

### 使用体验

现在，用户只需要用自然语言描述需求：

```
使用doc-converters skill压缩这张图片(**.png)到 20k，并且分辨率改为280x300
```

AI 会自动：
1. 识别这是一个格式转换需求
2. 加载 doc-converter Skill
3. 选择正确的脚本
4. 执行转换
5. 返回结果

**【实际使用效果演示】**

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/3b9ec2f8000a61faeee7e4a5412a5839.png' width=100%>

## 经验总结：如何封装你自己的 Skill

通过这次实践，我总结了一套 Skill 封装的方法论：

### 阶段一：从最小需求开始

不要一开始就想做「全能工具」。

1. 找到一个你**每天都会遇到的重复任务**
2. 在 WorkBuddy 中实现它
3. 验证可行后再考虑封装

### 阶段二：封装成可复用的 Skill

1. 创建 SKILL.md 配置文档
2. 写清楚 description（触发条件）
3. 提供使用示例
4. 测试 AI 能否正确识别和调用

### 阶段三：逐步完善功能

1. 按需添加新脚本
2. 更新 SKILL.md 文档
3. 增加边界情况处理
4. 收集使用反馈并优化

### 关键细节

**1. description 决定触发准确率**

```yaml
# 好的写法

description: Seamless multi-format document conversion toolkit supporting Word ↔ PDF ↔ Markdown conversion, web page to Markdown, text formatting, Excel to JSON, and image processing (compression, format conversion, resizing). Use when user mentions converting documents, extracting text, formatting notes, converting Excel to JSON, or processing images. Keywords: format flow, convert, Word to PDF, Word to Markdown, PDF to Markdown, Markdown to Word, web to Markdown, text formatting, Excel to JSON, image compression, image conversion, image resizing, document conversion, format conversion, extract text, 文档转换, 格式转换, 格式流转, Word转PDF, Word转Markdown, PDF转Markdown, Markdown转Word, 网页转Markdown, 文本格式化, Excel转JSON, 图片压缩, 图片转换, 图片调整.

# 不好的写法
description: 一个文档转换工具
```
触发词设计：

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/727771392cb3fae3ff10ea6a76a161f0.png' width=100%>

**2. 注意事项要诚实**

明确告知限制，避免用户期望过高：

- PDF 转 Word：扫描版提取可能不完整
- HTML 转换：复杂 CSS 样式可能简化
- Excel 转 CSV：公式会转为计算后的值

**3. 脚本要健壮**

- 自动安装依赖
- 智能处理编码（中文 GBK/UTF-8）
- 友好的错误提示

## 写在最后

回顾整个过程，从「帮我把 Word 转成 PDF」这一句话开始，到支持 40+ 种格式转换的 Skill，我走了三个阶段：

<img src='https://developer.qcloudimg.com/http-save/yehe-11671045/f042ab7ad619c8cacd5b62c9b77a1cc6.png' width=100%>

**核心洞察**: 从「帮我把 Word 转成 PDF」这一句话，到完整 Skill，关键在于：

1. **需求驱动**：每个阶段都有明确的用户需求触发
2. **架构演进**：在合适的时机做合适的重构
3. **场景拓展**：从单一场景延伸到多领域覆盖
4. **工程化思维**：将工具打磨成产品

这个过程带给我的启发是：**不要小看任何一个小需求**。

当你发现自己在重复做同一件事时，不妨停下来想想：这件事能不能自动化？能不能封装成可复用的能力？

也许下一个 Skill，就从你今天遇到的一个小需求开始。

如果你也需要用到这个skill的话，欢迎点击下方链接使用体验。

---
> **工具**：[WorkBuddy](https://copilot.tencent.com/work/) — 腾讯版 OpenClaw（小龙虾），AI 驱动的智能开发工具
>
> **Skill 获取**：[format-flow — 格式流动(支持40+格式转换)Skill](https://clawhub.ai/sashavegal/format-flow)
>
> **Skill 能力**：将专业经验封装为可复用的自动化流程，一句话触发，全程自动执行

那天我写完一份 Word 报告，领导突然说「发我一份 PDF 版本」。我打开 Word，点了导出，选了格式，保存到指定目录... 看起来很简单对吧？

从一句"Word文档转pdf格式"到 40 种格式通吃：🦞WorkBuddy玩虾实战 | 格式转换Skill封装之路🛠️

本文记录了我从最简单的「Word 转 PDF」需求开始，在 WorkBuddy 中逐步实现功能，最终封装成一个支持 40+ 种格式转换的标准化 Skill 的完整过程。如果你想把自己的日常任务也封装成可复用的技能包，这篇文章会给你一个清晰的参考路径。

开发工具

职业发展

WorkBuddy AI助手实现Word转PDF等40+格式转换，通过Skill技能包封装自动化脚本，支持Word/PDF/Markdown互转、Excel转JSON、图片压缩等常见办公需求，提升文档处理效率。从单一功能到完整工具链，展示AI自动化办公的实用价值。

图片处理

图片压缩

智能体

Windows

Python

JSON

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

从一句"Word文档转pdf格式"到 40 种格式通吃：🦞WorkBuddy玩虾实战 | 格式转换Skill封装之路🛠️-腾讯云开发者社区-腾讯云

从一句"Word文档转pdf格式"到 40 种格式通吃：🦞WorkBuddy玩虾实战 | 格式转换Skill封装之路🛠️

从一句"Word文档转pdf格式"到 40 种格式通吃：🦞WorkBuddy玩虾实战 | 格式转换Skill封装之路🛠️

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐