pptx

pptx skill 概覽

pptx skill 適合拿來做什麼

pptx skill 適用於任何需要讀取、建立、編輯、拆分、合併 PowerPoint .pptx 檔案，或把它當成範本使用的工作流程。這不是只有提示詞範本的 pptx skill，而是一套實際可執行的操作路徑：會直接指向可用的指令與輔助腳本，協助你擷取內容、產生投影片縮圖、解開 Office XML 結構、安全編輯，以及重新封裝整份簡報。

最適合的使用者

這個 skill 最適合那些需求不只是「幫我做投影片」的人：

• 需要從簡報中擷取文字或結構的分析師
• 要更新既有品牌簡報的團隊
• 需要把一份 deck 轉成另一份 deck 的 agent
• 在沒有範本時，需要從零建立新簡報的使用者
• 能接受用 Python 或 JavaScript 工具處理 .pptx 的開發者

真正要完成的工作

大多數使用者要的其實不只是「PowerPoint 幫忙」，而是以下兩種結果之一：

1. 快速理解一份 deck 裡到底有什麼，或
2. 在不破壞版面、參照關係與封裝結構的前提下修改 deck。

pptx skill 的價值，在於它把這兩條路徑清楚拆開：做檢查與理解時，用 markitdown 搭配縮圖；做範本型編輯時，用 XML unpack/edit/clean/pack 流程；如果是從零建立，則改走 PptxGenJS。

pptx 和一般提示詞有什麼不同

一般 AI 提示詞可以幫你草擬投影片內容，但通常無法可靠地保留真實簡報的結構。pptx skill 提供的是一條可執行的流程：

• python -m markitdown presentation.pptx：擷取文字
• python scripts/thumbnail.py presentation.pptx：檢查視覺版型
• python scripts/office/unpack.py ... 和 pack.py：進行低層級編輯
• python scripts/clean.py unpacked/：移除孤兒檔案
• pptxgenjs.md：用程式碼建立 deck

因此，當格式、範本一致性或 deck surgery 很重要時，pptx for PowerPoint 特別有用。

安裝前要先知道的取捨

如果你需要對 .pptx 檔案做可預期、可控的處理，這個 skill 很強；但如果你只是想要投影片文案，完全不在意輸出結構，那它就不是最理想的選擇。它也預設你願意接受以檔案與腳本為主的工作方式。若你的需求只是把簡報文字寫漂亮，一般 prompt workflow 可能更快；但如果你要保住真實 deck 的完整性，pptx skill 會更合適。

如何使用 pptx skill

pptx 的安裝情境

先在支援 skills 的環境中安裝這個 skill：

npx skills add https://github.com/anthropics/skills --skill pptx

安裝完成後，先打開 skill 目錄，優先閱讀以下檔案：

• SKILL.md
• editing.md
• pptxgenjs.md
• scripts/thumbnail.py
• scripts/add_slide.py
• scripts/clean.py

這個閱讀順序其實就是實際使用時的決策樹：先檢查，再選編輯路徑，最後套用正確工具。

先選對 pptx 使用路徑，再開始動手

在開始編輯之前，不要急著修改，先決定哪一種模式最符合你的工作需求：

• 讀取／分析內容：使用 markitdown 與縮圖產生流程
• 編輯既有 deck 或範本：使用 unpack/edit/clean/pack
• 從零建立 deck：走 pptxgenjs.md 裡的 PptxGenJS 路徑

這是導入 pptx 最有效的捷徑之一。很多失敗的 pptx usage，就是因為把範本編輯和從零產生混在一起做。

快速讀取 deck 內容

如果目的是擷取內容，先從這個開始：

python -m markitdown presentation.pptx

適合以下需求：

• 擷取投影片文字做摘要
• 找出 placeholder 文字
• 快速盤點內容
• 規劃備註或文案遷移

接著再加上：

python scripts/thumbnail.py presentation.pptx

文字視圖告訴你 deck 在說什麼；縮圖格狀圖則告訴你它怎麼設計。兩者搭配後，能在真正修改之前大幅降低誤判。

編輯版面前，先用縮圖看清楚

thumbnail.py 是這個 skill 最實用的部分之一，因為它能把版型選擇具體地顯示出來。它會用 XML 檔名標記每張投影片，這對後續編輯 slide{N}.xml 很重要。若你是在做範本型工作，建議一定先產生縮圖，先把各段內容對應到合適的既有版型，而不是一直重複使用同一種通用投影片版面。

安全地編輯既有簡報

如果是範本型編輯，repository 建議的工作流程是：

1. 先用 markitdown 和 thumbnail.py 分析來源 deck
2. 解開 deck：
   python scripts/office/unpack.py template.pptx unpacked/
3. 先做結構性調整
4. 再修改投影片 XML 內容
5. 清理 unpacked 目錄：
   python scripts/clean.py unpacked/
6. 重新封裝：
   python scripts/office/pack.py unpacked/ output.pptx

