pptx

Overview

pptx skill 的用途

pptx skill 是為所有會接觸 PowerPoint .pptx 檔案的工作流程而設計。依照儲存庫中的指引，只要使用者需要開啟、建立、檢查、修改、合併、拆分或以其他方式處理簡報檔案，它都是預設選擇。因此，它很適合用於投影片製作、辦公文件處理，以及 PowerPoint 專用的自動化流程。

這個 skill 支援多種實務工作情境：

• 讀取並擷取簡報內容
• 產生投影片的視覺化縮圖總覽
• 將 .pptx 檔案解包成可編輯的 XML 組件
• 依既有範本編輯現有簡報
• 從零建立投影片或完整簡報
• 清理已解包簡報後，再重新封裝為有效的 .pptx
• 使用內建的 Office 導向工具驗證 PowerPoint 結構

誰適合使用 pptx

如果你的工作涉及以下情境，就適合使用 pptx：

• 商務簡報與提案 deck
• 依現有範本進行內部投影片更新
• 從 PowerPoint 檔案擷取內容
• 在以 CLI 為主的環境中執行自動化簡報流程
• 對 Office 文件進行 XML 層級編輯
• 需要檢查或重寫投影片內容的 AI 或 agent 工作流程

對使用 Anthropic 導向 agent 工作流程的人來說，它特別相關，因為這個儲存庫本身屬於 anthropics/skills，而此 skill 也被寫成可重複使用的簡報作業指引。

這個 skill 能解決哪些問題

當一般檔案轉換或基本匯出工具不敷使用時，pptx 就很有價值。例如，當你需要：

• 了解簡報中的文字與結構
• 在編輯前快速查看投影片版面
• 重用品牌範本，而不是從頭開始
• 在已解包的簡報中複製或新增投影片
• 直接編輯投影片 XML，以進行精準修改
• 在結構調整後移除孤立檔案
• 在修改完成後乾淨地重建簡報封裝

儲存庫內容顯示，這套流程涵蓋 markitdown、縮圖產生、解包、編輯、清理與重新封裝，因此最適合把這個 skill 理解為一套實用的 PowerPoint 工作流程工具箱，而不是單一腳本。

儲存庫包含哪些內容

已公開的檔案顯示，pptx skill 包含：

• SKILL.md：快速參考工作流程
• editing.md：依範本編輯的操作指引
• pptxgenjs.md：使用 PptxGenJS 從零建立簡報的說明
• scripts/thumbnail.py：產生投影片縮圖格狀總覽
• scripts/add_slide.py：複製投影片或依版面建立新投影片
• scripts/clean.py：移除已解包簡報中未被參照的檔案
• scripts/office/unpack.py 與 scripts/office/pack.py：用於開啟與重建 Office 封裝
• scripts/office/validate.py 與 scripts/office/validators/pptx.py：提供驗證相關工作流程支援

什麼時候適合用 pptx

以下情況建議選擇 pptx：

• 輸入或輸出明確就是 .pptx 檔案
• 你需要的不只是截圖或單純匯出流程
• 你希望同時檢查內容與結構
• 你需要能理解範本結構的編輯方式，而不是產生通用型投影片
• 你想用 CLI 驅動步驟，建立可重複執行的流程

什麼時候 pptx 可能不是最佳選擇

以下情況這個 skill 可能較不適合：

• 你只是想在 PowerPoint 或其他 GUI 應用程式中手動檢視簡報
• 你需要的是通用辦公軟體教學，而不是 PowerPoint 專屬流程
• 你不想處理檔案封裝、XML 組件或腳本式編輯
• 你的工作流程完全不涉及 .pptx 檔案

開始前的安裝說明

請使用以下指令安裝：
npx skills add https://github.com/anthropics/skills --skill pptx

在使用 pptx 前，最好先知道儲存庫範例中也引用了數個外部工具或函式庫，包括 markitdown、PptxGenJS，以及在縮圖流程中透過 soffice 提供的 LibreOffice 相關轉換支援。這些工具的環境設定與 skill 本身的安裝是分開的，因此實際導入時，除了安裝 skill，也要一併規劃工作流程所需的執行環境與相依元件。

授權與使用注意事項

