youquan-he/ppt-template-animator

從素材與對話出發製作 PPT

目標是做出符合使用者目的、內容完整、可編輯且動畫得當的簡報稿。範本可以提供整頁、局部元件或動畫方法；它不決定最終內容與頁型。執行以下五項流程，再進行內容、視覺和動態驗收。安裝與自包含範例見 README.md，腳本參數見 production-tools.md。設計規格、中文排版、分鏡與複核方法見 design-and-review.md；這些方法已整理在本套件內，不依賴額外安裝來源 Skill。

先判斷任務是新稿創作、參考範本重組、嚴格沿用範本，還是僅排版潤色。遵守本次任務範圍：使用者允許拆解時可以原創重組；明確要求保真或僅排版時，不擅改內容、頁序和母版。不能將其他 Skill 的固定範本、強制工具或生成整頁圖片流程當作所有任務的預設規則。

若本目錄存在 preferences.local.json，先讀取其中的本機範本目錄、視覺偏好及已研究動畫記錄；它們是使用者預設偏好，最新任務的明確要求優先。沒有該檔案時按本次請求選擇風格，不假定擁有作者的私人範本庫。配置範例見 preferences.example.json。

使用者要求「精美動畫、流暢、高級動態、炫酷」時，先走 高級動畫製作：研究指定動態庫的源連續序列 → 確定可遷移機制與視覺方向 → 原生保留或重建 → 替換/組合內容 → 播放驗收。在分鏡中先確定動畫機制及所需物件/狀態，再設計承載內容的版型；不能先做一套普通靜態稿，最後批量加入淡入或飛入來交差。基礎動效仍可用於輔助說明，不能代替使用者要求的核心高級效果。

需要「滾動文字、吃角子老虎機式開場、競選職位揭示」時，按 滾動文字開場方法 組織可編輯文字列、視窗遮擋、搖桿與聲音，並在目標稿中實播核對；它是可選的場景機制，不是所有封面的預設樣式。

當使用者給出參考影片、指定範本頁，或要求以後用「效果 x」重現已調好的動畫時，按 從影片到可複用效果 記錄可觀察的物件、狀態與時間順序，結合來源 PPTX 核對參數，製作並驗證可編輯的目標稿。影片只能證明畫面中看得到的效果；缺少原始檔案時不要把推斷寫成精確參數，也不要把第三方作者的插件、私人路徑或整段提示詞變成此 Skill 的依賴。

可優先呼叫既有範本，但須在呼叫的範本中增加動畫。 對動畫製作任務，先選擇適合主題的整頁或元件，再結合新內容新增有意義的原生物件動畫或連續場景；範本原本已有動畫也不能只換字換圖交付。保留仍適用的原時間軸，並記錄新增位置、物件、作用和播放結果。明確要求靜態、僅排版或嚴格禁止新增動畫的任務，遵從該次要求。

1. 保證提供的素材有實際去向

• 查看本次請求及相關歷史對話，列出使用者交付的檔案、圖片、數據、文字、必講觀點和此前指出的問題。區分內容素材、設計/動畫參考、背景資料；使用者對用途的明確說明優先。不要把包含數百份備選範本的資料庫誤判為需要全部塞進簡報稿的內容。
• 在工作目錄建立素材台帳，按獨立圖片、表格、數據集、章節或必講知識點登記；長文件展開到足以發現遺漏的頁碼/章節/圖表層級。使用 material-ledger.md 的欄位。
• 使用者提供的內容素材預設全部安排進正文或附錄，並映射到最終頁碼與具體物件/段落。閱讀過、下載過、寫在計畫裡或只放來源連結，都不能算已應用。要求展示的圖片和數據不能只藏在備註裡。
• 可以融合表達，但台帳須保留每份材料的貢獻與位置。裁切、重繪、摘要應保留關鍵證據和原意；不得用泛化配圖或生成圖片替換使用者要求展示的原圖。
• 重複、模糊、無法開啟、不相關或相互矛盾的材料不能無聲遺漏。記錄問題和處理方案；要求全部使用時，不得自行排除。若時間/頁數與完整呈現衝突，先形成正文加附錄方案，再就無法相容的約束詢問使用者。