這個順序很重要。很多人都是在文字改完後才回頭改結構，結果造成參照壞掉，或白做一輪工。

先做結構調整，再改內容

pptx skill 明確建議先把 deck 結構定下來：

• 透過更新 <p:sldIdLst> 刪除不需要的投影片
• 用 scripts/add_slide.py 複製投影片
• 有需要時，從 layout 建立新投影片
• 在最後替換文字前，先把投影片順序排好

這樣做很實際，因為在細部內容編輯開始前，投影片編號、relationship 與各種參照會更容易管理。

複製版型時，優先使用 add_slide.py

scripts/add_slide.py 特別適合兩種常見情境：

• 複製現有投影片，例如 slide2.xml
• 從版型建立新投影片，例如 slideLayout2.xml

這會比手動複製 XML 檔安全得多，因為腳本會遵循 skill 既有的封裝邏輯，並印出你需要加進 presentation.xml 的 <p:sldId> 元素。

用 PptxGenJS 從零建立簡報

如果手上沒有可用範本，就改走 pptxgenjs.md 這條路。這條路最適合以下情況：

• 你能完全掌控整份 deck 的設計
• 品牌限制不重
• 你更重視可重複生成，而不是對齊既有檔案
• 你希望輸出由程式碼產生，而不是靠 XML surgery

這份指南也整理了很多真正會影響結果的細節，例如投影片 layout、座標系統，以及像 charSpacing 這類文字格式上的細節，避免你誤用不支援的替代寫法。

什麼樣的輸入才算夠強

一個偏弱的請求可能長這樣：

• 「幫我做一份 10 張、主題是市場趨勢的 deck。」

更好的 pptx guide 輸入會包括：

• audience：企業採購決策者
• purpose：董事會更新，偏向決策導向
• target length：8 張
• style：沿用既有範本，避免密集 bullet
• source materials：markdown brief、一份現有的 template.pptx
• required sections：summary、market size、risks、recommendation
• visual preference：在數據、引言、比較型版面之間交錯配置

這樣能明顯提升結果，因為 skill 可以把內容對應到版型，而不是硬把所有想法都塞進標題加條列的投影片。

適合範本型 pptx 使用的提示方式

高品質的呼叫內容通常會包含：

• 明確指定輸入的 .pptx 檔案
• 你要的是擷取、編輯還是建立
• 品牌樣式是否必須完全不變
• 哪些投影片應該沿用、哪些要替換
• 備註、留言或隱藏投影片是否要納入考量
• 想要輸出的最終檔名

例如：
「Use the pptx skill to update Q2-template.pptx. First extract text and generate thumbnails. Reuse varied layouts, not repeated bullet slides. Add 3 new slides for pricing, risks, and rollout. Preserve branding. Output an updated .pptx and summarize which source slide layouts were reused.」

值得依序閱讀的 repository 檔案

如果你想更快上手，建議照這條路徑讀：

1. SKILL.md — 指令層級的入口
2. editing.md — 範本編輯流程與版型建議
3. pptxgenjs.md — 從零建立的路徑
4. scripts/thumbnail.py — 視覺檢查是怎麼做的
5. scripts/add_slide.py — 投影片複製與從版型建立新頁
6. scripts/clean.py — 編輯後的清理邏輯

如果你是在除錯封裝問題，再進一步查看：

• scripts/office/unpack.py
• scripts/office/pack.py
• scripts/office/validators/pptx.py

會影響導入判斷的實務限制

在做這個 pptx install 決策時，請先把幾個現實面考慮進去：

• 這是一套以檔案與腳本驅動的流程，不是純對話式操作
• XML 層級編輯雖然很強，但也比單純產生文字更容易弄壞
• 範本本身的品質，會強烈影響最終成果
• 縮圖流程可能會受 LibreOffice 相關轉換行為影響
• 太省事的輸入通常只會得到很單調的投影片對應結果

如果你需要精準沿用企業範本，這個 skill 很有優勢；如果你期待只靠很薄的輸入就產出漂亮的原創設計，那就要預期需要多做幾輪調整。

pptx skill 常見問題

pptx 對新手友善嗎？

算友善，前提是你的第一個使用情境是檢查而不是編輯。先從 markitdown 和 thumbnail.py 開始。直接改 unpack 後的 XML 會比較進階，但 workflow 檔案已經能幫你少走很多摸索 Office 內部結構的冤枉路。

什麼時候該用 pptx，而不是一般寫投影片的 prompt？

當「檔案本身」很重要時，就該用 pptx：例如要保留範本結構、從真實 deck 擷取內容、原地修改投影片，或封裝出有效的 .pptx。如果你只是想要大綱或文案，根本不需要處理檔案，那一般 prompt 就夠了。

這個 pptx skill 只能拿來編輯既有 deck 嗎？

不是。它同時涵蓋範本型編輯與從零建立。如果你有範本，就看 editing.md；如果沒有，改走 pptxgenjs.md 裡的 PptxGenJS workflow。

pptx for PowerPoint 也能幫忙讀 deck 嗎？

