官方 Office Skill:按公司模板改造四个文档

北京时间 2026 年 11 月 7 日早上,Anthropic 官方仓库 anthropics/skills 把驱动 Claude 文档能力的四个 Skill——docx、pptx、xlsx、pdf——从「只能当参考看」的专有许可改成了 Apache 2.0。提交是 2c5958e(Move Office skills to the Apache 2.0 license,#2146),改了 9 个文件:四个 LICENSE.txt 换成 Apache 2.0 全文,各自的 SKILL.md 和仓库 README 同步更新。2026 年 11 月 8 日查阅 GitHub API,该仓库星标 188,987。许可改完,团队可以 fork 一份,按自己公司的母版、配色和字体改,再装进 Claude Code。许可证变更本身见站内 四个 Office Skill 改开源;下面按官方 SKILL.md 写怎么装、四个 Skill 各自怎么干活,以及怎么改成公司模板。
前置条件
本文按 2026 年 11 月 8 日查阅的 anthropics/skills README、上述提交,以及 docx / pptx / xlsx / pdf 各自的 SKILL.md 和 Claude Code Skills 文档整理。四个 Skill 都在仓库的 skills/ 目录下,每个文件夹里是 SKILL.md、LICENSE.txt 和一套 scripts/。你需要能运行 Claude Code(或其他能加载 SKILL.md 的 Agent)。从零写 Skill 的步骤见站内 第一个 Agent Skill 教程。面向销售、产品、法务等角色的 8 个产品、17 个插件,是另一份 Knowledge Work Plugins,不要和这四个文档 Skill 混在一起。
先装官方四个,再拷一份出来改
README 写的安装路径是:在 Claude Code 里把这个仓库登记为插件市场,再装文档插件。
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
也可以打开「Browse and install plugins」,选 anthropic-agent-skills,再选 document-skills(示例技能是旁边的 example-skills)。装好之后直接提文档需求即可,比如:「用 PDF skill 提取 path/to/some-file.pdf 里的表单字段」。付费的 Claude.ai 方案里,这些示例 Skill 已经可用;要用仓库里的版本或上传自己改过的副本,按 Claude 的 Skills 说明操作。
插件会跟着市场上游更新。你要改公司模板,别直接改插件目录里的文件,拷一份到自己的 Skills 位置,并换一个名字,避免和官方的 pptx、docx 抢命令:
mkdir -p ~/.claude/skills
# 从仓库拷出,例如改成公司演示稿
cp -a skills/pptx ~/.claude/skills/acme-pptx
# 项目里和同事共用,则放到仓库的 .claude/skills/acme-pptx/
Claude Code 文档里,个人 Skill 放在 ~/.claude/skills/<名字>/SKILL.md,当前这台机器的所有项目都能用;项目 Skill 放在 .claude/skills/,提交进仓库后同事也会加载。插件里的 Skill 带插件名前缀。把文件夹改成 acme-pptx 后,记得同步改 SKILL.md 开头的 name 和 description:写上公司名、母版路径、以及「做内部演示稿时用这份,不要用通用 pptx」。description 是 Agent 决定要不要加载它的依据。
四个 Skill 各管一段,创建和改模板不是同一条路
它们都把 Office 文件当成 ZIP 包着的 XML 来处理,但创建新文件和改已有模板,走的工具不一样。
| Skill | 新建 | 改已有文件或模板 | 读内容 | 配套脚本(官方点名) |
|---|---|---|---|---|
| docx | 写 docx(npm)脚本 | unzip 后改 word/document.xml 再打包;docx-js 打不开已有文件 | pandoc -t markdown file.docx | merge_runs.py、comment.py、accept_changes.py、validate.py |
| pptx | 写 pptxgenjs 脚本 | 解压后改 ppt/slides/slideN.xml;从模板搭建也走这条 | markitdown deck.pptx;版式总览用 thumbnail.py | thumbnail.py、add_slide.py、clean.py、validate.py |
| xlsx | openpyxl 写公式和格式 | 同样用 openpyxl,并完全跟上原表的约定 | markitdown 看表;读模型和值要两次 load_workbook | recalc.py(LibreOffice 重算) |
reportlab 画新 PDF | pypdf 合并、拆分、旋转、加水印、加密 | pdfplumber 抽文本和表格;命令行用 pdftotext / qpdf | 进阶见同目录 REFERENCE.md、FORMS.md |
docx 的脚注很具体:默认页面是 A4,美式 Letter 要自己设 DXA 尺寸;表格要同时写列宽和每个单元格宽度;底纹用 ShadingType.CLEAR,用 SOLID 会涂成黑色;分页符必须放在段落里;不要在文本里写字面换行符。改已有 Word 时,先 unzip,删掉符号链接(来自外部的 docx 不可信),跑 merge_runs.py 把被修订号和拼写标记拆碎的文本合并回去,再在 document.xml 上改——不要美化或重新缩进 XML。打包必须在解压目录内部执行 zip -Xr,然后用 validate.py 对照原文件做 XSD 检查。
xlsx 要求输出里用公式,不要先在 Python 里算好再写入死数字;公式写完必须跑 python scripts/recalc.py output.xlsx。这个脚本用 LibreOffice 重算并原地改写文件,打印 JSON:status 为 success 或 errors_found。注意 errors_found 的退出码仍是 0,干净的退出不等于表格没问题。它也写明:LibreOffice 算不了 XLOOKUP、XMATCH、SORT、FILTER、UNIQUE、SEQUENCE,查找请改用 INDEX/MATCH。编辑已有工作簿时,「完全跟上原表的约定」压过 Skill 里的其他建议:先找出原表用来标记输入格的颜色或底纹,只改那些格子,已有公式不要动。
按公司模板改,从 pptx 这条路径最完整
四个里面,pptx 的 SKILL.md 对「用现成母版填内容」写得最细,公司模板可以先照这条路改。
- 把公司演示稿或
.potx放到 Skill 目录能引用到的位置(.potx要先复制成.pptx文件名,thumbnail.py只接受这个扩展名)。 - 先出带编号的缩略图:
python scripts/thumbnail.py template.pptx acme-thumbs。第二个参数一定要写,而且要按这份稿子起名——默认前缀是thumbnails,同一个目录里处理两份稿子会互相覆盖。 - 用
markitdown对照缩略图,决定每一段内容套哪一页版式,不要所有章节都套同一张标题加条目页。 - 解压模板,用
add_slide.py复制版式或样页(不要手工复制幻灯片文件,它会处理注册和关系)。增删和调整顺序先做完,再改某一页的文字;先改文字再复制,会把改过的内容一起克隆出去。 - 填内容时,模板上有 4 个成员位、你只有 3 个人,要把第 4 个成员的整组(图加文本框)删掉,不要只清空文字。项目符号让它继承版式,不要在文本里写字面的
•。 - 在解压目录内部打包:
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .)。先删旧包,否则已删除的部件还会留在 zip 里。 - 校验时带上原模板:
python scripts/office/validate.py out.pptx --original template.pptx。模板自己可能就有 XSD 报错,不加--original会分不清哪些是你引入的。
改公司模板,先用
thumbnail.py看清每一页母版,再决定内容往哪一页填。所有章节都套同一张标题加条目页,出来的稿子会一眼看出在套模板。
把公司规范写进你这份 SKILL.md 的正文:主色、辅色、强调色的六位十六进制(不要带 #,也不要写成 8 位)、可用字体、页边距、禁止事项。官方演示稿 Skill 自带一组主题色板,还点名不要用标题下的装饰线、通栏色条、侧边竖条和卡片单边描边,这些会被当成套出来的稿;没有指定背景时用白色或品牌色,不要默认米色。字体方面,它把 Arial、Calibri、Cambria、Times New Roman、Courier New、Bookman Old Style、Century Schoolbook 列为在 LibreOffice 预览和 Office 里宽度一致的安全字体;用户点名要用安全列表以外的字体时,容器要多留约 10% 空位,不要只看预览是否溢出。不要默认用 Aptos:这里没有宽度相近的替代字体,较老的 Office 也没有它。
docx 改公司信签,走「解压已有 .docx / .dotx → 合并 runs → 改 XML → 打包 → validate」这条路,因为新建用的 docx-js 打不开已有文件。xlsx 改公司财务模型时,先尊重原表的输入色和公式;Skill 里给新模型的默认是:蓝色文字表示手工输入,黑色表示公式,绿色表示跨表引用,红色表示跨文件引用,黄色底纹表示关键假设。pdf 更多是处理工具箱,公司页眉页脚或水印可以用 pypdf 把一页水印稿合并上去;用 reportlab 新建时,上下标必须用 <sub> / <super>,不要写 Unicode 下标字符,内置字体没有这些字形,会印成黑块。
你改过的副本如果要再分发给同事或装进内部市场,Apache 2.0 要求:带上这份许可证;在改过的文件上写明你改了什么;保留原来的版权和声明。许可覆盖的是仓库里的 Skill 文件,不包括 Claude 服务本身的使用条款。
常见坑
- 用 pptxgenjs 写颜色时带上
#,或写成 8 位十六进制。官方写明"#FF0000"和带透明度的"00000020"都会损坏文件。半透明用transparency(填充和图片,0–100)或opacity(阴影,0.0–1.0),两套字段不能混用。选项对象会被就地改成 EMU,同一个shadow对象不要传给两次add*。写完后跑validate.py,组合图缺坐标轴声明、堆叠图把数据标签放在outEnd,都会让 PowerPoint 打不开,其他预览器却可能看起来正常。 - 把
recalc.py退出码为 0 当成表格没问题。errors_found也会以 0 退出,要读 JSON 里的status和error_summary。公式算得出来,不等于引用的行没写错。 - 直接改插件里的官方副本。市场更新会覆盖你的公司配色和母版路径。拷到
~/.claude/skills/acme-pptx/或项目的.claude/skills/,并改掉name。 thumbnail.py忘了写第二个参数。默认前缀thumbnails会覆盖同目录里另一份稿子的缩略图。分析模板用缩略图即可;视觉验收要按文档把幻灯片转成 PDF 再出整页图,缩略图网格不够。- 用 python-pptx 去套公司模板。官方写明它不能真正复制一页幻灯片(入口只有按版式
add_slide),text_frame.text = "..."会把段落收成一段无样式文本,而且读不了模板里常见的 SVG/EMF 图。
完成标准
- Claude Code 里已经装上
document-skills@anthropic-agent-skills,或者四个官方文件夹能在本机 Skills 目录里找到。 - 公司定制版有独立目录和独立的
name/description,正文写清母版路径、配色和字体;没有直接改插件目录里的上游文件。 - 用公司 PPT 母版出过一份稿:经过
thumbnail.py、add_slide.py、内部打包,以及validate.py --original。 - xlsx 若含公式,已经跑过
recalc.py,并且根据 JSON 里的status排除了errors_found。 - 若要把改过的 Skill 分发出去,目录里仍有 Apache 2.0 的
LICENSE.txt,并且改过的文件上写了修改说明。
最后
先在 Claude Code 里执行 /plugin marketplace add anthropics/skills 和 /plugin install document-skills@anthropic-agent-skills,用官方四个跑通一次「生成一份 Word / 一套幻灯片 / 一张带公式的表」。然后把 skills/pptx 拷成 acme-pptx,把公司母版路径和三色写入 SKILL.md,用 thumbnail.py 对照母版做一页内部演示稿。能通过 validate.py --original,这套公司模板才算接上。