Communitygithub.com

David-Li0406/meta-skill-evloving

簡報的建立、編輯與分析:用於 Claude 處理 .pptx 檔案的各種任務,包括建立新簡報、修改內容、處理版面配置、新增註解或備忘錄等。

meta-skill-evloving 是什麼?

此技能專為 AI 代理(如 Claude Code、Cursor、Codex)設計,提供完整的 PowerPoint 簡報處理能力。它支援三種主要工作流程:從無到有建立新簡報(使用 html2pptx 方式)、使用既有範本建立簡報,以及編輯現有簡報。對於新簡報的建立,技能強調設計原則,包括根據內容選擇配色方案、視覺細節處理,以及確保版面的可讀性與一致性。編輯功能則透過操作 OOXML 底層 XML 來進行精確修改,並提供驗證與打包工具。此技能也包含內容分析功能,例如文字提取與圖像化縮圖檢視,讓您可以全面掌握簡報的結構與設計。支援的檔案包括 .pptx、.ppt 格式。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/David-Li0406/meta-skill-evloving/tree/HEAD/AgentSkillOS/data/skill_seeds/pptx

在你喜歡的 AI 中提問

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

說明文件

PPTX 建立、編輯與分析

概述

使用者可能會要求您建立、編輯或分析 .pptx 檔案的內容。.pptx 檔案本質上是一個 ZIP 壓縮檔,內含 XML 檔案與其他資源,您可以讀取或編輯這些內容。針對不同的任務,您可以使用不同的工具與工作流程。

讀取與分析內容

文字提取

如果您只需要讀取簡報的文字內容,請將文件轉換為 Markdown 格式:

# 將文件轉換為 Markdown
python -m markitdown path-to-file.pptx

原始 XML 存取

若要處理註解、備忘錄、投影片版面配置、動畫、設計元素與複雜格式,您需要存取原始 XML。對於這些功能,您必須先解壓縮簡報,然後讀取其原始 XML 內容。

解壓縮檔案

python ooxml/scripts/unpack.py <office_file> <output_dir>

注意:unpack.py 腳本位於專案根目錄的 skills/pptx/ooxml/scripts/unpack.py。如果該路徑下沒有這個腳本,請使用 find . -name "unpack.py" 來尋找。

關鍵檔案結構

  • ppt/presentation.xml - 主要簡報中繼資料與投影片參考
  • ppt/slides/slide{N}.xml - 個別投影片內容 (slide1.xml、slide2.xml 等)
  • ppt/notesSlides/notesSlide{N}.xml - 每張投影片的備忘錄
  • ppt/comments/modernComment_*.xml - 特定投影片的註解
  • ppt/slideLayouts/ - 投影片的版面配置範本
  • ppt/slideMasters/ - 投影片母片範本
  • ppt/theme/ - 主題與樣式資訊
  • ppt/media/ - 圖片與其他媒體檔案

字型與色彩擷取

當需要模仿指定的設計範例時:請務必先使用下列方法分析簡報的字型與色彩:

  1. 讀取主題檔案:檢查 ppt/theme/theme1.xml 中的顏色 (<a:clrScheme>) 與字型 (<a:fontScheme>)
  2. 取樣投影片內容:檢查 ppt/slides/slide1.xml 中實際使用的字型 (<a:rPr>) 與顏色
  3. 搜尋模式:使用 grep 在所有 XML 檔案中尋找顏色 (<a:solidFill>, <a:srgbClr>) 與字型的參考

不使用範本建立新的 PowerPoint 簡報

若要從無到有建立新的 PowerPoint 簡報,請使用 html2pptx 工作流程,將 HTML 投影片轉換為 PowerPoint,並確保定位精準。

設計原則

關鍵:在建立任何簡報前,請先分析內容並選擇合適的設計元素:

  1. 考慮主題:這份簡報的主題是什麼?它暗示了什麼樣的調性、產業或氛圍?
  2. 檢查品牌:如果使用者提到某家公司/組織,請考慮他們的品牌色彩與識別
  3. 配色符合內容:選擇能反映主題的顏色
  4. 說明您的做法:在編寫程式碼之前,解釋您的設計選擇

