教程2026-11-08 · 智涌AI

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

官方 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.docxmerge_runs.py、comment.py、accept_changes.py、validate.py
pptx写 pptxgenjs 脚本解压后改 ppt/slides/slideN.xml;从模板搭建也走这条markitdown deck.pptx;版式总览用 thumbnail.pythumbnail.py、add_slide.py、clean.py、validate.py
xlsxopenpyxl 写公式和格式同样用 openpyxl,并完全跟上原表的约定markitdown 看表;读模型和值要两次 load_workbookrecalc.py(LibreOffice 重算)
pdfreportlab 画新 PDFpypdf 合并、拆分、旋转、加水印、加密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 对「用现成母版填内容」写得最细,公司模板可以先照这条路改。

  1. 把公司演示稿或 .potx 放到 Skill 目录能引用到的位置(.potx 要先复制成 .pptx 文件名,thumbnail.py 只接受这个扩展名)。
  2. 先出带编号的缩略图:python scripts/thumbnail.py template.pptx acme-thumbs。第二个参数一定要写,而且要按这份稿子起名——默认前缀是 thumbnails,同一个目录里处理两份稿子会互相覆盖。
  3. 用 markitdown 对照缩略图,决定每一段内容套哪一页版式,不要所有章节都套同一张标题加条目页。
  4. 解压模板,用 add_slide.py 复制版式或样页(不要手工复制幻灯片文件,它会处理注册和关系)。增删和调整顺序先做完,再改某一页的文字;先改文字再复制,会把改过的内容一起克隆出去。
  5. 填内容时,模板上有 4 个成员位、你只有 3 个人,要把第 4 个成员的整组(图加文本框)删掉,不要只清空文字。项目符号让它继承版式,不要在文本里写字面的 •。
  6. 在解压目录内部打包:(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .)。先删旧包,否则已删除的部件还会留在 zip 里。
  7. 校验时带上原模板: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 服务本身的使用条款。

常见坑

完成标准

最后

先在 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,这套公司模板才算接上。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。