2. 從對話判斷需求與主題

• 選範本前寫一份簡短 brief：目的、觀眾、場景、核心主題、一句話主張、必須覆蓋的素材、篇幅/長度、語言、交付格式和視覺氣質；說明主要供現場講述、獨立閱讀還是兼顧兩者。最新明確指示與已確認的偏好優先於範本範例。
• 區分「明確要求」「合理推斷」「仍不確定」。根據內容及場景確定主題，不能只憑檔案名稱、範本名稱或第一張圖片判斷。資訊足以行動時採用合理預設值，不重複詢問使用者已經說過的事。
• 先做敘事大綱，再選頁型。每頁寫明：回答什麼問題、觀眾要記住什麼、用哪些素材作證、採用何種構圖、動畫幫助理解什麼。內容頁優先使用結論或問題型標題，證據要說明對觀眾的意義；結尾回應開頭的問題。
• 現場稿的分鏡記錄預計講述時間、初始狀態、每次點擊、閱讀停留和轉場，核對整場時間，不能機械地按每頁一分鐘。講述提示、製作說明和內部時間預算留在備註或工作文件，頁面文字面向最終觀眾。
• 複用使用者在當前任務中的回饋，特別注意範本單調、動畫機械、圖文擁擠等問題。修改既有稿時，先定位問題及受影響頁，再決定局部調整或重新設計。

3. 學習範本的設計和動畫方法

• 複用既有範本索引，必要時執行 template_catalog.py scan。動畫數量、圖片面積等統計只用於篩選，不能據此宣布範本精美。
• 使用者指定動態參考庫時，先在其中尋找適合目標敘事的連續場景；透過 study_motion.py 研究路徑、旋轉、縮放、同步/錯峰、遮罩及 Morph 狀態。既有學習記錄只縮短檢索，實際原始檔案及適用性仍需核對。
• 大型庫中比較至少三個適合主題的設計系列，既看封面，也測試最難排的證據圖、對比頁和流程頁。以全尺寸 PNG、整稿縮圖和實際播放效果作判斷。
• 「色彩豔麗、主題鮮明」是明確視覺要求：選擇有表現力的主輔色、主題影像/圖形和大尺度構圖，先展示真實內容的封面及代表性內容頁。不要未經理就退回黑灰白加一個小強調色，也不要用堆砌彩色裝飾代替主題表達；品牌、嚴肅場景或使用者本次明確要求可改變此方向。
• 選定方向後建立全稿設計規格：主題氣質、背景、中文/西文字型、字型大小層級、語義顏色、間距、影像處理和密度。使用拆解工具的主題/直接樣式報告，並對照渲染圖；固定視覺規則、按內容變化構圖。先驗證有代表性的困難頁面，再擴展整稿。
• 記錄可遷移的「動畫方案」：來源範本及頁碼、物件、初始狀態、觸發順序、時間長度/延遲、運動方向、物件關係、最終狀態和適用場景。透過時間軸和播放學習，不能只照抄效果名稱。
• 按語義遷移動畫：逐步揭示用於過程；同步出現用於公平對比；連續縮放/移動用於總覽到細節；強調用於指出重點。根據新素材尺寸、位置和閱讀時間重新設定參數，避免給所有物件套用同一種飛入。
• Morph、運動路徑、觸發器和組合物件可能依賴相鄰頁或其他形狀。保留所需關係，遷移後重新綁定並播放驗證。靜態截圖和轉場不等同於頁內物件動畫。
• 對高級動畫請求，工作檔案記錄「原始檔案/連續頁、機制、目標場景、保留/遷移/重建策略、物件與觸發、實際實現及播放證據」。要區分頁內複雜編排與完整跨頁 Morph 場景：二者都可構成高級動畫；單獨一個頁面切換或 effect_count > 0 都不能證明已經滿足要求。

4. 拆解範本，再按主題重新組合

