Pitch

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

mirandaplayer1 701c900 2.3 KB Updated

File contents

懶人包(Pitch & Explainer)

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

步驟

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

原則

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

mirandaplayer1/finding-unknowns-workflow-zh/tree/main/zh-TW/skills/pitch commit 701c9002c0

Frequently asked questions

npx skillmds@latest add mirandaplayer1/pitch-2