Claude Code 中 tfriedel/claude-office-skills 的安装使用教程：让命令行处理 Office 文档
在 Claude Code 里让它处理 PPT、Word、Excel、PDF，很多人第一步就卡住：这是装一个插件，还是复制一堆脚本？tfriedel/claude-office-skills 更接近一套本地 Office 文档处理技能包。它把不同文件类型的处理流程写成 SKILL.md，让 Claude Code 遇到任务时先走对应规则，再调用仓库里的脚本做生成、编辑、验证和输出。
这篇只围绕三个问题展开：它到底解决什么、怎么在 Claude Code 里装起来、装完以后怎么确认能用。至于每一种格式的高级玩法，比如 PPT 模板替换、Word 红线、Excel 公式模型、PDF 表单填充，可以在跑通以后再单独深入。
它到底解决 Claude Code 的什么问题
Claude Code 本身是命令行里的智能编码工具，但 Office 文档不是普通文本。一个 .pptx、.docx 或 .xlsx 文件背后是压缩包、XML、样式、图片、公式和关系文件。随便写脚本改，很容易把格式弄坏，或者生成一个看起来有文件、打开却不对的结果。
tfriedel/claude-office-skills 做的事，是把这些容易出错的文档流程固定下来。PPTX 走 public/pptx/SKILL.md，会提醒先看缩略图、模板索引、文字清单；DOCX 走 public/docx/SKILL.md，正式文档要优先考虑 tracked changes；XLSX 走 public/xlsx/SKILL.md，重点是公式和零错误；PDF 走 public/pdf/SKILL.md，表单任务还要继续看 FORMS.md。
所以它适合的不是“随便帮我做个文件”，而是更具体的场景：在服务器或本地命令行批量做报告、套 PPT 模板、给 Word 文档留痕修改、生成 Excel 模型、把 PDF 表单和数据源接起来。它解决的是 Claude Code 处理 Office 文件时缺少固定路线和检查证据的问题。
安装前先确认这几个入口
先把仓库放到本地，再准备 Python 和 Node 依赖。README 里给出的基本准备就是 requirements.txt 和 npm install。如果本地还没有虚拟环境，建议先建一个，后面所有 Python 命令都用 venv/bin/python 或 venv/bin/pip，路径会更清楚。
git clone https://github.com/tfriedel/claude-office-skills.git
cd claude-office-skills
python3 -m venv venv
venv/bin/pip install -r requirements.txt
npm install接着检查三个系统工具。soffice 用来做 Office 到 PDF 的转换和视觉检查，pdftoppm 用来把 PDF 转成图片，pandoc 常用于抽取 DOCX 内容。缺哪个，后面就会在具体任务里卡住。
which soffice
which pdftoppm
which pandoc
装完以后怎么让 Claude Code 用起来
最小测试不要一上来就用复杂模板。可以先让 Claude Code 在这个仓库上下文里做一个很小的 PPTX 任务，例如 3 页销售演示稿。它应该先识别这是 PPTX 任务，再读取 public/pptx/SKILL.md，然后把生成文件放进 outputs/<document-name>/。
Create a quarterly sales presentation with 3 slides.想测 Word，就换一个小文档任务，例如让它给一份短文档添加 tracked changes。成功信号不是聊天里说“完成了”，而是输出目录里有最终文件，还有能说明过程的中间文件或验证痕迹。这个仓库强调输出目录，是为了让你能回头查每一步。
Edit this Word document and add tracked changes.如果你要测 Excel，重点看公式是否保留在表格里，以及 recalc.py 是否返回零错误。如果你要测 PDF，先分清是提取、合并、转图片，还是填表单。不同任务会进不同说明文件，别把所有 PDF 操作都当成一个命令。
常见坑先看输出目录
第一个坑是没读到对应技能。比如你让它做 PPTX，但它没有进入 public/pptx/SKILL.md，而是在根目录随手写脚本，这就偏了。这个仓库的核心规则是先看任务有没有现成 skill，有就按 skill 走。
第二个坑是只看最终文件，不看检查文件。PPTX 要看缩略图有没有文字截断，模板任务要看 inventory.json 和替换 JSON，Excel 要看公式重算结果，DOCX 要看红线是否真实保留。输出目录里没有这些证据，就别急着拿去交付。
第三个坑是把这个仓库当成永远最新的官方版本。README 在 2026-04-01 提醒过：这个项目发布早于 Anthropic 官方公开 skills，后续更新更应该关注 Anthropic 官方 skills 仓库。更稳的做法是把 tfriedel/claude-office-skills 当作命令行 Office 工作流的学习和本地复用入口，再按需要对照官方版本。
先跑通，再扩展
这类 Office skill 最怕一开始就贪多。先用一个 PPTX 或 DOCX 小任务确认三件事：Claude Code 是否进了正确的 public/*/SKILL.md，依赖和系统工具是否齐全，outputs/<document-name>/ 里是否有可检查文件。三件事都成立，再把正式文档、复杂模板、Excel 模型或 PDF 表单交给它处理，会稳得多。
总结下来，tfriedel/claude-office-skills 不是一个单点按钮，而是一套让 Claude Code 按文件类型处理 Office 文档的本地技能包。新手先弄清它解决什么问题，再把依赖和系统工具装好，最后用小任务检查输出目录和验证文件。能看到这些证据，才算真正跑通。