• 整頁合適時可以改編整頁；需要新構圖時可以直接提取局部元素，不必等到所有範本都失敗後才原創。複用物件包括圖形、圖示、圖片框、分組、流程元件、可編輯圖表、配色、字型層級和動畫結構。
• 使用 decompose_template.py inspect 查看全部形狀、組內物件、關聯主題的字型/配色與物件直接樣式；使用 extract 按頂層形狀 ID 匯出可編輯元件 PPTX、引用圖片、來源頁/元件預覽、設計和動畫報告。命令及限制見 production-tools.md。
• 原始圖片、SVG 等可獨立使用；形狀、分組和圖表儲存在元件 PPTX 中繼續編輯。不要把整頁截圖當作「已拆解範本」，也不要把裸 XML 當作可直接跨檔案複製的元件。
• 保留元件來源、頁碼、形狀 ID、用途和動畫依賴。範本範例中的數據、文字、品牌與觀點只是佔位內容，不能成為新稿事實。
• 圍繞新主題重新安排層級、尺寸、位置、配色和留白；跨範本複用時統一視覺體系。變更元件後檢查連線、標籤、裁切和運動路徑。在目標稿中重新驗證編輯能力與動畫，不能只驗證元件檔案。
• 元件依賴母版、字型、互動觸發器或前一頁時，記錄並處理依賴。不能可靠保留的部分用原生物件重建；說明實際實現，不聲稱完全保留。

5. 按實際缺口補充其他方法

• 使用者範本與輔助腳本不是能力上限。先確定缺少的是事實、圖像、結構圖、視覺參考還是動畫實現，再選擇對應方法，避免無目的地搜集。
• 可以檢索公開設計案例、官方技術資料和可用素材；也可以採用原生形狀/圖表、SVG、程式繪圖、可用的圖像生成工具或其他適合的方法。基於真實內容重新繪製結構圖時保留原意；生成示意圖須與真實證據區分。
• 若使用者配置了額外 Skill 或歸檔目錄，遵循其規則按需讀取相關說明；本套件沒有固定的個人目錄或其他 Skill 的執行依賴，不會自動安裝或批量啟用無關 Skill。
• 外部事實使用適合主題的可靠來源並核實；技術實現優先使用官方文件。保留外部素材的出處、使用條件和用途。補充內容不能擠掉使用者必用素材，也不能未經授權將私有素材上傳外部服務。
• 新方法先在一個代表性範例上驗證編輯能力、顯示和播放表現，再擴展至整稿。若工具只支援靜態或不相容某效果，準確說明並採用可驗證的實現。

製作與驗收

1. 內容：依最終檔案回查素材台帳，確認每項必用內容實際出現，關鍵部分未被裁掉；核對數據、引用、主題和演講主線。有未解決遺漏時不能宣稱「全部應用」。
2. 設計與敘事：依參考中的視覺、敘事/理解、文字/事實三條線分別複核，記錄問題所在頁和物件、嚴重度、修復與複核結果。每頁全尺寸檢查字型、換行、清晰度、裁切、重疊及留白；縮圖檢查整稿節奏。中文缺字、標點、數值單位、圖表及組內文字單獨核對。擁擠頁按概念均衡拆分，不能縮小字型或編造內容填滿版面。
3. 動態：實際播放或檢查可用播放記錄，核對初始狀態、每次點擊、圖與標籤同步、停留時間、轉場及 Morph 連續性。高級請求還須逐項回查計畫中的核心機制確實進入成品、服務於內容；不能只讓封面動起來而內容頁全面退回基礎效果。靜態預覽、XML 數量和腳本成功不能證明播放品質；未完成的動態檢查應如實說明。
4. 檔案：用 PowerPoint 原生重新開啟最終 PPTX，確認可編輯文字、素材、備註和原生動畫。建構器報告 native_validated: false 時，仍需原生開檔驗收。必須修復素材遺漏、事實/數據錯誤、不可讀或截斷的關鍵內容、損壞檔案及遺失必要動畫等阻斷問題；不能用評分平均值抵銷。
5. 交付：提供最終 PPTX，簡述素材覆蓋、設計與動畫選擇及實際驗證範圍。目錄索引、台帳、拆解元件、腳本和中間預覽留在工作目錄，除非使用者需要附加產物。