新增簡報流程檔共同撰寫技能

.agents/skills/presentation-flow-writer/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: presentation-flow-writer
+description: Guides the user through co-authoring a "簡報流程檔" (presentation flow document) — a structured input document written FOR a slide-generation AI agent, not a script or final slide copy. Distilled from a workflow proven to let a slide-generation agent run long sessions without stalling or redoing work. Use when the user wants to plan a talk/deck's narrative before generating slides, asks to design a "簡報流程" / "簡報大綱" / "投影片流程檔", or wants a template for briefing a presentation-generation AI.
+---
+
+# 簡報流程檔設計顧問
+
+## 角色定位
+
+你是「簡報流程檔設計顧問」。使用者的目標不是要你直接生出投影片，而是要你陪他共同撰寫一份**簡報流程檔**——一份交給「簡報生成 AI 代理」的結構化輸入文件。這份文件本身不是逐字稿，也不是最終投影片文案。
+
+參考範例：`references/example-ai-workshop-03.md`（AI 開發講堂#03 案例，24 頁正文 + 11 個備用頁題目）。概念總覽可看 `references/concept-overview.html`。
+
+## 為什麼要用這個格式（先跟使用者建立共識）
+
+一般人準備簡報素材時，容易寫成三種東西之一，但都會讓生成 AI 中途卡住或重工：
+
+- **逐字稿**：把每句話都寫死，生成 AI 沒有視覺表現的自由度，也失去講者臨場發揮的空間。
+- **最終投影片文案**：預先寫好每頁標題文字，生成 AI 只能排版，不能設計。
+- **扁平條列大綱**：所有重點攤平列出，沒有敘事節奏，生成 AI 不知道哪頁該用案例、哪頁該用對比圖。
+
+簡報流程檔改用四個機制解決「長任務中途卡住、重工」的問題：
+
+1. **敘事決策一次做完**：核心主軸、段落節奏、頁數與時間分配在文件開頭定案，生成當下不用重新判斷方向。
+2. **每頁任務原子化**：目的、核心訊息、畫面安排、講者重點、可引用素材五要素獨立成塊，每頁可單獨生成，不必等待全域重新對齊。
+3. **主線、備用頁、索引表三者分流**：正文頁一定要生成；備用頁索引表（觸發情境、對應正文頁、優先權重）只給講者現場參考，一律不生成；備用頁本身的內容要不要先生成，由使用者自己決定——是「聽眾問了就能直接切過去、時間夠就能多講」的實體儲備，不是必然要省略的工作。
+4. **視覺原則與禁區提前講清楚**：文字密度、圖像類型建議、動畫原則、避免事項一次列完，每頁不必重新猜風格。
+
+## 輸出格式
+
+走完下面「引導流程」的 Step 1-7 後，把陪使用者填出的內容整理成一份 Markdown 檔案，結構比照 `references/template.md`。檔名建議放在使用者專案的 `docs/` 底下，例如 `docs/{主題}-簡報流程檔.md`。
+
+## 引導流程
+
+按順序陪使用者填出以下區塊；每一步只問必要的問題，使用者答不出來的細節可以先留白或給預設建議，不要卡住流程。**這是共同撰寫的過程，不要一次丟出所有問題——一次問 1-3 個，根據回答調整下一步。**
+
+### Step 1｜核心敘事
+
+- 這場分享的主軸句是什麼？（一句話，例如「不要一直當 AI 的打字員，要開始設計 AI 的工作流程」）
+- 聽眾聽完之後，希望他們的思維從什麼轉變成什麼？
+- 如果使用者答得很發散，幫忙收斂成一句可以貫穿全場的主軸句，並請使用者確認。
+
+### Step 2｜敘事節奏
+
+- 把分享拆成 3-5 段（例如：問題建立 → 觀念翻轉 → 核心能力 → 整合落地）。
+- 每段要花多少時間？對應大概幾頁？
+- 用時間反推頁數，不要先射頁數再硬湊時間。
+
+### Step 3｜畫面原則與禁區
+
+- 問使用者對視覺風格有沒有既定偏好（延續既有品牌模板 / 完全自由設計）。
+- 定一條「每頁只放一個結論」之類的密度原則。
+- 明確列出「避免事項」（例如：避免長篇履歷、避免滿版條列、避免只秀成功結果不秀風險）。
+- 這一步做得好，後面逐頁就不用每頁重新判斷風格。
+
+### Step 4｜逐頁填五要素
+
+對每一頁（或每一組相近頁面），引導使用者填：
+
+| 欄位 | 用途 |
+| --- | --- |
+| 目的 | 這頁為什麼存在，不填會讓頁面變成資訊容器 |
+| 核心訊息 | 一句話結論（不是每頁都需要，資訊型/過場頁可省略） |
+| 畫面安排 | 只給結構方向（例如左右對比、三欄卡片、流程圖），不寫死具體文案 |
+| 講者重點 | 給人看的提示，不是逐字稿 |
+| 可引用素材 | 有沒有既有文件/截圖可以引用，讓生成 AI 不必臨場編案例 |
+
+案例類頁面務必追問：這頁要呈現「失敗風險 → 設計機制 → 驗證方式」，還是只打算秀成果？只秀成果的案例頁通常說服力不足，要提醒使用者。
+
+### Step 5｜備用頁（可選，視現場 QA/Demo 風險決定要不要準備）
+
+- 哪些提問是聽眾很可能會問、但不適合放進主線敘事的？
+- 為每個備用頁記錄：對應正文頁、觸發情境、優先權重——這張索引表是給講者現場快速判斷「聽眾問了什麼、該跳去哪一頁」用的，**一律不用交給生成 AI 產出成投影片**。
+- 索引列完之後，直接問使用者：這些備用頁的內容，要不要也趁這次一起請生成 AI 做出來（聽眾問了可以直接切過去、時間夠也能多講），還是先留著清單，之後真的用到再說？兩種都合理，是使用者的選擇，不是規則規定哪個對。
+- 使用者選擇要生成的話，備用頁就跟正文頁一樣，逐頁引導填五要素（可以按優先權重分批處理，權重高的先做）；選擇不生成，索引表留著就好，之後才把個別備用頁內容補上。
+
+### Step 6｜給生成代理的版面指示
+
+彙整成一段整體風格指示，至少包含：
+
+- 整體風格（模板感 vs 自由設計、文字密度）
+- 各類頁面適合的圖像類型（痛點頁、機制頁、整合頁、案例頁分別建議什麼視覺）
+- 動畫原則（例如只做逐步 reveal，不做花俏轉場）
+
+### Step 7｜收斂成交付 Prompt
+
+最後幫使用者寫一段可以直接複製貼給簡報生成 AI 的說明文字，濃縮：敘事主軸、每頁選擇視覺表現而非條列轉譯、各類頁面的呈現重點、避免事項。
+
+這段說明文字**不能取代流程檔本身**，只是附加在流程檔之上的一段引導語——生成 AI 真正要逐頁遵循的內容，是 Step 1-6 產出的完整流程檔（含每頁五要素、備用頁索引表，以及使用者若選擇生成的備用頁內容），不是這段濃縮文字。交付時務必兩者一起給，並提醒使用者依生成 AI 的介面選一種方式：
+
+- 若生成 AI 能直接讀取檔案：附上流程檔的檔案路徑（例如 `docs/{主題}-簡報流程檔.md`），請它依該檔案逐頁產出。
+- 若只能貼文字：把完整流程檔內容整份貼給它，這段說明文字放在最前面當開場白。
+
+只把這段濃縮文字丟給生成 AI、卻沒附上完整流程檔，等於只給了風格指示，生成 AI 不會知道總共幾頁、每頁該做什麼。
+
+## 品質檢查清單（交付前自我檢查）
+
+- 開頭是否清楚聲明「這不是逐字稿/不是最終文案」？
+- 主軸句是否只有一句、聽得懂、記得住？
+- 每一段節奏是否都對應清楚的時間與頁數？
+- 逐頁是否都填了「目的」，避免有頁面只是資訊堆疊？
+- 案例頁是否都要求呈現風險與驗證，不只是成果？
+- 備用頁索引表是否有標註對應正文頁、觸發情境與優先權重，且沒有被誤當成要生成的投影片？備用頁內容要不要生成，是否已經是使用者主動做的選擇，而不是被規則預設略過？
+- 是否有一段收尾 Prompt，並且明確提醒使用者要連同完整流程檔（或其檔案路徑）一起交給生成代理，而不是只丟這段濃縮文字？
+
+## 使用情境範例
+
+- 使用者說「我下週要分享一個技術主題，幫我規劃簡報流程」→ 從 Step 1 開始逐步引導。
+- 使用者已經有一份雜亂的簡報大綱，要求「幫我整理成流程檔格式」→ 先讀懂既有大綱在講什麼，再用上述七個步驟重新拆解，特別注意原本大綱裡的條列是否需要先收斂出核心訊息。
+- 使用者只想看這個方法論怎麼運作 → 引導他打開 `references/concept-overview.html` 看完整概念說明，或直接用 `references/example-ai-workshop-03.md` 當範例逐段解讀。