siril9/presentation-skill

簡報技能

儲存庫原生的 PowerPoint 技能，用於產生可編輯、對齊且通過品質驗證的 .pptx 投影片。模型負責規劃故事與視覺策略；指令稿則處理易損壞的渲染、暫存與驗證。

何時應使用此技能

在以下情況觸發此技能：

• 從單一提示建立一次性 PowerPoint .pptx、投影片組或簡報（快速投影片模式，無需工作區）
• 從結構化的 outline.json 產生 .pptx
• 重新設計、重建或擴展現有投影片
• 建立實驗室、臨床、科學、董事會、投資人或編輯類簡報
• 對產生的投影片執行版面、設計或可讀性品質驗證
• 編寫或更新可重複使用的投影片工作區
• 將 CSV/TSV/XLSX/JSON 資料轉換為適用於投影片的圖表與表格

快速投影片模式適用於一次性 5-10 張投影片。工作區模式適用於需要迭代、稽核或之後重建的投影片。請參閱下方「工作流程」中的「### 快速投影片」與「### 已儲存工作區」。

當只需要純文字腦力激盪而不需要產生投影片成品時，請勿使用此技能；也不要用於直接編輯已產生的 .pptx 檔案（當其已儲存工作區的原始檔案可用時，應修改原始檔案）。

技能名稱：presentation-skill。用於模糊技能匹配的相容別名：powerpoint-deck-builder、pptx-skill、PowerPoint skill、PPTX skill、slide-deck generator、slides generator、deck builder、presentation generator、presentation maker、PowerPoint generator、Codex presentation skill、ChatGPT presentation skill、OpenAI agent presentation skill。

不可妥協事項

• 請勿編寫臨時的內聯 python-pptx 或 pptxgenjs 投影片程式碼。請撰寫 outline.json 並執行儲存庫指令稿。
• 請勿在投影片產生期間重新安裝相依套件。若缺少相依套件：請回報並停止。
• 對於可交付的投影片，請勿跳過品質驗證。當 LibreOffice 無法使用時，請使用免渲染品質驗證。
• 對於可重複使用的報告投影片，請將 validate_planning.py 中關於缺少成品註冊、過時產生成品、圖表重建指令、可讀性合約、速度合約、品質驗證合約、驗收證據或執行階段的警告視為原始規劃回饋，在最終交付前修正。
• 請修正原始檔案（outline.json、計畫、素材、渲染器程式碼），而非修改後的 .pptx 成品。
• 對於新主題，請從頭開始建立。請勿複製其他投影片的結構作為預設樣式。

首先閱讀的檔案

