PM · PRD → Demo 一體化工作流
把「一個產品想法」走完「對齊 → 產文檔 → 出可點原型」的完整鏈路，產出可交付開發的 PRD、可獨立實現的指標定義、以及一個復用基座倉庫真實介面的可分享原型。本工作流與宿主無關（Claude Code / Codex / Cursor / Gemini 均可），可移植性說明見「宿主適配」一節。
何時用
- 用戶扮演產品經理，要產出 PRD / 指標定義 / 交互稿這類交付物；
- 通常是在已有倉庫或系統上做改進，需要復用它的真實結構；
- 希望同時看到一個初步、可點、可分享的原型來輔助評審。
不適用：純程式碼實現任務、只改一兩行、無產品決策成分的工作。
你會產出什麼
- PRD.md —— 唯一事實源（做什麼 / 為誰 / 範圍 / 風險 / 頁面與交互詳述）。
- 指標定義.md —— 完全自包含的口徑文檔，開發只看這一份即可實現每個指標/規則。
- 可分享的自包含 HTML 原型 —— 左=目標介面（復用基座倉庫真實 UI + 你的改動，mock 數據必標註），右=完整 PRD 面板。
貫穿三階段的紀律（不可退讓）
- 零編造，一切紮根證據：口徑落到源碼 / 官方文檔 / 用戶確認；查不到就明說，不冒充；mock 數據必須顯式標註。
- 零 emoji：文檔與原型全程不用 emoji / 狀態圖示；狀態一律文字標籤（保留 / 升級 / 新增 / 未測 / 待核實 等）。
- 撰寫 → 對抗式審查閉環：任何交付文檔，先撰寫、再由「苛刻的資深 PM」視角審查、按問題修訂，循環到通過（審查提示詞見
prompts/reviewer-agent.md）。 - 跨產物一致：PRD ↔ 指標定義 ↔ 原型 三者口徑必須一致；發現孤兒項 / 自相矛盾就地修。
- 匹配用戶的交互風格：有人偏對話、有人偏選項；被拒一次就換方式，不硬塞同一種。
- 決策沒鎖定不動手：產文檔前先把核心決策問清；目標不清就停下討論，不猜。
- 文字去 AI 味（擬人）：文檔正文用自然、直接、像人寫的語氣，主動規避 AI 腔的典型痕跡（濫用破折號、"不僅是 X，更是 Y"、空洞排比 / 三段式套話、過度對沖、浮誇修飾、正確的廢話）。可載入本機
humanizer技能，或參照references/writing-style.md（彙總 stop-slop / Humanizer-zh / blader-humanizer）。注意：技術口徑該精確的仍要精確——去味不等於犧牲準確、也不是塞口水話。
階段 0 · 交互式發現與決策鎖定
目標：把用戶的真實想法、需求、約束調研並梳理清楚，鎖定核心決策——這一步 AI 與人交互完成，不替用戶拍板。
- 扒已有資產：讀用戶給的倉庫 / 文檔 / 舊系統的真實結構（若宿主支援並行探索就並行扒；否則逐個讀）。搞清它實際做什麼、有哪些可復用的東西。
- 交互梳理需求：用問答幫用戶把模糊想法收斂成明確決策——典型要鎖的：基座選誰、範圍 in/out、要什麼指標/功能、展示/資訊架構、明確的非目標。一次問幾條關鍵的，別一次性轟炸。
- 產出決策記錄：把鎖定的決策寫成一份簡短的「決策/規劃」文件，作為階段 1 的輸入。
出口判據：核心決策逐條有明確答案，用戶認可。
階段 1 · 產 PRD + 指標定義
目標：產出可交付開發的兩份文檔。
- 對模板：參照
references/prd-checklist.md（國內實戰派完整清單 + 按項目類型裁剪），確定這個項目該產哪些節、哪些可跳。 - 撰寫：按
prompts/writer-agent.md撰寫 PRD 與指標定義。要點：- PRD 覆蓋：背景/目標/成功度量/範圍/風險/功能結構+資訊架構+流程圖（可用 Mermaid）/各頁面前台展示與交互詳述（欄位級）/術語表/全局規則/干係人。
- 指標定義完全自包含：把口徑全文內聯，不寫"見其他文檔"；開發單看即可實現。
- 審查：用
prompts/reviewer-agent.md的「資深 PM」人設對抗式覆核（完整性 / 可執行 / 口徑與源碼一致 / 範圍與非目標 / 風險 / 零 emoji / 無死鏈 / 跨文檔一致）。 - 修訂閉環：按審查的必修項改，覆核直到通過。
- 過 checklist：交付前對照
references/pitfalls.md逐條自查（這是歷次踩坑沉澱的檢查項）。
階段 2 · 出可分享原型
目標：一個左=目標介面、右=完整 PRD 的可點原型；介面設計忠實於既定來源（參考稿 / 基座 / 競品，見下）。硬性守則見 references/prototype-guardrails.md。
- 確定設計來源（按優先級）：
- ① 用戶提供了參考原型 / 設計稿 → 以它為準來做設計，忠實還原它的視覺與佈局；
- ② 在某個基座倉庫上做改進 → 克隆/讀它的前端，提取真實設計令牌與佈局（配色 / 明暗 / 側欄還是頂欄 / 卡片 / 各視圖真實欄位與表格列），照抄不即興；
- ③ 都沒有 → AI 自行構建，選同類產品 / 競品的頁面作參考來創造，並在原型裡說明參考了誰、為什麼。
- 建自包含 HTML：單文件，左=目標介面（基座保真 + 你的改動，mock 數據必標註），右=完整 PRD 面板（用極簡 markdown 渲染器把 PRD 內聯進去）。
- 自包含 / CSP 安全：全部 CSS/JS 內聯，不引外部 CDN/字體/圖；無法 live 渲染的東西（如某些圖庫）要誠實標註限制、退化為可讀呈現。
- 發佈並迭代：發佈成可分享連結；用戶提改動時，同時改原型和 PRD、保持不脫節，重新發佈到同一連結。
交付前檢查清單（摘要，詳見 references/pitfalls.md）
- 零 emoji（含圖表/程式碼塊內的節點標籤）
- 無編造：數字/口徑都能追溯來源；mock 已標註
- 指標定義自包含，無"見其他文檔"式外鏈
- 跨產物口徑一致，無孤兒項 / 自相矛盾
- 原型設計忠實於既定來源（有參考稿照參考稿 / 在基座上則照抄令牌 / 都沒有則參考競品並說明），不是憑空即興
- 複合分/總分都給了顯式公式與構成
- 無法渲染/未測/未知都如實標註，不偽造成事實
宿主適配（可移植性）
本 SKILL.md 正文是宿主無關的自然語言指令，任何 LLM 都能照做。三處差異在正文外解決：
- 載入/觸發：各宿主安裝與調用方式見
README.md（Claude Code 放技能目錄；Codex 走其技能/AGENTS.md 引用；Cursor/Gemini 各自路徑）。 - 能力降級：凡提到"派子 agent 審查/探索"，若當前宿主不支援子 agent，就由你自己另起一遍完成同樣的審查/探索，不改變紀律。
- 工具無關：正文只描述動作（聯網搜、讀倉庫、寫文件、發佈原型），不綁定具體工具名；由各宿主映射到自身工具。
附帶資源
references/prd-checklist.md—— PRD 組件清單 + 按項目類型裁剪references/prototype-guardrails.md—— 原型硬性守則references/pitfalls.md—— 踩坑檢查清單references/writing-style.md—— 去 AI 味 / 擬人寫作規則（彙總 stop-slop / Humanizer-zh / blader-humanizer + 本機 humanizer 技能）prompts/writer-agent.md—— 撰寫 agent 提示詞模板prompts/reviewer-agent.md—— 資深 PM 審查 agent 人設 + 檢查項templates/prd-skeleton.md/templates/metric-spec-skeleton.md—— 骨架模板