可以。這個 skill 最值得用的一點之一，就是能快速讀取與分析 deck。markitdown 負責擷取文字，而 thumbnail.py 會提供版型與隱藏投影片的視覺盤點。

這個 skill 的主要邊界是什麼？

這個 skill 不會消除 PowerPoint 內部結構本來就有的複雜度。你仍然需要自己選好版型、刻意管理內容配置，並驗證最後輸出的 deck。它是工作流程加速器，不是保證簡報策略一定成熟的萬靈丹。

什麼情況下 pptx 不適合？

如果符合以下情況，就不建議用這個 skill：

• 你只需要敘事大綱
• 你不需要 .pptx 輸出
• 你不願意跑腳本或檢查檔案
• 你更在意原創設計，而不是保留既有簡報結構

這個 skill 支援批次或平行作業嗎？

部分支援。editing.md 的 workflow 有提到，在 deck 結構定稿後，可以在 slide XML 層級做平行編輯，因為每一張投影片本來就是獨立檔案。這對大型 deck 修訂會加快不少。

如何提升 pptx skill 的效果

先提供更好的來源素材

想改善 pptx 結果，最快的方法是提供：

• 真正可用的範本 deck
• 清楚的章節對投影片對應
• 每張投影片的來源文案
• 各章節的視覺優先順序
• 必須保留的 speaker notes 或 comments

如果沒有這些資訊，skill 還是能運作，但在投影片挑選與內容密度控制上，效果通常會弱一些。

讓內容去配版型，而不是反過來

repository 的編輯指引點出一個很常見的失敗模式：整份簡報看起來過於單調。想提升結果，最好明確要求版型多樣化：

• 用 comparison slides 呈現取捨
• 用 image-plus-text 講產品故事
• 用 quote slides 放客戶證言
• 用 number callouts 呈現 KPI
• 用 section dividers 控制節奏

這是提升 pptx skill 成果最有槓桿的一種做法。

修改前先做檢查

更好的 workflow 是：

1. 擷取文字
2. 產生縮圖
3. 把內容對應到版型
4. 然後再修改

跳過檢查步驟的使用者，常常會覆蓋錯投影片，或忽略範本裡其實早就有更合適的版型。

把結構編輯和文字編輯分開

先完成所有投影片複製、刪除與排序，再更新內容。這樣可以減少參照損壞，也避免你先改了一堆之後，最後又把那些投影片刪掉。這是這個 skill 內建流程裡最清楚、也最值得遵守的改進點之一。

給出精準到投影片層級的指示

不要只說：

• 「把這份 deck 做好一點。」

改成：

• 「把 slide3.xml 拿來做 KPI summary。」
• 「複製那張 2-column layout 當 customer segments。」
• 「只替換文字，保留 theme 和 geometry。」
• 「在第 5 與第 6 張之間新增一張 section divider。」

這類指示更符合 pptx usage workflow 真正運作的方式。

留意常見失敗模式

常見問題包括：

• 過度使用 bullet 很重的版型
• 還沒決定投影片順序就先改內容
• 忘記執行 clean.py
• 明明已經有好用的範本版型，卻另外做出不匹配的新投影片
• 只看擷取文字就以為足夠，沒有回頭檢查視覺結構

這些問題最容易讓人對輸出結果失去信心。

用懂程式碼的提示方式改善從零生成

如果你使用 PptxGenJS，建議明確指定：

• 長寬比，例如 LAYOUT_16x9
• 座標是否要一致重用
• 字體與顏色限制
• 文字方塊 padding 的預期
• 是否需要 rich text 或 multiline text

附帶的指南有整理一些會實際影響輸出品質的實作細節，例如正確處理 multiline 與 spacing 的方法。

第一輪完成後要驗證輸出品質

在產生或編輯完成後，請檢查：

• 投影片是否有足夠變化
• 文字是否有視覺上溢出的情況
• 隱藏內容或 notes 相關內容是否處理正確
• 封裝後是否仍能在 PowerPoint 正常開啟
• 這份 deck 是否真的講出一個連貫的故事，而不只是檔案結構合法

好的 pptx guide workflow 會把第一次輸出當成可再打磨的草稿，而不是終點。

使用輔助腳本，不要手動清理

如果你是手動編輯 unpack 後的檔案，請務必使用清理與 pack 工具，不要自己直接把資料夾 zip 回去。這些腳本存在的目的，就是為了清掉常見會把簡報弄壞的孤兒投影片、過期 relationship，以及殘留的 content-type 項目。

在提示裡直接點名交付物

想讓 pptx 結果更穩定，可以在請求最後明確寫出交付物，例如：

• 更新後的 client-review.pptx
• 擷取出的 markdown 摘要加上 thumbnails
• 一份新的 8 張 .pptx，使用 LAYOUT_16x9
• 保留範本風格、並插入 3 張新投影片的修訂版

這個小調整能幫 skill 更快選對路徑，也能降低執行上的模糊空間。