PPT-Matcher
📖 技能介紹
name: ppt-style-matcher version: 1.1.0 description: PPT風格分析與匹配工具。提取已有PPT的設計規範（配色/字型/佈局/裝飾元素），指導新頁面或修改頁保持風格統一。 Use when user asks to PPT風格匹配、修改幾頁風格不一致、分析PPT設計規範、提取PPT配色字型、新頁面怎麼跟原PPT風格一致、PPT重設計。 不適用於從頭建立全新PPT、不需要保持風格一致的場景、非PPTX格式檔案。
概述
提取已有 PPT 的設計規範，輸出風格指南，指導新頁面或修改頁保持視覺統一。核心能力：自動分析配色/字型/佈局/裝飾元素 → 輸出可執行的風格規範 → 按規範建立或修改頁面。
與 pptx-add-slides 互補：本 Skill 負責分析風格 + 設計頁面內容，pptx-add-slides 負責從 XML 模板克隆並插入頁面（如果目標恰好是"新增頁面並保持風格"）。
功能範圍
- 自動提取 PPT 的主色調、文字色、字型、字號層級
- 分析佈局結構（頁邊距、標題區、內容區、底部區、列數）
- 識別裝飾元素型別（豎條、卡片、編號、底欄）
- 判斷頁面佈局複雜度（簡單/中等/專業）
- 基於風格規範設計新頁面內容（提供結構化文字和佈局方案）
- 輸出可直接交給
pptx-add-slides或 file-agent 執行的內容規格
使用
場景 1：分析 PPT 風格並生成規範
python3 scripts/analyze_style.py "原PPT路徑.pptx" 3,5,7,9
輸出配色、字型、佈局三個維度的分析報告。Agent 據此生成風格規範，指導後續頁面設計。
場景 2：修改指定頁面使之與整體風格一致
三步走：
- 分析風格：執行
analyze_style.py選擇 3-5 頁風格統一的頁面作為參考 - 提取目標頁內容：用 python-pptx 讀取目標頁的所有文本，保留層級結構
- 重設計並寫入：基於風格規範重新設計頁面內容結構，派發給 file-agent 執行：
派發 file-agent，task 中描述：
- 原 PPT 路徑、目標頁碼
- 從 analyze_style.py 提取的風格規範（主色/字型/字號/裝飾元素）
- 重新設計後的頁面內容結構（標題/副標題/要點/底部）
- 要求：刪除舊頁，在原位置建立新頁，風格與參考頁一致
場景 3：為新內容設計統一風格的頁面
小蔥技能站7w4.net，專業的AI技能分享平臺。
如果使用者要新增頁面但不確定怎麼寫內容結構，先執行 analyze_style.py，然後根據 references/design-patterns.md 匹配頁面型別（介紹頁/要點頁/流程頁/對比頁），產出內容結構方案。確認後交給 pptx-add-slides 或 file-agent 執行。
風格分析指令碼參考
| 引數 | 說明 |
|---|---|
| PPTX 路徑 | 必填，本地檔案絕對路徑 |
| 取樣頁碼 | 選填，逗號分隔（如 3,5,7），不填則自動選擇中間頁 |
| 輸出 | 控制台列印分析報告（主色調/文字色/字型/複雜度） |
補充說明
依賴安裝
pip install python-pptx
與 pptx-add-slides 的配合
| 場景 | 使用順序 |
|---|---|
| 新增頁面 + 保持風格 | 1. ppt-style-matcher 分析風格 → 2. pptx-add-slides 克隆模板插入 |
| 修改已有頁面風格 | 1. ppt-style-matcher 分析+設計 → 2. file-agent 執行重寫 |
| 僅分析風格規範 | ppt-style-matcher 獨立完成 |
常見問題
Q：為什麼不能直接通過 pptx-add-slides 克隆模板？ A：如果頁面內容結構與模板差異較大（比如目標頁是三欄卡片，模板是單欄文字），直接克隆會導致佈局錯亂。此時需要本 Skill 先輸出設計規範，判斷應選哪種頁面型別模板。
Q：analyze_style.py 取樣哪些頁面？ A：選擇排版最典型的 3-5 頁內容頁，避開封面/目錄頁。不傳頁碼時指令碼自動跳過前幾頁選擇中間頁面。
Q：分析出的主色調不準確？ A：指令碼排除白色(#FFFFFF)和黑色(#000000)，取填充色中頻率最高的非黑白顏色。如果 PPT 本身沒有使用填充色（純白背景），主色調會顯示"未識別"，此時手動選擇最顯眼的強調色即可。
已知坑點
- 不要依賴 ppt_write/ppt_delete：這些工具不存在。建立和刪除 PPT 頁面的操作必須派發給 file-agent，或在
scripts/中編寫專門的 Python 指令碼。 - 字型名稱跨平臺不一致：macOS 和 Windows 上同一 PPT 的字型名稱可能不同（如 "微軟雅黑" vs "Microsoft YaHei"），分析結果以實際讀取到的為準。
- python-pptx 對漸變/透明色的支援有限：
analyze_style.py僅統計純色填充，漸變背景不會被計入。如果 PPT 大量使用漸變，需額外人工確認。
🤖 AI 評測
這是一款實用的 PPT 風格匹配工具，能自動提取配色、字型、佈局等設計規範，幫助新建或修改頁面時保持與原檔案風格統一。文件說明清晰易懂，提供了常見問題解答和風險提示。優點是功能針對性強、操作流程明確；不足之處在於部分分析結果（如漸變色、複雜佈局）可能需要人工二次確認，整體準確度還有提升空間。