儲存庫內含 LICENSE.txt，其中列有 Anthropic 的專有授權條款。若你打算在正式環境中採用這個 skill，特別是在評估重用、保留或再散布限制時，請先仔細閱讀該檔案。

How to Use

安裝 pptx skill

使用標準 skills 指令安裝 pptx：
npx skills add https://github.com/anthropics/skills --skill pptx

安裝後，建議先閱讀以下檔案：

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

這些檔案與儲存庫提供的主要使用路徑高度對應。

先從快速參考工作流程開始

儲存庫的快速參考將使用方式分成三個實用入口：

• 讀取或分析內容
• 依範本編輯或建立
• 從零建立

這也是最適合用來判斷你該走哪一條路徑的方式。

如果你手上已有現成簡報要檢查或修改，建議先從讀取與縮圖開始。若你是要套用品牌簡報進行調整，請依照編輯工作流程進行。若你沒有任何範本，則可使用 pptxgenjs.md 中說明的 PptxGenJS 路線。

讀取與分析 PowerPoint 檔案

若要擷取內容，儲存庫建議使用：
python -m markitdown presentation.pptx

當你想檢查投影片文字、摘要整理整份簡報、查看 placeholders，或將內容匯入其他工作流程時，這個方式很實用。

若要取得視覺總覽，可使用：
python scripts/thumbnail.py presentation.pptx

根據腳本標頭說明，這會建立投影片縮圖格狀總覽，並在每張縮圖上標示 XML 檔名，例如 slide1.xml。在正式編輯前這特別有幫助，因為你可以快速把投影片畫面與底層 XML 組件對應起來。

如果你需要直接查看原始結構，請先解包檔案：
python scripts/office/unpack.py presentation.pptx unpacked/

這會提供進行 XML 層級修改所需的封裝內容。

依範本編輯現有簡報

儲存庫在 editing.md 中明確建議採用範本式工作流程。

實務上的順序可以是：

1. 用 thumbnail.py 和 markitdown 分析來源範本。
2. 決定哪些既有版面要對應到新的內容。
3. 解包 .pptx。
4. 先進行結構調整。
5. 編輯投影片 XML 檔中的文字。
6. 清理解包後的目錄。
7. 再把目錄重新封裝成 .pptx。

editing.md 的指引特別實用，因為它提醒你避免讓整份簡報過於單調，並鼓勵採用多樣版型，例如多欄投影片、圖文搭配投影片、引言頁、章節分隔頁與數據重點頁。這也讓 pptx 不只是低階檔案工具，而是同時支援更好簡報製作決策的工作流程。

在已解包的簡報中新增或複製投影片

當你需要在已解包的簡報中建立新投影片時，可使用 scripts/add_slide.py。

從儲存庫內容可看出，它支援兩種模式：

• 複製既有投影片 XML 檔，例如 slide2.xml
• 依版面檔建立投影片，例如 slideLayout2.xml

這個腳本會輸出你需要加入 presentation.xml 的 <p:sldId> 元素，這對結構編輯來說是很實際的細節。

如果你是從範本重建簡報，並希望保留版面一致性，這會非常有幫助。

在結構修改後進行清理

請使用：
python scripts/clean.py unpacked/

根據腳本說明，clean.py 會移除孤立的投影片、關聯、未被參照的媒體與相關資源、註解投影片、主題檔，以及已刪除檔案對應的 content-type overrides。這一步在刪除或重新排列投影片後尤其重要，因為 PowerPoint 封裝在手動編輯時很容易累積失效參照。

如果你打算直接操作 XML，這個清理步驟正是使用 pptx 而非臨時用 zip 方式硬改的主要理由之一。

重新建立簡報封裝

完成編輯與清理後，請用以下指令重新封裝簡報：
python scripts/office/pack.py unpacked/

儲存庫中的編輯流程把重新封裝安排在清理之後；若你做過結構性修改，這樣的順序會更安全。

從零建立簡報

如果你沒有可用的範本或參考簡報，儲存庫會導向 pptxgenjs.md。

這份指南使用 PptxGenJS，示範如何建立簡報、設定版面數值、加入投影片、插入文字，以及輸出最終 .pptx 檔案。範例也涵蓋了像是 charSpacing、rich text 陣列、多行文字處理與版面尺寸等格式細節。

