# Pitch

> 懶人包／解釋頁——把規格、原型、決策與實作筆記包成一份可分享的 HTML，讓別人快速看懂並點頭。使用時機：成果要給主管、同事或利害關係人看、需要 buy-in 或核准、使用者說「懶人包」「提案」「說帖」「pitch」「包一份給⋯看」「做個 explainer」「幫我要 buy-in」時。

- Skill: `mirandaplayer1/pitch-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mirandaplayer1/pitch-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mirandaplayer1/pitch-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: mirandaplayer1 (https://skillmd.com/u/mirandaplayer1)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mirandaplayer1/pitch-2

---


# 懶人包（Pitch & Explainer）

目的：交付不是做完就結束。看的人帶著「跟你當初一模一樣的未知」，懶人包的工作是替他們把未知消掉——並讓專家一眼看到你已經考慮過他們會問的失敗點。

## 步驟

1. **先問兩件事**（用 AskUserQuestion 一次問完）：
   - 給誰看？——決定深度與用詞（主管要結論與風險、同事要脈絡與做法）。
   - 要對方做什麼？——核准、給意見、還是照著做。整份懶人包都繞著這個行動寫。
2. 讀 `SPEC.md`、`DECISIONS.md`、`notes/implementation-notes.md` 與本輪成品。/quiz 的變更報告若存在，直接當素材。
3. **產出單一 HTML**（存 `notes/`），結構固定五塊：
   - **第一屏就是結論**：做了什麼、為什麼、要對方做什麼；有 demo 截圖或 GIF 就放最前面。
   - **一張圖勝過三段字**：SVG 流程圖或 before／after 對照，講清楚改變了什麼。
   - **已考慮的風險與失敗點**：專家審核時最想檢查的就是這一節，主動寫出來能加速核准。允許誠實寫「沒處理＋為什麼現階段可接受」——這節如果寫起來很輕鬆，代表問題想得不夠難。
   - **這次明確不包含什麼**：範圍界線列清楚，防止對方帶著錯誤期待審核——範圍誤會是最貴的一種來回。
   - **決策摘要**：關鍵取捨各一句話、標 D-編號；細節一律收合，預設不展開。
4. 留言層照 WORKFLOW.md〈HTML 產出與互動介面〉內嵌。對方意見貼回對話後，回填 `SPEC.md` 或 `DECISIONS.md`。

## 原則

- 寫給對方的未知，不是寫給自己的記憶：對方沒讀過這個專案的任何檔案，行話與 D-編號都要當場解釋。
- 超過三屏就砍：塞不進三屏的細節移進收合區。一頁講不完，通常代表結論還沒想清楚。
- 順序在 /quiz 之後：自己先全對，才有資格解釋給別人聽。