前言¶
讓模型寫 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
