前言¶
日常办公里，合同、报告、扫描件常以 PDF 形式流转，而后续修订往往要在 Word（DOC/DOCX）里完成。手工另存、在线转换或自写脚本，要么步骤多，要么版式与可编辑性难以兼顾。把「PDF 转 Word」做成 Agent Skill，可以在对话里用自然语言触发转换，由技能封装 Aspose.PDF 与纯 Python 两套实现，并按场景选择不同转换模式。
这是什么¶
pdf-to-word（PDF 转 Word 转换工具） 是 SkillHub 上的社区技能，坐标为 @user_48bf225f/pdf-to-word-by-wp，当前版本 1.0.0，分类为 office-efficiency，发布者为 user_48bf225f。标签 requires_api_key=false，表示按官方说明无需单独配置 API Key。
技能定位：将 PDF 转为 Word（DOC/DOCX），支持 Aspose.PDF 与 纯 Python 双方案，并提供 Flow（易编辑）、EnhancedFlow（增强流）、Textbox（高保真） 等模式，便于在「好改」与「版式接近原文」之间取舍。
SkillHub 页面：https://www.skillhub.cn/skills/user_48bf225f/pdf-to-word-by-wp
技能 API 入口：https://api.skillhub.cn/user_48bf225f/pdf-to-word-by-wp
（页面统计：评分 100000，下载 9111，安装 88。）
核心功能¶
以下能力均来自 SkillHub 官方简介，未在资料中出现的细节不展开。
- 格式：PDF → DOC / DOCX。
- 实现路径：Aspose.PDF 方案与纯 Python 方案，可按环境与许可选择。
- 转换模式：
- Flow：偏易编辑；
- EnhancedFlow：增强流；
- Textbox：高保真。 - 触发语义（Agent 识别用）：PDF 转 Word / DOC / DOCX；PDF 转可编辑文档；批量 PDF 转换；aspose 相关操作。
安装与启用¶
安装方式以 SkillHub 技能页与 SkillHub 安装文档 为准。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，可能不会被识别。
skillhub install @user_48bf225f/pdf-to-word-by-wp --dir <skills 目录>
常用客户端的 skills 目录（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端的惯例重启或刷新 Agent，使技能被加载。
典型用法¶
公开资料未给出独立 CLI 子命令示例；使用方式以 对话触发 为主。在已启用该 Skill 的 Agent 中，可用与官方触发词一致的表述，例如：
- 说明要把某个 PDF 转为 Word（DOC 或 DOCX），并给出文件路径或让 Agent 在工作区内定位文件。
- 需要批量处理时，明确「批量 PDF 转换」及文件列表或目录。
- 若更在意可编辑性，可要求使用 Flow 或 EnhancedFlow；若更在意版式保留，可说明倾向 Textbox（高保真）。
- 环境允许且需要 Aspose 能力时，可在需求里提到 aspose 相关操作，由技能在双方案中选择合适实现。
具体脚本参数、依赖安装步骤以技能包内 SKILL.md 为准；本文未收录的内容请在安装后阅读该文件。
适用场景与注意¶
适合谁：需要在 Cursor、Claude Code、Codex 等支持 Skills 的环境里，用自然语言完成 PDF→Word、偶尔批量转换，并希望在「易编辑」与「高保真」之间显式选模式的办公与开发场景。
注意：
- 技能来源为 community，行为与依赖以安装后的技能文档为准。
- Aspose.PDF 与纯 Python 在许可、环境与输出质量上可能不同，选用前确认本机依赖与合规要求。
- 扫描版 PDF、复杂版式或嵌入字体的文件，任何转换方案都可能出现段落错乱或样式偏差；高保真模式有助于版式，但不保证与原件完全一致。
- 官方标明 requires_api_key=false；若后续版本变更配置项，以 SkillHub 页面与 SKILL.md 为准。
结尾¶
pdf-to-word 把 PDF 转 DOC/DOCX、双实现路径与三种转换模式收进一个 Skill，适合在 Agent 对话里完成单文件或批量转换。安装与坐标以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_48bf225f/pdf-to-word-by-wp
- 安装说明：https://skillhub.cn/install/skillhub.md