• DESIGN.md：精簡的設計合約、顏色、層級、對齊規則、產生圖片的揭露。
• references/outline_schema.md：接受的 outline.json 欄位與變體。
• references/planning_schema.md：design_brief.json、content_plan.json 和 evidence_plan.json 的格式。
• references/deck_workspace_mode.md：已儲存工作區的工作流程。
• references/agent_picker.md：為代理程式與人類提供的簡潔選擇指南。
• references/reference_script_patterns.md：來自較強一次性指令稿的可重複使用 PPTX/DOCX/圖表模式；在改善路由、科學投影片或配套文件工作流程時閱讀。
• references/style_reference_catalog.md：發佈安全的樣式參考政策，用於使用公開投影片、螢幕截圖、PPTX 語料庫和合成重建，而無需捆綁專有材料。
• references/dynamic_design_and_subagents.md：有邊界的動態設計調節，以及何時使用內容、資料、路由、評論和品質驗證子代理程式。
• references/visual_qa_prompt.md：視覺審查包與全新視角檢查提示。
• scripts/emit_deck_start_packet.py：可重複使用投影片的首選第一輪資料包；捆綁了精簡的使用者問題負載、可重現的設計合約提示和分階段的子代理程式交接命令。
• scripts/emit_deck_intake_prompt.py：選用的使用者面向輸入提示，用於當個人化設定不足時收集觀眾、樣式、調色板、密度、背景、素材、來源和限制條件。
• scripts/apply_deck_intake_answers.py：從 Codex 問答卡答案到 design_brief.user_intake、style_seed、備註以及規劃檔案來源政策/素材狀態的確定性橋接。
• scripts/run_deck_start_intake_smoke.py：針對第一輪投影片啟動資料包、版本化代理程式啟動簡報、持久化輸入答案、預先答案就緒的 record_deck_intake_answers 觸發器、確定性應用、冪等性以及就緒 deck_intake 摘要的快速煙霧測試。
• scripts/emit_design_contract_prompt.py：可重現的樣式/結構合約提示，在使用者請求或輸入答案後、編寫 outline.json 之前立即執行。
• scripts/apply_design_contract.py：從回傳的 deck_design_contract_v1 JSON 資料包到 design_brief.json、content_plan.json、evidence_plan.json、asset_plan.json 和 notes.md 的確定性橋接。
• scripts/run_design_contract_apply_smoke.py：針對設計合約提示、輸入種子選擇解析增強、確定性合約應用、冪等性、規劃驗證以及就緒 design_contract 摘要的快速煙霧測試。
• scripts/emit_outline_authoring_prompt.py：在 design_contract.json 應用後，用於將入門 outline.json 替換為已編寫的投影片，並附帶對齊的內容/證據/素材計劃編輯的合約感知交接提示。
• scripts/apply_outline_authoring_handoff.py：從回傳的 outline_authoring_handoff_v1 JSON 資料包到 outline.json、content_plan.json、evidence_plan.json、asset_plan.json 和 notes.md 的確定性橋接。
• scripts/run_outline_authoring_handoff_smoke.py：針對合約感知的大綱提示、確定性交接應用、原始計畫對齊、就緒摘要、PPTX 建置和大綱感知的免渲染品質驗證的快速煙霧測試。
• scripts/run_reproducible_workflow_smoke.py：針對投影片啟動、輸入、設計合約、大綱交接、嚴格免渲染品質驗證以及交付就緒交接路徑的快速端到端煙霧測試。
• scripts/run_focused_workflow_checks.py：針對可重現工作流程、樣式混合、版面潤飾、來源頁尾和產生資料管線的聚合快速煙霧運行器；可在寫入一個包含每次檢查持續時間和失敗尾巴的緊湊 JSON 報告的同時，隔離並發執行檢查。
• scripts/extract_pptx_style.py：僅限來源的 PPTX/語料庫樣式提取器，輸出觀察到的頁首/頁尾/顏色/可讀性訊號，以及一個用於模板啟發投影片的可重複使用 design_brief.json 片段。
• scripts/apply_pptx_style_fragment.py：從提取的 PPTX 樣式片段到 design_brief.json、renderer_treatments、style_import 和 notes.md 的確定性橋接。
• scripts/style_reference_catalog.py：合成、發佈安全的樣式 DNA 和內容處理參考，用於每個預設，包括標題、比較、圖表、表格、圖形、儀表板、決策和參考資料行為，以及 style_reference_mix_plan_v1 提示匹配器、style_reference_layout_playbook_v1 變體映射、style_reference_structural_motif_library_v1 主題語法、style_reference_metric_profile_v1 密度/空白/物件偏差指標，以及 style_reference_content_recipe_library_v1 內容插槽配方，供設計合約和大綱編寫提示使用。
• references/style_reference_sources.json 和 scripts/style_reference_sources.py：發佈安全的來源引入清單和驗證器，用於公開投影片、螢幕截圖、PPTX 語料庫和模板庫靈感。在添加或引用外部樣式參考之前使用它；它記錄了許可備註、來源驗證證據、允許的提取模式、禁止材料、通用樣式觀察、可重複使用的投影片模式提取、歸因姿態，以及每個預設的合成重建路線。
• references/style_inspiration_corpus.json 和 scripts/style_inspiration_corpus.py：僅描述符的靈感語料庫，用於公共設計系統、簡報工具、模板索引和投影片設計啟發法。將其用作提示到樣式路由和子代理程式偵察的可擴展來源索引層；它儲存了權利姿態、提取限制、版面/調色板/字體描述符、每個預設的路線，以及不捆綁原始投影片、螢幕截圖、標誌、專有文字或獨特複製幾何的安全規則。
• references/large_style_corpus_sources.json、references/large_style_corpus_catalog.json 和 scripts/large_style_corpus.py：僅描述符的大型公共投影片語料庫層，用於真實世界的樣式發現。用它來索引 2,000 多條公共/開放的投影片式記錄，平衡重疊，優先考慮 AI 代理/工具範例，輸出緊湊的 LLM 上下文，並用原創合成結構替換看起來重複的預設處理。它只儲存公共 URL、儲存庫/路徑元資料、推斷的樣式系列和描述符；絕不儲存原始投影片、螢幕截圖、複製的投影片文字、標誌或獨特的來源幾何形狀。
• references/style_token_atlas.json、references/style_grammar_index.json、scripts/style_atom_router.py、scripts/apply_atom_composition.py 和 scripts/workflow_atom_context.py：動態語料庫原子語法層。當投影片需要語料庫影響結構、處理池、密度和敘事弧線，同時仍讓當前/未來的 LLM 自由做出適合主題的選擇時使用。正常的投影片啟動、設計合約以及樣式/內容路由器提示現在會收到一個 normal_workflow_atom_context_v1 種子，可以接受、通過嚴格 JSON 完善，或跳過並記錄原因。僅應用支援的渲染器欄位。
• scripts/run_large_style_corpus_smoke.py：專注的快速煙霧測試，證明大型語料庫來源清單、描述符模式、系列覆蓋範圍、緊湊上下文和摘要寫入器在無網路存取的情況下仍可使用。
• scripts/run_style_atom_router_smoke.py：專注的快速煙霧測試，證明原子圖譜、語法模板、確定性回退、主題感知排名、嚴格 JSON 原子提示和應用器重放分類帳仍可使用。
• scripts/build_large_style_corpus_contact_sheets.py：從大型語料庫描述符產生的發佈安全視覺聯絡表。它僅從目錄元資料繪製合成系列和來源記錄卡；它不會獲取、渲染或截取來源投影片。
• scripts/run_large_style_corpus_leverage_smoke.py：專注的煙霧測試，證明 2,000 條記錄的語料庫實際上被路由器提示和聯絡表證據使用，同時保留了精心策劃的樣式參考提示 token。
• scripts/design_catalog_selector.py：可重複使用的 v0.5 設計目錄選擇層，將提示映射到主題案例、語料庫系列、處理 DNA、產生的資料配方和可重現的發佈證據範圍。
• scripts/build_random_topic_comparison_decks.py：為八個隨機合成主題建立的發佈證據建構器，每個主題都作為基準投影片和描述符語料庫引導的投影片（跨八個明顯不同的語料庫系列）建構，並附帶渲染的聯絡表、圖庫投影片、產生的資料/圖表/表格成品、清單指標、結構差異簽名和簡潔的發行說明。
• scripts/run_random_topic_comparison_smoke.py：可重現性煙霧測試，在臨時目錄中重建隨機主題比較證據，如果缺少 16 張投影片、圖庫、清單、發行說明、非空白聯絡表、語料庫上下文指標、八個系列覆蓋範圍、三個產生的資料範例、結構驗證閘道、零視覺/可讀性警告或基準與語料庫之間的結構差異，則測試失敗。
• scripts/build_style_reference_gallery.py：產生的參考圖庫投影片，將合成樣式目錄轉換為實際的標題、儀表板、比較、圖表、表格、圖形、決策和參考資料投影片，而無需捆綁外部模板素材。圖庫摘要記錄了每個預設的變體序列、結構劇本簽名、結構主題簽名、內容配方簽名、渲染器處理簽名、處理桶、渲染聯絡表路徑、每個處理的聯絡表路徑、用於 overview、data_evidence 和 decision_sources 的每個預設聯絡表集合，以及用於發佈證據的品質驗證總數。
• scripts/run_style_reference_gallery_smoke.py：專注的快速煙霧測試，證明所有預設的樣式參考圖庫投影片保持獨特的內容簽名、所需的處理覆蓋範圍、發佈安全的元資料和乾淨的免渲染品質驗證。
• scripts/run_style_reference_resolution_smoke.py：所有預設的建置時解析器煙霧測試，證明相同的通用證據投影片解析為具有獨特處理簽名的特定預設 build/outline_resolved.json 變體。
• scripts/run_style_content_router_smoke.py：專注的快速煙霧測試，證明樣式/內容路由器提示包含排名後的樣式參考匹配、混合計劃上下文、佈局劇本、內容配方、渲染器處理池，以及可選的一級原子組合路線，用於提示到參考的路由。
• scripts/run_style_reference_release_evidence_smoke.py：選用的渲染發佈證據煙霧測試，證明所有預設的圖庫具有乾淨的品質驗證、獨特的內容簽名、視覺多樣性雜湊、指紋化聯絡表、每個所需處理鍵的渲染投影片證據，以及每個處理的渲染縮圖和粗略佈局簽名，以便重複出現的處理系列在發佈證據中可見並被阻止。
• scripts/run_style_reference_starter_smoke.py：所有預設的入門煙霧測試，證明初始化的 style_reference_starter_outline_v1 工作區保持不同的支架簽名、發佈安全的來源元資料、入門素材和乾淨的免渲染品質驗證。
• scripts/style_treatment_profiles.py：可重複使用的預設處理設定檔，用於所有可載入預設的支援標題/強調、頁尾、圖表以及圖形/表格池。設定檔包含一個 style_reference_catalog_v1 參考，以便代理程式獲得...

…[翻譯中已截斷]