Zagens 四格式 Office 专家

问题背景

Agent 要交付 PPTX、XLSX、DOCX 或 PDF，常见做法是依赖本机 Microsoft Office、手工改 OOXML，或把多页幻灯片一次性塞进 write 的 elements[]。结果是环境不可复现、改稿难回滚，正式对外稿还容易版式翻车。清洗台账、多表合并等数据管道也不该和「填企业模板」混在同一套说明里。

技能如何工作

本技能路由 zagens-office 引擎：单二进制 CLI，无 Office 依赖。工作流强调 先契约：用 schema write / schema edit 看清字段，再 write 生成或 edit 改稿；stdout 一行 JSON，ok=false 时按 code / error / suggestion 修正。

• PPTX：正式/精修场景默认 骨架 write + 逐页 upsert_slide，禁止一次 write 塞满多页重画布；细节见 pptx-design.md、pptx-craft.md。
• XLSX：清单用 write xlsx-table；改已有表单优先 read fillmap → edit fill（格多先 dry_run），未覆盖格再走 xlsx-grid.md。
• DOCX / PDF：write / edit / read（PDF 无 read，不要对 PDF 跑 validate）。
• Hub + Spoke：洗表/去重走 office-xlsx-clean；多文件合并走 office-xlsx-merge；勿在本 skill 展开 transform。

复杂 JSON 用 --input-file；多步改稿用 edit batch 且 atomic 为 true。交付前至少 preflight 或 validate（仅 OPC，不含 PDF）。

边界与注意

引擎需安装在 ~/.zagens-pro/bin/（CLI + GUI）；探测失败时按官方安装文档装全后再 --version。字段以 schema 为准，勿混用四格式字段或凭记忆猜。远程 URL 需先落到本地 path；Windows 路径用正斜杠或引号包裹。