slide-content-planner - SKILL.md Agent Skill

name: slide-content-planner description: 當使用者要規劃投影片或簡報內容時使用。輸出逐頁大綱、關鍵訊息、證據需求、視覺重點與版面動線。 version: 2026.3.9 metadata: author: Allan Yiin short-description: 投影片內容規劃、證據整理與視覺版面編排流程

Slide Content Planner

Purpose

把「做一份吸睛、可落地製作的簡報」拆成可重複執行的規劃流程。交付物固定包含：

【信息抽取】供使用者確認（或在 /autorun 下以假設值標註）。
【投影片內容規劃】逐頁：標題、單頁核心訊息、支撐論點/證據、建議講稿與轉場。
【視覺元素規劃表】逐頁：關鍵視覺元素、色塊安排、視覺動線、圖示/圖表建議與資料來源需求。

Scope

In scope

依使用者輸入（與附件內容）完成簡報的「內容架構」與「逐頁內容規劃」。
以第一性原理反推：簡報根本目的、受眾期待、說服與共鳴設計。
同步規劃每頁視覺化重點（避免只寫文字）。
如缺乏背景知識或需數據/新聞支撐：可上網查證並在規劃中標註資料來源需求。

Out of scope

不在未被要求時直接產出最終 PPTX/SVG 成品。
不處理實作層面的 SVG 產出、PPTX 匯出與檔案打包（除非使用者明確要求並提供必要工具/檔案）。

Primary use cases (2-4)

新簡報：從零產出逐頁內容規劃

Trigger examples: 「幫我規劃一份關於 X 的簡報」「我要做投影片大綱，受眾是…」「請做一份含封面與 Q&A 的簡報內容規劃」
Expected result: 交付「信息抽取」+「逐頁內容規劃」+「視覺元素規劃表」，頁數符合需求（或合理自動配置），且每頁都有可視覺化的重點。

/run：逐步工作流程（需中途確認）

Trigger examples: 「/run\n主題：…」「請用 /run 跑流程」
Expected result: 先輸出【信息抽取】並請使用者確認；確認後再輸出下一階段（內容規劃→視覺元素表）。

/autorun：一次完成（不中斷請示）

Trigger examples: 「/autorun\n主題：…」「不要問我，直接給最終規劃」
Expected result: 在同一回合完成所有交付物；對缺失資訊以明確假設值標註，並在最後列出需要使用者補充/修正的欄位清單。

/svg2pptx：將既有 SVG 依頁碼輸出成 PPTX

Trigger examples: 「/svg2pptx slide1.svg, slide2.svg…」「把這批 SVG 轉成 PPTX」
Expected result: 依 SVG 頁碼順序產出 PPTX，PPTX 尺寸比例與 SVG 一致；嚴禁用 PNG 貼回投影片作替代。

Workflow overview

信息抽取（填齊 6 欄位 + 附件/限制）
簡報根本目的與受眾期待（1-2 段）
投影片內容規劃（逐頁：封面→內文→結尾→Q&A；不需目錄頁）
視覺意象衍生（至少 3 種）
視覺元素規劃表（逐頁完成；標註資料來源需求）
QA：檢查是否有「文字堆疊、視覺疲勞、缺乏證據、缺封面/Q&A」等問題

Success criteria

Quantitative (targets)

交付物完整度：100% 含封面與 Q&A，且不含目錄頁。
視覺化覆蓋率：100% 內文頁都有至少 1 個清楚的視覺重點（圖示/圖表/資訊圖/結構化模組）。
來源標註：凡涉及新聞或數據之頁面，規劃中必有「來源/查證需求」。

Qualitative

架構有敘事張力（問題→洞見→方案→行動），不是條列堆疊。
每頁都能「一眼看懂」核心訊息（one-slide one-takeaway）。
受眾可做出期望行為改變/觀點更新。

Instructions

Step 0: Confirm inputs

先抽取/確認下列欄位（不足者用「未提供」或合理預設並標註）：

✅ 簡報主題
✅ 希望受眾改變的行為或理解的觀點
✅ 受眾背景（角色/產業/痛點/決策權限）
✅ 是否已有預定頁數（若無則自動安排）
✅ 主色調指定（若無：橙＋灰）
✅ 投影片寬高比（預設 16:9）

