Startup pitch
將創辦人的資料夾轉化為他們能夠辯護的投資人簡報。每次執行都以快速執行開始：一頁，pitch/START-HERE.md，附帶一個小型的有來源分類帳。敘事、完整的投資人問答和簡報是創辦人可以要求的附加元件。
規則
- 先閱讀再提問。 執行 intake 並先閱讀檔案。只問遺漏的、在此階段重要的、且無法從資料夾中推導出的資訊。
- 每個數字都有來源。 任何出現在輸出中的數字，都必須透過
pitch/facts.yaml中的一個條目（帶有 kind（事實、假設、預測）和 source（來源））才能出現。如果資料夾中沒有數字，請寫[needs number]並提問。編造 traction、營收、市場規模、成長率、留存率、客戶數、員工人數或估值，是此技能旨在防止的失敗。 - 揭露矛盾，絕不取平均。 將兩個值記錄為
conflicting，使用保守的那一個，說明原因，並詢問創辦人。 - 機密資料不得出現在面向投資人的文字中。 標記為 confidential 的檔案不得讀取。無論出現在何處，估值、條款、股權結構表上的姓名、潛在投資人姓名、薪資和合約條款都不得出現在敘事和簡報中。
- 保留創辦人的語氣。 使用他們特定的措辭和客戶引述。去除流行術語；不要添加任何流行術語。
- 小型分類帳。 只記錄輸出中引用的數字，以及每個矛盾的兩邊。不要有中間條目，也不要有無人引用的歷史記錄。
指令
一個入口點；$SKILL 是此技能的目錄（使用其絕對路徑）。從創業資料夾執行。
python3 $SKILL/scripts/pitch.py intake # 盤點 + 提取 -> pitch/intake/
python3 $SKILL/scripts/pitch.py check # 驗證 pitch/facts.yaml（以及簡報（如果存在））
python3 $SKILL/scripts/pitch.py deck # 建立 html + pptx，列印 pdf，QA 截圖，追溯數字
python3 $SKILL/scripts/pitch.py comparables --sector saas --round seed # 三個可供研究的真實簡報
python3 $SKILL/scripts/pitch.py status # 顯示現有內容和待辦事項
python3 $SKILL/scripts/pitch.py open # 為創辦人開啟 pitch/ 資料夾
pitch.py setup 在技能資料夾內安裝簡報依賴項（第一次執行 deck 時會自動完成）；pitch.py doctor 顯示已安裝的內容。
快速執行（永遠優先執行；目標是五分鐘內完成）
閱讀 references/core.md 和 references/file-formats.md。不要打開其他參考文件。
- 執行
pitch.py intake。閱讀pitch/intake/corpus/INDEX.md，然後依序閱讀它列出的檔案：先讀創辦人的備忘錄和筆記，然後是數據，最後是其餘部分。對於過時的配對，優先選取最新的。不要打開標記為 confidential 的檔案。索引標記為包含交易條款或薪酬的檔案可以閱讀；但這些條款不得出現在面向投資人的文字中。 - 撰寫
pitch/facts.yaml：15 到 30 個條目，僅包含起始頁面會引用的內容。從scripts/facts_template.yaml開始。執行pitch.py check；修正每個 FAIL。WARN 是一個需要詢問創辦人的問題，不是可以掩蓋過去的事情。pitch.py check --explain會列印檢查器如何比對 id、單位和簡報中的數字，因此無需閱讀其原始碼。 - 使用
references/file-formats.md中的模板撰寫pitch/START-HERE.md：創辦人必須回答的問題（最多五個，矛盾優先，每個問題附上在獲得答案前所使用的值）、兩句話的 pitch 和 60 秒版本、三到五個重要數字和還不能使用的說法、創辦人最沒準備好的五個投資人問題（附上誠實的答案）、前三名的紅旗及其修正方法，以及哪些內容被排除在投資人材料之外。約 1,200 字。如果待辦事項超過五個，將其餘部分放入pitch/gaps.md並連結它。 - 在聊天中告知創辦人：相同的問題、你所假設的內容，以及他們可以要求的後續步驟（敘事、完整問答、簡報、會議準備）。執行
pitch.py open。
如果目標投資人未知，這將是五個問題之一；說明 core.md 中的預設值並繼續。
附加元件（執行創辦人要求的那些；快速執行仍然優先）
| 創辦人想要 | 閱讀 | 執行 |
|---|---|---|
| 敘事 | references/narrative.md | 撰寫 pitch/narrative.md：目的句、敘事選擇、長篇形式、兩句話、60 秒和 3 分鐘版本。內嵌引用 id。其他變體僅在要求時提供。 |
| 投資人問答 | references/investor-questions.md；question-bank.md 作為按主題查閱的資料庫 | 撰寫 pitch/investor-qa.md：最不熟悉的五個問題、10 題練習、最多 15 個主題式問題（附上引用 id 的誠實答案），以及以 core.md 格式記錄的紅旗。 |
| 完整的紅旗審計或發送前檢查 | references/red-flags.md | 將審計結果添加到 investor-qa.md（或簡報審查）中，包含每個紅旗的觸發條件、修正和狀態。 |
| 簡報投影片 | references/deck-structure.md（容量表格）、references/design.md | 執行 pitch.py comparables 並瀏覽三個簡報的結構。在容量表格內撰寫 pitch/deck/deck.json，為這家公司選擇主題、品牌顏色和標誌（如果資料夾中有）。執行 pitch.py deck。透過刪減詞彙來修正每個 lint 和 QA 行，重新執行直到摘要乾淨，然後親自查看 pitch/deck/qa/。 |
| 為特定投資人類型或機構做準備 | references/investor-types.md、investor-types-detail.md 中的一個區塊、references/meetings.md | 調整問答和提案內容。僅使用機構公開頁面上的資訊，並標明來源。 |
| 階段基準、特定商業模式指標 | references/benchmarks.md、metrics-by-model.md 中的一個區塊 | 引用時必須附帶來源和年份，否則不要引用。 |
| "審查我的簡報"（資料夾中的 pdf、pptx、html） | references/red-flags.md | Intake 會提取它。根據簡報加資料夾建立分類帳，將起始頁面撰寫為審查報告，並提供重建選項。 |
| "更新數字" | 無 | 重新執行 intake 和 check，更新分類帳，重建輸出，列出每個變更值的舊與新。 |
| 3 分鐘演示日 pitch | references/narrative.md、references/deck-structure.md | 演示日變體以及 6 到 8 張投影片的結構。 |
每個附加元件僅擴充分類帳中它新引用的數字。將每個新檔案添加到 START-HERE.md 底部的 "Files" 列表中。
當創辦人回答時
先更新分類帳，然後更新頁面。
- 一個決定（這一輪的規模、目標投資人、兩個數字中哪一個是現行的）變成
status: confirmed；矛盾的另一方面移入其note中。 - 一個沒有檔案支撐的主張（退款數量、創辦人背景）記錄為
source: founder statement, <date>和status: unverified，在輸出中明確陳述，並且能夠支持它的記錄將放在待辦事項清單上。 - 一個創辦人留待處理的問題（"我需要重做預算"）在其相關條目上添加
open_question:，以便檢查回報 WARN 而不是 FAIL。不要為了使身分平衡而添加條目。 - 一個與檔案矛盾的答案將被採用，並且該檔案將在 START-HERE.md 的第 1 節中被標記為需要更新。
- 如果他們指名了投資人類型或地區，則打開
references/investor-types.md。
執行 pitch.py check，更新 START-HERE.md 和所有引用了已變更 id 的輸出，並將每個變更的值回報為舊值到新值。移除已回答的問題；將下一個待辦事項提升上來。如果他們在仍有待辦事項時要求簡報，請先建立它，並在你的回覆中首先列出剩餘的 [needs number] 插槽。
當無人能回答時（非互動執行）
對於每個衝突，繼續使用保守值；對於每個缺口，繼續使用 [needs number]。START-HERE.md 的第 1 節列出每個待辦事項，因此沒有任何隱藏；簡報可以保留可見的 [needs number] 插槽。
在交接之前
pitch.py check沒有 FAIL；如果有簡報，pitch.py deck的摘要會顯示已檢查的 PPTX、匹配的 PDF 頁數、0 個 QA 問題。- 每個輸出中的每個數字都引用了一個分類帳 id；面向投資人的文字中沒有機密內容。
- 僅靠投影片標題就能說明整場 pitch（從上到下閱讀）。
- 小樣本需說明 n 值和設定；超過 18 個月的數據需標註日期。
- 將一個帶有日期的條目附加到
pitch/run-log.md：讀取的檔案、提出的問題、答案、輸出。
參考檔案對照表
| 檔案 | 何時開啟 |
|---|---|
references/core.md | 每次執行 |
references/file-formats.md | 每次執行（分類帳、START-HERE 模板、deck.json、資料夾佈局） |
references/narrative.md | 撰寫 narrative.md 或任何口頭變體時 |
references/investor-questions.md、question-bank.md、meetings.md | 問答、按主題查閱、會議流程表和後續追蹤 |
references/red-flags.md | 簡報審查、完整審計、發送前檢查 |
references/investor-types.md、investor-types-detail.md | 指名了目標投資人類型或地區時 |
references/metrics.md、metrics-by-model.md、benchmarks.md | 指標定義、特定商業模式的指標、階段門檻 |
references/deck-structure.md、references/design.md | 建立或審查簡報時 |
references/deck-library.md | 一個可比較的簡報在那裡有結構註記（comparables 指令會說明） |
常見錯誤
- 先寫 pitch 再補來源。分類帳應該優先，這樣故事才能建立於真實的基礎上。
- 相信創辦人的備忘錄勝過指標匯出。備忘錄會高估：記錄兩者並提問。
- 將一個客戶的三個月結果呈現為公司指標。說明 n 值和設定。
- 因為資料夾中沒有市場資料，就從報告中填寫市場投影片。使用
[needs number]並提供創辦人 bottom-up 的方法。 - 在開始前閱讀所有參考檔案。快速執行只需要兩個檔案。
- 為了讓檢查器安靜而塞滿分類帳。對於你加總或計數的值，使用
computed: true，並且只引用你使用的值。 - 為了適應溢出投影片而縮小字型。刪減文字或拆分投影片。
- 隱藏一個薄弱的答案。投資人會發現它；一個帶著計畫的誠實回答，會被視為成熟的表現。