这个 Skill 能做什么,适合哪些场景?
这是 Open Cowork 开源桌面应用内置的 docx 技能,位于仓库的 .claude/skills/docx/ 目录。它把 .docx 文件当作 ZIP 包内的 XML 来处理:读取用 pandoc,创建用 docx-js(JavaScript),编辑则走“解包 XML → 直接修改 → 重打包”的流程。技能内置了 unpack.py、pack.py、comment.py 等脚本,可保留修订记录、添加批注并自动修复常见 XML 问题。适用于任何具备 shell 和文件系统访问能力的 Agent 客户端,是该应用 Skills 库中五个技能之一(与 pptx、pdf、xlsx、skill-creator 并列)。
- 用 pandoc(--track-changes=all)提取 .docx 文本内容,包括修订记录
- 用 docx-js 库从零生成 .docx:段落、列表、表格、图片、页眉页脚、目录、分页
- 用 unpack.py 解包现有文档为可读 XML,编辑后用 pack.py 重打包(带校验与自动修复)
- 以 <w:ins>/<w:del> 标记插入/删除的修订,作者固定为 "Claude",可拒绝或恢复他人修订
- 用 comment.py 添加批注及嵌套回复
- 用 soffice 转 PDF、pdftoppm 转图片用于视觉核对
- 需要按合同或报告原有格式修改 Word 文档并保留修订痕迹的法务或商务人员
- 要批量生成结构规范的报告(US Letter 页面、标题样式、目录、页码)的行政或咨询人员
- 希望在 AI 协助下为 Word 文档添加批注和回复的审阅者
- 需要从 .docx 中提取含修订历史的文本供后续处理的作者
- 要把文档转成 PDF/图片做视觉验证或交付的开发者或自动化流程使用者
- 无法安装 pandoc、Node.js、LibreOffice、Poppler 和 Python 的封闭环境——这些是该技能声明的全部依赖
- 需要生成 PPTX、PDF、XLSX 的场景——那些是同一仓库中的其他兄弟技能,不在本技能范围内
- 只想在纯聊天(无 shell/文件系统访问)中使用 AI 处理 Word 文件的用户——本技能依赖命令行与本地文件操作
如何安装这个 Skill?
- Shell / 命令行
- 本地文件系统
pandocNode.js (docx via npm install -g docx)LibreOffice (soffice)Poppler (pdftoppm)Python 3 (scripts/unpack.py, pack.py, comment.py)
该技能随 Open Cowork 应用内置(.claude/skills/docx/),也可复制到任意 Agent Skills 兼容客户端的 skills 目录。
Open Cowork:应用自带,无需单独安装。
Claude Code / 其他 Agent Skills 客户端:将仓库中的 docx 技能目录复制到你的技能目录:
git clone https://github.com/OpenCoworkAI/open-cowork.git
cp -r open-cowork/.claude/skills/docx /path/to/your/skills/docx依赖安装(技能声明):
npm install -g docx
brew install pandoc
brew install --cask libreoffice
brew install poppler如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 读取这份 report.docx,把其中所有“30 天”改成“60 天”,用修订模式标注改动并加一条批注说明原因
- 帮我创建一份 US Letter 尺寸的 Word 文档,包含标题、两级标题样式、带页码的页脚和自动目录
- 提取 contract.docx 的全部文本,包括修订记录和批注,输出为 Markdown
- 把这份 Word 文档转成 PDF 再转成图片,逐页检查表格排版是否正常
技能通过 SKILL.md 的描述由 Agent 在需要处理 .docx 任务时自动触发。创建新文档时,Agent 按 SKILL.md 指引编写 docx-js JavaScript 代码并运行;编辑现有文档时遵循固定三步流程:
# 步骤1:解包
python3 scripts/unpack.py document.docx unpacked/# 步骤2:直接编辑 unpacked/word/ 下的 XML(用编辑工具做字符串替换,不写 Python 脚本)
# 步骤3:重打包(含校验与自动修复)
python3 scripts/pack.py unpacked/ output.docx --original document.docx
# 读取/提取文本(含修订)
pandoc --track-changes=all document.docx -o output.md# 转换为图片核对
soffice --headless --convert-to pdf document.docx
pdftoppm -jpeg -r 150 document.pdf page
# 添加批注及回复
python3 scripts/comment.py unpacked/ 0 "批注内容"
python3 scripts/comment.py unpacked/ 1 "回复内容" --parent 0可选参数:unpack.py 支持 --merge-runs false 跳过 run 合并;pack.py 支持 --validate false 跳过校验。自动修复能处理 durableId 越界和缺失 xml:space 属性,但不能修复结构性 XML 错误。
这个 Skill 有哪些优点和局限?
- 三步编辑流程有脚本支撑:解包时合并 run、转换智能引号,打包时校验并自动修复常见问题
- 对 docx-js 的关键坑(A4 默认页尺寸、表格双宽度、ShadingType.CLEAR、PageBreak 必须在段落内等)给出了明确的避坑规则
- 修订与批注的 XML 模式完整,包括拒绝他人插入、恢复他人删除等边缘场景
- 依赖均为成熟开源工具(pandoc、LibreOffice、Poppler、docx-js)
- SKILL.md 的 license 标注为“Proprietary,LICENSE.txt 有完整条款”,与仓库整体的 MIT 许可不同,采用前需查看该技能目录下的 LICENSE.txt
- 依赖链较重:pandoc、Node.js、LibreOffice、Poppler、Python 都需预先安装
- pack.py 的自动修复范围有限,结构错误的 XML 仍会导致失败
- 技能来自 Open Cowork 仓库整体使用记录,未提供针对 Claude Code 之外的独立测试证据
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Open Cowork DOCX 文档技能 本页 | 69 · 推荐 | ★ 2.2k | 12 天前 | MIT |
| DOCX 文档技能 ✓ Anthropic · 官方 | 50 · 谨慎使用 | ★ 181k | 16 天前 | — |
| DeepTutor DOCX 文档技能 | 59 · 推荐 | ★ 41k | 17 天前 | Apache-2.0 |
| DOCX 文档处理技能 | 51 · 谨慎使用 | ★ 4.4k | 1 个月前 | Apache-2.0 |
| PPTX 演示文稿技能 ✓ Anthropic · 官方 | 54 · 谨慎使用 | ★ 181k | 16 天前 | — |
Open Cowork README 将本技能所在应用与 Claude Cowork、OpenClaw 做了整体功能对比(远程控制、GUI 操作等),但未对 docx 技能本身给出替代品对比;同仓库的 pptx、pdf、xlsx 是并列技能而非竞品。
FollowSkills 如何评估这个 Skill?
这是 Anthropic 官方 docx 处理 skill 的转载/内置副本(license 声明与 Anthropic 官方一致「Proprietary,LICENSE.txt 含完整条款」),内容本身可信,但需要留意这是第三方仓库内置的官方技能副本,更新可能滞后于官方源。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。
查看完整评分方法 →