docx
Anthropic 官方 Word 文档技能:创建走 docx-js、编辑走 unzip 改 XML、读取走 pandoc,配 merge_runs/comment/accept_changes/validate 脚本处理 Word 内部机制(run 碎片、六文件批注、修订追踪),最后 soffice 渲染成图片让模型亲眼验证排版。Claude Code 内置核心技能,全网引用最多的文档技能。
仓库:anthropics/skills
热度证据:Anthropic 官方 Agent Skills 仓库,被所有 awesome 列表收录;官方 anthropics/skills 仓库 168,637 star,Claude Code 内置核心技能之一,全网被教程引用最多;五库分析 2
五维评分
热度5/5
质量5/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- 任务→方案决策表路由:一张三行表格把创建/编辑/读取映射到 docx-js、XML 直改、pandoc 三条路线,并把『docx-js 不能打开已有文件』作为路由依据写进表里,杜绝工具误用
- gotcha 清单把专家踩坑知识压缩为十余条可执行规则:页面 DXA 尺寸、表格双宽度且须求和、ShadingType.CLEAR、禁止\n、PositionalTab 点线等,把运行时才暴露的错误前置为零成本
- 视觉回环质检:生成后强制 soffice 转 PDF、pdftoppm 转 JPG 并让模型 Read 图片检查排版,把交付标准从『脚本没报错』提升到『看起来对』
- 把 Word 内部机理显性化给模型:run 碎片化原理、批注六文件结构、<w:delText> 与删除段落标记语义等玄学全部解释清楚,让 agent 按『为什么』推理而非死记模板
- 防御式工程:编辑前剥符号链接、helpers 防 zip-slip 路径逃逸、--original 差分校验、--auto-repair,把外部不可信文档当作安全敏感输入处理
可复用的设计模式
- 决策表路由 + 负向边界:用 markdown 表格把任务类型映射到唯一技术方案,并在 description 里明确『不要用于』清单,防止 agent 误用
- 渲染回环验证:把二进制产物用本地工具转成图像再让模型亲眼检查,适用于一切办公格式/图表/设计类技能
- 脚本即手术刀:一个脚本只修一类 OOXML 内幕问题(merge_runs/comment/accept_changes/validate),CLI 参数化 + 返回人类可读消息,SKILL.md 只负责编排
- 把环境坑编码进脚本:soffice.py 运行时探测 AF_UNIX 封禁并自动上 LD_PRELOAD shim,环境差异不留给模型判断
适用场景
合同/法律文档审阅:提取内容、查找替换、加批注、做修订(redline)并校验修订完整性生成专业排版报告:目录、页眉页码、信头、图片插入、Letter/A4 页面尺寸控制文档格式转换与清洗:.doc 转 .docx、合并碎片 run 后批量编辑、一键接受全部修订出干净副本
边界与注意:需 pandoc + LibreOffice + poppler 三个系统依赖,无桌面环境或沙箱禁用 socket 时 soffice 链路依赖脚本 shim 兜底;不碰 PDF/表格/Google Docs;接受修订后可能残留空段落(视图产物,需查 XML 确认,非文档缺陷)
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/anthropics-docx.md