以下情況特別適合這條路徑：

• 品牌限制較少，或可完全以程式控制
• 你是根據結構化資料產生簡報
• 你偏好以程式為主的簡報生成方式，而不是範本編輯

常見的 pptx 工作流程模式

pptx 常見的使用方式包括：

• 從客戶或內部簡報中擷取文字供審閱
• 先產生縮圖，再了解簡報內容後進行修改
• 重用品牌簡報作為新受眾版本的範本
• 在每張投影片可獨立處理時，平行編輯投影片 XML
• 在沒有範本時，用 PptxGenJS 產生全新簡報
• 在 CLI 工作流程中解包並驗證 Office 文件內部結構

值得查看的檔案與資料夾

如果你正在評估是否安裝，或日常使用這個 skill，以下儲存庫路徑最值得優先查看：

• SKILL.md
• editing.md
• pptxgenjs.md
• scripts/thumbnail.py
• scripts/add_slide.py
• scripts/clean.py
• scripts/office/unpack.py
• scripts/office/pack.py
• scripts/office/validate.py
• scripts/office/validators/pptx.py

對團隊與 agents 的實用性

pptx 很適合整合進需要可重複 CLI 流程的 agent 或工作流系統，用來處理 PowerPoint 檔案。從儲存庫結構可以看出，它清楚區分了總覽說明、編輯指引、建立說明與輔助腳本。相較於單一、缺乏文件的腳本集合，這種設計更容易被導入半自動化的簡報產線。

FAQ

pptx skill 主要是拿來做什麼的？

pptx skill 是用來處理 PowerPoint .pptx 檔案，涵蓋讀取、編輯、建立、解包與重新封裝等工作流程。儲存庫指引指出，只要輸入、輸出或兩者都涉及 .pptx 檔案，就可以使用它。

要怎麼安裝 pptx？

請使用以下指令安裝：
npx skills add https://github.com/anthropics/skills --skill pptx

安裝後建議先看 SKILL.md，再依你是要編輯現有簡報還是建立新簡報，接著閱讀 editing.md 與 pptxgenjs.md。

pptx 可以從簡報中擷取文字嗎？

可以。儲存庫的快速參考指出，可使用 python -m markitdown presentation.pptx 來讀取與分析內容。

pptx 可以產生投影片縮圖嗎？

可以。scripts/thumbnail.py 會產生投影片縮圖格狀總覽，方便快速進行視覺分析。腳本說明提到，它會用 XML 檔名標示縮圖，並以預留樣式顯示隱藏投影片。

我可以用 pptx 編輯既有簡報，而不是重做一份新的嗎？

可以。這正是它支援的主要工作流程之一。editing.md 說明了以範本為基礎的流程，包括分析現有簡報、解包、調整結構、編輯投影片 XML、清理未參照組件，最後再重新封裝成 .pptx 檔案。

pptx 支援從零建立簡報嗎？

支援。儲存庫內含 pptxgenjs.md，說明如何在沒有範本或參考簡報時，透過 PptxGenJS 以程式方式建立簡報。

pptx 只是用來擷取文字嗎？

不是。文字擷取只是這個 skill 的其中一部分。從儲存庫內容也能看出，它同時支援縮圖、解包、XML 編輯、投影片複製、清理、重新封裝，以及驗證相關工具流程。

使用 pptx 一定要碰 XML 嗎？

不一定，但許多編輯流程確實會依賴已解包的 Office XML 檔案。如果你是透過 PptxGenJS 從零建立簡報，大多可以停留在 JavaScript 層；但若你要精準修改品牌範本，XML 層級編輯就是這個工作流程的一部分。

什麼情況下應該選 pptx，而不是一般的投影片工具？

當 PowerPoint 檔案本身就是你的主要工作成果，而且你需要精準處理 .pptx、重用範本、進行結構感知編輯，或執行封裝層級操作時，就應該選 pptx。如果你的工作重點明確是 PowerPoint、投影片 deck 與 Office 文件封裝，這個 skill 會很合適。

有沒有需要注意的授權問題？

有。儲存庫包含一份專有的 LICENSE.txt，其中列有 Anthropic 條款與額外限制。若你要在一般服務內使用之外的情境導入 pptx，請務必先仔細閱讀該檔案。