Communitygithub.com

Chris-yoo80/ppt-to-html-agent

將 PPT 或 PPTX 素材重建為具備階段性揭露與可選點線面動態圖形的互動式 HTML 簡報。適用於簡報轉換與疊代編輯,而非追求像素級完美的簡報複製或無關的網站建置。

ppt-to-html-agent 是什麼?

該技能旨在將 PowerPoint 簡報(PPT/PPTX)轉換為互動式 HTML 簡報,強調敘事結構與使用者互動。它並非追求像素級複製,而是專注於保留原始含義、區分事實性資料與說明性資料,並透過階段性揭露(reveal steps)與可選的「點-線-面」(point-line-plane)動態圖形來增強呈現效果。此技能支援包括 Claude Code、Cursor 或 Codex 在內的多種 AI 代理平台。運作流程包含三個主要階段:建立需求摘要(讀取設定、檢查原始檔)、規劃並創建(將投影片映射到 HTML 場景、管理動態與圖表)、驗證與交付(檢查來源忠實度、互動行為與列印/PDF 輸出)。它提供專用的參考文件(如 `references/authoring.md`、`references/motion.md`)來簡化標準工作流程,同時支援補充分析(例如 Excel 圖表),並嚴格遵循授權條款,確保最終呈現可於個人、非商業與內部組織使用中共享。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Chris-yoo80/ppt-to-html-agent/tree/HEAD/skills/ppt-to-html

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

PPT 轉 HTML 簡報代理

使用使用者的原始素材,建構一個具有明確敘事與互動性的 HTML 簡報。保留原始內容的含義,並區分來源事實與說明性資料。

建立需求摘要

在開始新的簡報之前,請先閱讀 references/intake.md。以簡短的編號形式一併詢問所需的設定。重複使用已提供的設定;僅詢問缺失的值。讓使用者可以選擇推薦的預設值作為其中一個答案。在這些設定被回答,或使用者明確委託您進行選擇之前,請勿開始渲染新的簡報。在等待回答的同時,繼續檢查原始檔案。

使用主機提供的工具檢查原始檔案。提取文字、表格、圖形、投影片順序及相關備註;當可使用投影片渲染功能時,利用它來檢查空間關係。回報無法使用的提取或渲染功能。當僅讀取了部分原始檔案時,請不要聲稱提取成功。對於無法讀取的來源,請指出具體的限制,並要求提供可存取的匯出版本。

對於可存取的 PPTX 輸入和隨附的 HTML 入門檔案,請閱讀 references/authoring.md。該文件記錄了提取與建置命令、支援的場景格式以及實際的工具限制。主機 AI 負責執行解讀與規劃;建置器則負責渲染已編寫的大綱。

規劃與創建

將原始投影片映射到提議的 HTML 場景。為每個場景識別關鍵訊息、證據、揭露步驟和合適的動態效果。保留圖表、單位和假設,使其可追溯至原始來源。明確標記範例資料;不要憑空創造結果,或將業務主張當作事實引入。

對於新的視覺方向,請先呈現場景大綱和一個代表性場景,然後再將其擴展到整個簡報。在後續編輯中重複使用先前已批准的內容。針對範圍、主張或敘述的重大變更進行詢問;獨立決定常規實作細節。

在符合需求的情況下,使用 HTML/CSS/SVG 和本地資源。保持長寬比,讓韓文換行具有可讀性,並使場景和子步驟的導航可預測。在可行的情況下,將可編輯的內容與播放邏輯分開。提供可見的「上一步/下一步」控制項及使用說明。明確選擇結束行為,而不是假設簡報應該循環播放。

當需要動態效果時,請閱讀 references/motion.md。將動態程度和播放模式視為獨立的設定。「單一檔案離線」需求包含字型、圖片和其他相依項目;在該需求下,應避免使用外部執行時期相依項目。

對於類似影片的呈現、行銷或倉儲流程場景,請閱讀 references/motion-stories.md。隨附的預設模式提供連續播放和階段控制,並使用可編輯的虛構資料;它們不是最佳化求解器或真實營運的模擬。

對於基於 Excel 的圖表、互動式篩選器或輔助/備份分析,請閱讀 references/supplemental-analysis.md。詢問工作簿位置、工作表/範圍,以及結果分析應出現的位置(其他資源、獨立 HTML,或兩者皆有),包含其相關場景和分頁標籤。重複使用已提供的答案。在開始建置分析之前先確立需求摘要,當要求時,從左側控制項和右側視覺結果開始,並在基礎版本獲得同意後再加入進階功能。將分析結果以可從簡報存取的附加 HTML 形式交付;不要默默地取代簡報或附加原始工作簿。

驗證與交付

在初始需求摘要中,詢問 PDF 輸出和備份資源檔案、其位置及分頁標籤。隨附的「列印/PDF」按鈕會列印所有場景,並顯示每個揭露步驟,每個場景為一頁 A4 橫向版面。輔助分析會分別列印其目前的篩選器和選用章節;資源不會自動合併到簡報的 PDF 中。在列印後,保留簡報的步驟並暫停自動播放。請將列印版面配置和頁數的驗證,與互動式播放的驗證分開進行。

檢查來源忠實度、每個場景/子步驟、前進/後退轉場、直接場景導航、場景變更計時器、重播以及結束行為。在議定輸出尺寸下,檢查文字裁剪、溢出、鍵盤可存取性以及減少動態行為。對於要求的列印/PDF 模式,請獨立於簡報螢幕截圖之外檢查渲染輸出。

區分靜態檢查與瀏覽器檢查。如果主機無法渲染或操作輸出,請說明限制並列出未經驗證的行為;不要將簡報描述為已通過視覺驗證。不要繞過工具的安全限制來取得渲染存取權限。

交付 HTML、可編輯的原始檔以及基於實際實作的簡短操作說明。報告哪些項目已測試,哪些項目仍未驗證。在未經檢查的情況下,不要聲稱支援 MP4 匯出、已安裝相依項目、離線支援或主機相容性。

保留套件的授權條款以及技能的副本,並在簡報輸出中保留建置器的內嵌法律聲明與授權文字。個人、非商業及內部組織使用無需付費;外部生成業務及工具的付費轉發需另行取得許可。完成的簡報可基於輸出例外條款中的溝通目的進行分享。可見的作者浮水印是一項獨立的設計選擇,並非本授權的要求。

發布範例

使用者提供的簡報是工作中的輸入項目,不會自動成為公開範例。在準備此專案的公開儲存庫時,請排除公司文件、內嵌圖片/影片、備註、隱藏資料、內部路徑以及衍生的商業內容。請使用獨立創作的虛構範例。請勿將內容發布或推送為一般轉換請求的一部分。

相關技能