需求:

  • ✅ 在編寫程式碼之前,說明您根據內容做出的設計選擇
  • ✅ 僅使用網頁安全字型:Arial、Helvetica、Times New Roman、Georgia、Courier New、Verdana、Tahoma、Trebuchet MS、Impact
  • ✅ 透過大小、粗細與顏色建立清晰的視覺層次
  • ✅ 確保可讀性:強烈對比、適當大小的文字、整齊的對齊
  • ✅ 保持一致:在投影片之間重複使用模式、間距與視覺語言

配色方案選擇

創意選色:

  • 跳脫預設:什麼顏色真正符合這個特定主題?避免自動選擇。
  • 考慮多個角度:主題、行業、氛圍、能量等級、目標受眾、品牌識別 (如果有提到)
  • 勇於嘗試:嘗試意想不到的組合——醫療保健簡報不一定要用綠色,金融簡報不一定要用海軍藍
  • 建立色板:選擇 3-5 種能搭配的顏色 (主色 + 輔助色 + 強調色)
  • 確保對比:文字在背景上必須清晰可讀

範例色板 (使用這些範例來激發靈感——選擇一個、改編它,或建立自己的色板):

  1. 經典藍:深海軍藍 (#1C2833)、石板灰 (#2E4053)、銀色 (#AAB7B8)、米白 (#F4F6F6)
  2. 青綠與珊瑚:青綠 (#5EA8A7)、深青綠 (#277884)、珊瑚 (#FE4447)、白色 (#FFFFFF)
  3. 大膽紅:紅色 (#C0392B)、亮紅 (#E74C3C)、橘色 (#F39C12)、黃色 (#F1C40F)、綠色 (#2ECC71)
  4. 暖色腮紅:紫紅 (#A49393)、腮紅 (#EED6D3)、玫瑰 (#E8B4B8)、奶油 (#FAF7F2)
  5. 酒紅奢華:酒紅 (#5D1D2E)、深紅 (#951233)、鐵鏽 (#C15937)、金色 (#997929)
  6. 深紫與祖母綠:紫色 (#B165FB)、深藍 (#181B24)、祖母綠 (#40695B)、白色 (#FFFFFF)
  7. 奶油與森林綠:奶油 (#FFE1C7)、森林綠 (#40695B)、白色 (#FCFCFC)
  8. 粉紅與紫色:粉紅 (#F8275B)、珊瑚 (#FF574A)、玫瑰 (#FF737D)、紫色 (#3D2F68)
  9. 萊姆與李子:萊姆 (#C5DE82)、李子 (#7C3A5F)、珊瑚 (#FD8C6E)、藍灰 (#98ACB5)
  10. 黑與金:金色 (#BF9A4A)、黑色 (#000000)、奶油 (#F4F6F6)
  11. 鼠尾草與赤陶:鼠尾草 (#87A96B)、赤陶 (#E07A5F)、奶油 (#F4F1DE)、木炭 (#2C2C2C)
  12. 木炭與紅:木炭 (#292929)、紅色 (#E33737)、淺灰 (#CCCBCB)
  13. 活力橘:橘色 (#F96D00)、淺灰 (#F2F2F2)、木炭 (#222831)
  14. 森林綠:黑色 (#191A19)、綠色 (#4E9F3D)、深綠 (#1E5128)、白色 (#FFFFFF)
  15. 復古彩虹:紫色 (#722880)、粉紅 (#D72D51)、橘色 (#EB5C18)、琥珀 (#F08800)、金色 (#DEB600)
  16. 復古大地色:芥末 (#E3B448)、鼠尾草 (#CBD18F)、森林綠 (#3A6B35)、奶油 (#F4F1DE)
  17. 海岸玫瑰:老玫瑰 (#AD7670)、海狸 (#B49886)、蛋殼 (#F3ECDC)、灰綠 (#BFD5BE)
  18. 橘與土耳其藍:淺橘 (#FC993E)、灰土耳其藍 (#667C6F)、白色 (#FCFCFC)

視覺細節選項

幾何圖案:

  • 斜線區塊分隔線,而非水平線
  • 不對稱欄寬 (30/70、40/60、25/75)
  • 旋轉 90° 或 270° 的文字標題
  • 圓形/六邊形圖片框
  • 角落的三角形裝飾形狀
  • 重疊形狀營造深度

邊框與框架處理方式:

  • 單側粗邊框 (10-20pt)
  • 對比色的雙線邊框
  • 角落括弧,而非完整框架
  • L 形邊框 (上方+左方 或 下方+右方)
  • 標題下方的底線裝飾 (3-5pt 粗)

字型處理方式:

  • 極端的尺寸對比 (72pt 標題 vs 11pt 內文)
  • 大寫字母標題,搭配寬字距
  • 使用超大顯示字型的編號章節
  • 等寬字型 (Courier New) 用於資料/統計/技術內容
  • 壓縮字型 (Arial Narrow) 用於資訊密集的內容
  • 空心字型用於強調

圖表與資料樣式:

  • 單色圖表,加上單一強調色標示關鍵資料
  • 水平長條圖,而非垂直
  • 圓點圖,而非長條圖
  • 最少或無格線
  • 資料標籤直接放在元素上 (無圖例)
  • 超大數字顯示關鍵指標

版面創新:

  • 滿版圖片搭配文字疊加
  • 側邊欄 (20-30% 寬度) 用於導覽/脈絡
  • 模組化網格系統 (3×3、4×4 區塊)
  • Z 字型或 F 字型內容流向
  • 浮動文字方塊置於彩色形狀上
  • 雜誌風格多欄版面

背景處理方式:

  • 佔據投影片 40-60% 的實心色塊
  • 漸層填滿 (僅限垂直或對角)
  • 分割背景 (雙色,對角或垂直)
  • 邊到邊的色帶
  • 將留白作為設計元素

版面配置提示

建立包含圖表或表格的投影片時:

  • 雙欄版面 (首選):使用跨欄的標題,下方再分為兩欄——文字/項目符號一欄,重點內容另一欄。這能提供更好的平衡,並使圖表/表格更易讀。使用不等欄寬 (例如 40%/60%) 的 flexbox 來為每種內容類型最佳化空間。
  • 全投影片版面:讓重點內容 (圖表/表格) 佔據整張投影片,以達到最大的視覺衝擊與可讀性
  • 永遠不要垂直堆疊:不要將圖表/表格放在文字下方的同一欄中——這會導致可讀性不佳與版面問題

工作流程

  1. 必讀 - 完整閱讀檔案:從頭到尾完整閱讀 html2pptx.md。閱讀此檔案時,絕對不要設定任何範圍限制。 在開始建立簡報前,請閱讀完整的檔案內容,以了解詳細語法、關鍵格式規則與最佳實務。
  2. 為每張投影片建立一個具有適當尺寸 (例如 16:9 比例為 720pt × 405pt) 的 HTML 檔案
    • 使用 <p>, <h1>-<h6>, <ul>, <ol> 處理所有文字內容
    • 使用 class="placeholder" 標記將要加入圖表/表格的區域 (以灰色背景呈現,便於檢視)
    • 關鍵:首先使用 Sharp 將漸層與圖示轉換為 PNG 圖片,然後在 HTML 中引用
    • 版面配置:對於包含圖表/表格/圖片的投影片,請使用全投影片版面或雙欄版面以獲得更好的可讀性
  3. 建立並執行一個 JavaScript 檔案,使用 html2pptx.js 程式庫將 HTML 投影片轉換為 PowerPoint 並儲存簡報
    • 使用 html2pptx() 函數處理每個 HTML 檔案
    • 使用 PptxGenJS API 將圖表與表格加入佔位區域
    • 使用 pptx.writeFile() 儲存簡報
  4. 視覺驗證:產生縮圖並檢查版面問題
    • 建立縮圖網格:python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4
    • 仔細檢查縮圖圖片,查看是否有以下問題:
      • 文字被截斷:文字被標題列、形狀或投影片邊緣截斷
      • 文字重疊:文字與其他文字或形狀重疊
      • 定位問題:內容太靠近投影片邊界或其他元素
      • 對比問題:文字與背景之間的對比不足
    • 若發現問題,請調整 HTML 的邊距/間距/顏色,並重新產生簡報
    • 重複此步驟,直到所有投影片的視覺效果都正確為止

編輯現有的 PowerPoint 簡報

編輯現有 PowerPoint 簡報中的投影片時,您需要處理原始的 Office Open XML (OOXML) 格式。這涉及解壓縮 .pptx 檔案、編輯 XML 內容,然後重新打包。

工作流程

  1. 必讀 - 完整閱讀檔案:從頭到尾完整閱讀 ooxml.md (約 500 行)。閱讀此檔案時,絕對不要設定任何範圍限制。 在開始編輯簡報前,請閱讀完整的檔案內容,以取得關於 OOXML 結構與編輯工作流程的詳細指引。
  2. 解壓縮簡報:python ooxml/scripts/unpack.py <office_file> <output_dir>
  3. 編輯 XML 檔案 (主要是 ppt/slides/slide{N}.xml 及相關檔案)
  4. 關鍵:每次編輯後立即進行驗證,並在繼續之前修正所有驗證錯誤:python ooxml/scripts/validate.py <dir> --original <file>
  5. 打包最終簡報:python ooxml/scripts/pack.py <input_directory> <office_file>

使用範本建立新的 PowerPoint 簡報

當您需要建立一個遵循現有範本設計的簡報時,您需要先複製並重新排列範本投影片,然後取代佔位內容。

工作流程

  1. 提取範本文字並建立視覺縮圖網格:

    • 提取文字:python -m markitdown template.pptx > template-content.md
    • 讀取 template-content.md:完整閱讀整個檔案以了解範本簡報的內容。閱讀此檔案時,絕對不要設定任何範圍限制。
    • 建立縮圖網格:python scripts/thumbnail.py template.pptx
    • 詳情請參閱建立縮圖網格章節
  2. 分析範本並將庫存清單儲存至檔案:

    • 視覺分析:檢視縮圖網格以了解投影片版面、設計模式與視覺結構
    • 建立範本庫存清單檔案 template-inventory.md,內容包含:
      # 範本庫存分析
      **投影片總數:[計數]**
      **重要:投影片索引從 0 開始 (第一張投影片 = 0,最後一張 = 總數-1)**
      
      ## [類別名稱]
      - 投影片 0:[版面代碼 (若可用)] - 說明/用途
      - 投影片 1:[版面代碼] - 說明/用途
      - 投影片 2:[版面代碼] - 說明/用途
      [... 每張投影片都必須單獨列出其索引 ...]
      
    • 使用縮圖網格:參考視覺縮圖來識別:
      • 版面模式 (標題投影片、內容版面、章節分隔線)
      • 圖片佔位符的位置與數量
      • 不同投影片群組之間的一致性
      • 視覺層次與結構
    • 此庫存清單檔案是在下一步驟中選擇合適範本的必要條件
  3. 根據範本庫存建立簡報大綱:

    • 檢閱步驟 2 中可用的範本。
    • 為第一張投影片選擇一個介紹或標題範本。這應該是前幾個範本之一。
    • 為其他投影片選擇安全的、以文字為主的版面。
    • 關鍵:將版面結構與實際內容匹配:
      • 單欄版面:用於統一的敘事或單一主題
      • 雙欄版面:僅在您有剛好 2 個不同的項目/概念時使用
      • 三欄版面:僅在您有剛好 3 個不同的項目/概念時使用
      • 圖片+文字版面:僅在您有實際圖片要插入時使用
      • 引言版面:僅用於引用人物 (附上出處) 的真實引言,絕不用於強調
      • 切勿使用比您擁有的內容還要多個佔位符的版面
      • 如果您有 2 個項目,不要將它們塞進三欄版面
      • 如果您有 4 個以上的項目,可以考慮分成多張投影片或使用列表格式
    • 在選擇版面之前,先計算您實際的內容數量
    • 驗證所選版面的每個佔位符都將填入有意義的內容
    • 為每個內容區塊選擇一個代表最佳版面的選項。
    • 儲存 outline.md,內容包含內容以及利用現有設計的範本對應
    • 範本對應範例:
      ...
      

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

David-Li0406/meta-skill-evloving

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.

David-Li0406/meta-skill-evloving

Create technical diagrams using Mermaid syntax for architecture, sequences, ERDs, flowcharts, and state machines. Use for visualizing system design, data flows, and processes. Triggers: diagram, mermaid, architecture diagram, sequence diagram, flowchart, ERD, entity relationship, state diagram, C4 model, component diagram, visualize, draw.

David-Li0406/meta-skill-evloving

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

David-Li0406/meta-skill-evloving

Complete color manipulation and green screen effects system. PROACTIVELY activate for: (1) Green screen/chromakey removal, (2) Color grading with LUTs, (3) Color correction (levels, curves, white balance), (4) Colorkey/color removal effects, (5) Hue/saturation manipulation, (6) Color space conversions (BT.709, BT.2020, HDR), (7) Color isolation effects, (8) Teal and orange look, (9) Vintage/film looks, (10) Color keying for transparency. Provides: chromakey and colorkey filters, LUT application (lut3d), curves and levels adjustment, color balance, selective color manipulation, color space handling, HDR tone mapping, professional color grading chains.

David-Li0406/meta-skill-evloving

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

David-Li0406/meta-skill-evloving

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

David-Li0406/meta-skill-evloving

Build with OpenAI's stateless APIs - Chat Completions (GPT-5, GPT-4o), Embeddings, Images (DALL-E 3), Audio (Whisper + TTS), and Moderation. Includes Node.js SDK and fetch-based approaches for Cloudflare Workers. Use when: implementing chat completions with GPT-5/GPT-4o, streaming responses with SSE, using function calling/tools, creating structured outputs with JSON schemas, generating embeddings for RAG (text-embedding-3-small/large), generating images with DALL-E 3, editing images with GPT-Image-1, transcribing audio with Whisper, synthesizing speech with TTS (11 voices), moderating content (11 safety categories), or troubleshooting rate limits (429), invalid API keys (401), function calling failures, streaming parse errors, embeddings dimension mismatches, or token limit exceeded.

David-Li0406/meta-skill-evloving

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

David-Li0406/meta-skill-evloving

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

David-Li0406/meta-skill-evloving

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

David-Li0406/meta-skill-evloving

Best practices for Remotion - Video creation in React

David-Li0406/meta-skill-evloving

Provides bidirectional translation (Chinese/English), grammar checking, and sentence polishing. Supports specific tense constraints, context-aware tone adjustment, and natural expression optimization. Outputs direct text without formatting.

David-Li0406/meta-skill-evloving

指导如何通过自定义注解(如@Unicom)标识Dubbo接口,利用BeanDefinitionRegistryPostProcessor在启动时扫描并动态注册ReferenceBean,实现RPC调用的封装。

David-Li0406/meta-skill-evloving

生成Python脚本,利用FFmpeg将图片序列按3x3布局合并,或将合并图拆分。要求使用subprocess模块执行命令,并支持用户交互式输入路径。

David-Li0406/meta-skill-evloving

SOP for extracting and analyzing promotional activity details, handling time formatting, location mapping, payment logic, and step-by-step process validation.

David-Li0406/meta-skill-evloving

Specializes in creating TikTok short video scripts using an anthropomorphic 'Chef' perspective to explain wildlife food chains and survival environments, utilizing real field footage.

David-Li0406/meta-skill-evloving

针对TikTok平台,以拟人化视角(如动物作为厨师)创作系列短视频脚本。重点介绍野生动物、食物链及生态环境,要求使用野外实拍素材,风格幽默且具有教育意义。

David-Li0406/meta-skill-evloving

Generates KWL (Know, Want to know, Learned) charts for educational videos, specifically BrainPOP, using simple 7th-grade language and short, concise bullet points.

David-Li0406/meta-skill-evloving

Develops DAX measures to calculate promo and regular volumes and generates a calculated table of dates excluding continuous promo date ranges, handling multiple periods and nulls.

David-Li0406/meta-skill-evloving

Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides persistent memory that survives conversation compaction. Use when work spans multiple sessions, has complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like "create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or "update status".

相關技能