模式判定：

若使用者以 /run 開頭：只做 Step 0 並請對方確認後停止。
若以 /autorun 開頭：全流程一次完成；缺失資訊以假設值標註。
若未指定：仍要先輸出 Step 0（含假設），但不要卡住；直接給「草案版」內容規劃並在結尾列出待確認項。

Step 1: Define objective (first principles)

用 4 個句子內回答：

受眾現在相信/做什麼？為什麼？
簡報結束後希望他們相信/做什麼？
需要跨越的阻力（認知、成本、風險、組織流程）是什麼？
你要用什麼「證據與結構」讓他們願意改變？

Step 2: Build slide-level story

產出逐頁規劃（含封面與 Q&A，不需目錄頁）。每頁固定欄位：

Slide title（≤ 10 字優先）
One-slide takeaway（1 句話）
Supporting points（2–4 點，偏結構化）
Evidence needed（數據/案例/新聞/引用；若需上網查證則列出關鍵查詢）
Speaker note（建議講稿 2–3 句，含轉場）

Step 3: Derive visual direction

至少延伸 3 種視覺意象（metaphor/imagery）可貫穿整份簡報。
每頁都指定至少 1 個視覺化主角（icon/diagram/chart/table/infographic 模組）。
避免連續多頁使用同一種版型造成視覺疲勞（至少 3 種版型輪替）。

Step 4: Produce “視覺元素規劃表”

使用下列表格欄位（模板見 references/visual_elements_table_template.md）：

頁碼 / 主題 / 關鍵視覺元素 / 色塊安排 / 視覺動線 / 特殊圖示建議 / 備註（含資料來源需求）

Step 5: Finalization and QA

對照 references/quality_checklist.md 做自檢，至少涵蓋：

有無「只有文字」的頁面
封面是否有明確主視覺（不可只放素面文字）
是否每頁只有一個核心訊息
數據/新聞頁是否規劃了來源註記

（若使用者下一步要求產出 SVG/PPTX）再載入並遵守：

references/visual_design_rules.md
references/svg_production_rules.md
references/svg2pptx_output.md

Testing plan

Triggering tests

Should trigger:
- 「幫我規劃一份關於 ESG 的簡報內容」
- 「投影片大綱：主題是 AI 治理，受眾是董事會」
- 「/run\n主題：新產品上市策略」
- 「/autorun\n我要一份 12 頁 pitch deck 規劃」
- 「/svg2pptx\n把這批 SVG 依頁碼轉成 PPTX」
Should NOT trigger:
- 「把這份 PPTX 的字改成 18pt」
- 「幫我把 SVG 轉成 PNG」
- 「介紹一下瑞士風格設計史」
- 「請幫我做一張海報」

Functional tests

Test case: B2B SaaS 產品 pitch（未指定頁數）
- Given: 主題/受眾/目標行為/限制條件
- When: 產出內容規劃
- Then: 自動配置合理頁數；含封面與 Q&A；每頁含視覺化主角；並列出數據/案例需求。

Performance comparison (optional)

Baseline (no skill): 容易變成條列堆疊，缺乏逐頁結構與視覺化規劃。
With skill: 輸出固定欄位與 QA；可直接交給設計/製作流程落地。

Distribution notes

Packaging: python scripts/package_skill.py <path/to/skill-folder> <output-dir>
Repo-level README belongs outside this skill folder.

Troubleshooting

Symptom: 規劃結果太空泛、沒有證據支撐
- Cause: 目標行為與受眾痛點未具體化
- Fix: 回到 Step 1，補上「阻力」與「證據」欄位；必要時上網查證並列來源需求。
Symptom: 多頁內容重複、視覺疲勞
- Cause: 沒有輪替版型與視覺化模組
- Fix: Step 3 增加至少 3 種版型輪替，並在視覺元素表中明確標示。

Resources

references/quality_checklist.md
references/visual_elements_table_template.md -（選用）references/visual_design_rules.md：若要進入視覺設計/製作階段 -（選用）references/svg_production_rules.md：若要用 SVG 做投影片 -（選用）references/svg2pptx_output.md：若要把 SVG 依頁碼轉成 PPTX