| name | demo-storytelling |
| description | 把 PoC / prototype 包裝成有說服力的 demo 故事。輸入技術成果/受眾/數據，輸出 demo 腳本 + 一頁摘要 + FAQ。當用戶要展示成果、準備 demo、報告 PoC 時使用。 |
| argument-hint | [做了什麼，如 'AI 自動分類廣告素材' / '自動化報表產生器'] |
| allowed-tools | Read, Grep, Glob |
| author | Maki |
| version | 1.0.0 |
| tags | ["presentation","demo","storytelling","career"] |
| required_env | [] |
Demo 故事包裝器
目標
把技術成果轉化為有說服力的 demo 故事。產出包含：完整 demo 腳本、一頁摘要、FAQ 預備。適用於週會報告、面試作品集、LinkedIn 展示、blog 文章。
不適用場景
- 還沒做出東西（先去做，再來包裝）
- 純理論研究（沒有可展示的成果）
- 需要保密的內容（NDA / 公司機密的核心數據）
輸入
從 $ARGUMENTS 或對話中取得：
| 欄位 | 必填 | 說明 |
|---|
| 做了什麼 | 是 | 技術成果的簡述 |
| 給誰看 | 否 | 預設：技術主管 / 非技術老闆 |
| 量化數據 | 否 | 省了多少時間、自動化了什麼、前後對比 |
| 展示形式 | 否 | 預設：3-5 分鐘 live demo |
若缺必填欄位，直接問用戶。
Decision Model
Step 1: 素材盤點（Pre-flight）
在動手寫腳本前，先盤點手上有什麼：
| 素材 | 有/沒有 | 沒有怎麼辦 |
|---|
| 可展示的畫面（截圖/GIF/live） | 必須有 | 先錄一段或截圖，沒畫面沒 demo |
| 量化數字（時間/成本/準確率） | 最好有 | 用代理指標或定性描述，標記 TBD |
| 前後對比 | 最好有 | 用情境對比代替數字對比 |
| 受眾背景資訊 | 最好有 | 預設用「非技術主管」設定 |
若關鍵素材（畫面）缺失，先提醒用戶補齊再繼續。
Step 2: 萃取故事核心
從技術描述中抽出三個要素：
| 要素 | 問題 | 範例 |
|---|
| Pain | 之前怎麼做？多痛？ | 「人工分類 500 張素材要 2 小時」 |
| Solution | 你怎麼解決的？（一句話） | 「用 Claude Vision 自動分類 + 標籤」 |
| Impact | 結果如何？（數字） | 「30 秒完成，準確率 95%」 |
關鍵原則：Pain → Solution → Impact 的順序不能變。先讓人感受到痛，才會覺得解法有價值。
Step 3: 受眾調適
根據受眾調整語調和重點：
| 受眾 | Hook 類型 | 重點 | 避免 |
|---|
| 非技術老闆 | 業務數字 | ROI、效率提升、可擴展性 | 技術名詞、架構圖 |
| 技術主管 | 技術亮點 | 架構選擇、為什麼這樣做 | 入門級解釋 |
| 同事工程師 | 踩坑經驗 | 實作細節、學到什麼 | 過度包裝 |
| 面試官 | 個人貢獻 | 你做了什麼決策、為什麼 | 團隊功勞攬身上 |
| 社群 / LinkedIn | 反直覺洞見 | 意外發現、違反常識的結果 | 太 promotional |
Step 4: 建構 Demo 腳本
格式分支
| 形式 | 時長 | 結構 | 備註 |
|---|
| Live demo | 3-5 分鐘 | 完整五段式（下方） | 預設 |
| 短版 demo | 60-90 秒 | Hook + 1 步 demo + Impact | 週會插播 / Lightning talk |
| 非同步影片 | 2-3 分鐘 | 同 live 但加字幕、可剪輯 | 作品集 / 社群 |
| 文字版 | 300-500 字 | Hook + Problem + 結果 | Blog 段落 / LinkedIn |
結構（3-5 分鐘版）
1. Hook（15 秒）
→ 一句話製造好奇或驚訝
→ 模式：數字對比 / 反直覺 / 提問
2. Problem（30 秒）
→ 用情境描述痛點（不是功能列表）
→ 讓受眾產生「對，我也遇過」的共鳴
3. Live Demo（2-3 分鐘）
→ 按操作順序列出每一步
→ 每步標註：做什麼 + 說什麼 + 停頓點
→ 標記「wow moment」（觀眾會反應的點）
4. Impact（30 秒）
→ 前後對比（時間/成本/品質）
→ 數字 > 形容詞
5. Closing（15 秒）
→ 留下一個記憶點
→ 模式：下一步計畫 / 邀請試用 / 金句收尾
節奏控制
- wow moment 放在 demo 的 60% 位置（不是開頭也不是結尾）
- 每步之間有 transition sentence（不要跳躍）
- 如果有 bug 風險的步驟，準備 fallback 說詞
Step 5: 產出附件
一頁摘要（Slack / Email 用）
[一句話 Hook]
做了什麼：[Solution 一句話]
解決什麼：[Pain 一句話]
成果：[Impact 數字]
想看 demo 的話 [行動呼籲]
FAQ 預備
預測 3 個最可能被問的問題，分兩類：
- 技術問題：「這個能 scale 嗎？」「API 費用多少？」
- 業務問題：「能用在其他場景嗎？」「多久能上線？」
每個問題準備：簡短回答（30 秒）+ 如果追問的延伸答案。
輸出格式
## Demo 故事：{標題}
### 受眾：{受眾}｜時長：{X} 分鐘
---
### Demo 腳本
**1. Hook**（15 秒）
> "{Hook 台詞}"
**2. Problem**（30 秒）
> {情境描述}
**3. Live Demo**（{X} 分鐘）
- Step 1：{操作} → 說："{台詞}"
- Step 2：{操作} → 說："{台詞}"
- ⭐ Step 3（wow moment）：{操作} → 說："{台詞}"
- Step 4：{操作} → 說："{台詞}"
**4. Impact**（30 秒）
> 之前：{舊數據}
> 之後：{新數據}
> 提升：{百分比或倍數}
**5. Closing**（15 秒）
> "{收尾金句}"
---
### 一頁摘要
{Slack/Email 可直接貼的版本}
---
### FAQ 預備
**Q1：{問題}**
簡答：{30 秒回答}
延伸：{如果追問}
**Q2：{問題}**
簡答：{30 秒回答}
延伸：{如果追問}
**Q3：{問題}**
簡答：{30 秒回答}
延伸：{如果追問}
Quality Gates
Heuristics
成功案例模式
- 「原本 2 小時 → 現在 30 秒」→ 數字對比 hook，最容易打動非技術人
- 「大家都用 X，但我發現 Y 更好」→ 反直覺 hook，LinkedIn 擴散強
- 「我以為最難的是 A，結果真正卡住的是 B」→ 踩坑故事，工程師共鳴
失敗案例模式
- 「我用了 X 技術和 Y 框架和 Z 服務...」→ 技術堆疊不是故事
- 「這個功能可以做 A、B、C、D...」→ 功能列表不是 demo
- 「AI 是未來趨勢...」→ 空泛開頭，觀眾秒滑走
判斷捷徑
- 有前後對比數字 → 優先用數字對比 hook
- 給非技術人看 → 把所有技術名詞換成動作描述
- 面試用 → 強調「你做了什麼決策」而不是「發生了什麼」
- 沒有硬數字 → 用代理指標（「從 5 個步驟縮減到 1 個」）
