前言¶
让模型写 Office 文档，常见的做法是写一段 Python 脚本，调用 python-pptx 或 openpyxl 拼文件，然后执行、看报错、改脚本、再执行。文件大一点、页数多一点，轮次很快消耗在脚本调试上，而且产物是否真的能打开、版式是否错位，往往要等到最后一步才知道。
下面介绍的技能换掉了这一层：把文档意图写成声明式 JSON，由本机结构化引擎校验后直接产出原生 .pptx / .xlsx / .docx / .pdf 文件，不需要回落到生成脚本。
这是什么¶
PPT.XLSX.DOCX.PDF专家，坐标 @user_231d2fd3/zagens-office，是 SkillHub 上 community 来源的 office-efficiency 类技能，当前版本 0.12.0，发布者 user_231d2fd3。
它面向高频使用 PPT / XLSX / DOCX / PDF 的人员，内置 Office 引擎，可以快速生成、编写、修改各种原生 Office 文档。技能本身不需要 API Key（标签 requires_api_key=false）。
什么时候该用它¶
按技能说明，凡是涉及创建或编辑 Office 文档的请求，都优先使用本技能。明确列出的触发场景包括：
- 演示文稿、幻灯片、PPT、公司介绍、路演、报告、提案
- 表格、电子表格
- Word、公式、LaTeX
- 各类 Office 文件名
还有一条使用约定值得单独说：本技能可用时，不要回退去写生成脚本。也就是说，除非技能不可用，不需要在对话里手写 python-pptx 之类的构造代码。
声明式 JSON 与引擎行为¶
zagens-office 是一个本机结构化引擎，工作方式是「声明式 JSON 入、schema 校验后秒级出可打开文件」。
对使用者来说，这意味着两点：输入是结构化的文档描述而不是程序代码；引擎会先做 schema 校验，把不合法的结构挡在生成之前，而不是生成一个损坏的文件再让你去发现。
技能内置完整创作 DSL，并提供约 100 个结构化编辑操作，覆盖创建与修改两端。
正式稿的正确写法：骨架 write + 逐页 upsert_slide¶
正式、精修的 PPTX（例如路演、官网样张、需要高级感的成稿）默认走「骨架 write + 逐页 upsert_slide」：先用一次 write 落出骨架，再逐页用 upsert_slide 填充内容。
禁止的做法是一次 write 就把 slides[] 塞满重内容。一次写入的体量越大，越难定位某一页的问题，返工成本越高。逐页 upsert 相当于每页都可以单独校验和修正。
短的非正式稿则不必这么走，单次 write 就够了。判断标准是成稿用途：要交付的正式稿用逐页方式，内部草稿或一次性说明用单次写入。
结构化编辑操作能覆盖的范围¶
约 100 个操作中，与排版和内容直接相关的几类：
- 编辑与修正：upsert_slide、fill、auto_fix、fit_text、avoid_overlap
- 对齐与分布：对齐分布相关操作
- 可视化：图表
- 呈现：动画
- 批量：batch
- 取舍与比较：generate_variants、rank_variants
- 出稿前检查：preflight
其中 preflight 值得在出正式稿时用一次，它的作用是在生成阶段先做一次检查，而不是等打开文件后人工发现问题。generate_variants 与 rank_variants 是成对的：先产出多个变体，再排序挑选，适合版式选择有分歧的场景。
适用场景与注意¶
适合：需要批量产出或反复修改 Office 文档，且希望产物是原生文件而非脚本拼接的场景；以及希望用结构化方式描述文档意图、避免在代码和排版之间来回切换的场景。
需要注意：
- 官方地址为 https://api.skillhub.cn/user_231d2fd3/zagens-office ，SkillHub 页面为 https://www.skillhub.cn/skills/user_231d2fd3/zagens-office 。页面抓取失败时以官方地址为准。
- 各宿主（Cursor / Codex CLI / Claude Code）的安装启用方式，本次未能从官方页面核实到具体命令，需以技能包内的 SKILL.md 说明为准，此处不列出未经核实的安装命令。
- 「秒级出可打开文件」是引擎层面的描述，实际耗时取决于文档规模与本机环境。
- 页面标注为 community 来源、安装量为 0，采用前建议先按 SKILL.md 的最小示例跑一遍。
结尾¶
这个技能的价值在于把「写脚本造文档」换成「写 JSON 描述文档」，让校验发生在生成之前，并用逐页 upsert 的方式降低正式稿的返工成本。如果日常要处理的路演稿、报告和表格较多，值得先按骨架 write + 逐页 upsert_slide 的方式试一轮。
官方地址：https://api.skillhub.cn/user_231d2fd3/zagens-office
