前言¶
在自动化流水线或本地脚本里处理 PDF、Word、Excel、PPT，常见做法是各装一套库，再为「转 PDF」「抽表格」「改模板」分别写胶水代码。转换环节往往还要绑本机 WPS 或 Microsoft Office，环境一换就容易踩坑。若你希望 Agent 按统一约定完成「文件进、文件出」的批处理，而不是每次从零拼命令，SkillHub 上的 Office Toolkit（坐标 @user_5d13378c/office-toolkit-ela，当前版本 1.5.1）把读取、创建、转换、编辑四类能力收进一个 Skill，并标明读取侧为零依赖纯 Python、转换侧支持双办公套件引擎。下面介绍它是什么、能做什么，以及如何安装启用。
这是什么¶
Office Toolkit 是社区来源（community）的 Agent Skill，分类为 office-efficiency，由发布者 user_5d13378c 维护。官方入口：
- Skill 包地址：https://api.skillhub.cn/user_5d13378c/office-toolkit-ela
- SkillHub 展示页：https://www.skillhub.cn/skills/user_5d13378c/office-toolkit-ela
定位一句话：Office 文件离线批处理工具箱，专注「文件进、文件出」，覆盖 PDF、DOCX、PPTX、XLSX 的读取、创建、转换与编辑，面向批量、离线、自动化场景。标签 requires_api_key=false，不依赖外部 API Key。
核心功能¶
以下能力均来自 SkillHub 简介与页面说明，未单独列出的细节以安装后 Skill 内 SKILL.md 为准。
读取¶
- 支持从上述四类 Office 相关格式中提取内容。
- 读取零依赖：纯 Python、跨平台，适合在无桌面 Office 的环境里先跑通「读文件」链路。
创建与编辑¶
- 可创建、编辑 DOCX、PPTX、XLSX、PDF 等（具体能力以 Skill 文档为准）。
- XLSX 侧强调：支持公式；并提供 13 种财务配色约定——蓝表示输入、黑表示公式、绿表示跨表引用，便于生成符合财务阅读习惯的工作表。
格式转换¶
- 转换支持 WPS 与 Microsoft Office 双引擎（本机需安装对应套件时由引擎完成渲染类转换）。
- 输出方向包括转为 PDF、CSV、JSON 等（简介中明确列出 →PDF / →CSV / →JSON）。
安装与启用¶
安装流程遵循 SkillHub 官方说明：https://skillhub.cn/install/skillhub.md
1、检查或安装 SkillHub CLI¶
确认本机是否已有 skillhub：
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、安装 Office Toolkit¶
安装时必须用 --dir 指向当前 Agent 正在使用的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。
skillhub install user_5d13378c/office-toolkit-ela --dir <你的 skills 目录>
SkillHub 页面亦支持将下面这句发给 AI，由其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5d13378c/office-toolkit-ela`。
3、常见 Agent 的 skills 目录¶
按 SkillHub 安装文档，常用路径包括：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装到对应目录后，按你所用客户端的要求刷新或重启 Agent，使 Skill 生效。
典型用法¶
公开页面未附带独立命令行 demo；该 Skill 基于通用 SKILL.md 格式，由 Agent 在安装后读取技能说明并调用内置脚本或流程。可复现的使用方式如下。
- 完成上一节安装，确认 Skill 出现在 Agent 的 skills 列表中。
- 在对话中用自然语言描述输入文件路径、期望操作与输出路径，并限定在 Skill 支持的范围内，例如：
- 批量将某目录下 DOCX 转为 PDF；
- 读取 XLSX 并导出 CSV 或 JSON；
- 按财务配色规则生成带公式的 XLSX。 - Agent 按
SKILL.md编排「读 → 处理 → 写」，在本地落盘结果文件。
若转换步骤走 WPS 或 Microsoft Office 引擎，需本机已安装并可被 Skill 调用的对应套件；纯 Python 读取路径则不依赖桌面 Office。
适用场景与注意¶
适合谁
- 需要在 CI、内网机或批量任务里处理 Office 文件、又不想每次手写多库脚本的开发者。
- 希望 Agent 统一处理 PDF / DOCX / PPTX / XLSX，且接受离线、文件进出的工作流。
- 做财务类表格交付，需要公式与蓝 / 黑 / 绿配色约定的工作簿。
限制与注意
- 双引擎转换依赖本机 WPS 或 Microsoft Office 环境，与「零依赖读取」不是同一层能力，部署时要分开验证。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 2039 次，安装计数 0；具体行为仍以你本机安装的 1.5.1 包内文档为准。
- 未核实到的客户端专属配置项不在本文展开；差异安装路径以 https://skillhub.cn/install/skillhub.md 为准。
结尾¶
Office Toolkit 把 Office 批处理收敛为 Agent 可调用的 Skill：读取侧强调纯 Python 跨平台，表格创建侧强调公式与财务配色，转换侧提供 WPS 与 Microsoft Office 双引擎及 PDF / CSV / JSON 等输出。若你的场景是批量、离线、自动化的「文件进、文件出」，可从官方包地址或 SkillHub 页面安装 @user_5d13378c/office-toolkit-ela 试用。
- https://api.skillhub.cn/user_5d13378c/office-toolkit-ela
- https://www.skillhub.cn/skills/user_5d13378c/office-toolkit-ela
