Communitygithub.com

prototype-first

先製作原型再決定,避免浪費開發資源。適用於新畫面、新流程、重新設計、網站或登陸頁面等需要「給我看選項」或「能否先做原型」的請求,以及有多種合理答案的 UX 問題。也涵蓋如何根據選定的原型進行建構。

prototype-first 是什麼?

這項技能的核心是「先取得設計決策,再開始寫程式」,完全避免將原型當作產品上線或對未經挑選的方向進行開發。它強制執行嚴格的規則:絕不為原型開 PR(甚至不開草稿)、每一輪展示後必須停止等待回覆、選定的原型即為規格、原型標籤不得遺留至程式碼中,以及必須以截圖方式查看參考資料。工作流程分為五個階段:先收集參考資料與提出問題、建構 2 到 4 個變體(包含一個你自己的更好想法)、以規定格式送出回合並停止、解讀使用者的選擇(包含混合選取與疊代),最後根據選定的原型進行建構。這項技能支援 Claude Code 等平台,透過嚴謹的流程確保設計決策明確記錄,減少浪費與溝通誤差。它特別適用於有多種合理答案的 UX 問題,或任何「展示選項」或「能否先做原型」的請求。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xa3k5/skills/tree/main/skills/prototype-first

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

先做原型

我是設計師。我是靠觀看和點擊來評斷作品,不是靠閱讀計畫。製作一個原型只需幾分鐘。做錯東西則會耗費一堆 PR 和一天的回顧時間。

這項技能只做一件事:在撰寫程式碼之前,取得我對設計的選擇。它絕不會為原型開啟 PR,絕不會將原型當作產品上線,也絕不會建立我尚未挑選的方向。

嚴格規則

  1. 絕不為原型開啟 PR,連草稿也不行。 PR 是為了要合併到 main 上的程式碼而設的。原型 PR 會為即將被拋棄的東西增加審查和 CI 的噪音。
  2. 每輪展示後都必須停止。 依照下方格式傳送變體,然後等待我的回覆。在我檢查時,不要開始建構「最可能被選中的」那個。如果我選了別的東西,那些工作就是浪費,而且我無論如何還是要審查。
  3. 選定的原型就是規格。 建構結果必須長得像它。後續的意見回饋只能改變我所指定的項目。我會把建構結果與我挑選的圖片進行比較,所以任何偏差都會被視為錯誤,而非改進。
  4. 原型標籤只留在原型檔案中。 「B2」、「方向 A」以及變體的暱稱,絕不會出現在程式碼、令牌、提交訊息、PR 或議題中。它們只在挑選過程中有意義。在程式碼庫中,它們只是噪音,後人還得解讀。
  5. 將參考資料視為圖片來查看。 當我提到參考網站或應用程式時,請查看它們的螢幕截圖。純文字擷取會失去所有讓該參考資料優異的視覺品質,結果會顯得很普通。

這應該製作原型嗎?

這個變更是否有唯一明顯的答案(間距值、標籤、顏色令牌)?
├── 是 → 直接建構它,並說明改變了什麼。跳過原型是個好結果。
└── 否
    ├── 新畫面、新流程、重新設計,或 2 個以上合理答案?
    │   └── 是 → 製作原型。
    │       ├── 需要真實資料、真實導航或原生行為?
    │       │   └── 是 → 從 main 建立拋棄式分支 `proto/<主題>`
    │       └── 否 → 獨立的 HTML 檔案,在聊天室或議題討論串中分享
    └── 不確定 → 用一句話詢問:「這個要做原型還是直接建構?」

絕不要將原型藏在產品的 /lab 路由或開發標誌後面。

工作流程

階段 1:參考資料與問題

  1. 收集我所提到的每一個參考資料的螢幕截圖。將長網頁裁剪成幾個區塊。
  2. 針對每個參考資料寫出具體的觀察:類型、標題處理方式、產品展示方式、版面結構、以及最突出的一個時刻。說明為什麼每個部分有效。
  3. 質疑請求。如果我要求的東西使用者體驗很差,請說出來並說明原因。要從終端使用者的角度思考,而不是從我所描述的 literal fix 角度。
  4. 針對你無法推斷的項目,例如類型、密度、語氣以及要保留目前版本的哪些部分,給我幾個簡短、附帶編號的問題。

完成條件: 每個參考資料都有書面觀察,而且我已經回答了你的問題,或者你沒有任何問題。

階段 2:建構變體

  • 展示 2 到 4 個變體,標記為 A、B、C 和 D。一個變體無法讓你了解我的品味。超過四個則是噪音。
  • 至少一個變體是你自己的更好主意,如果你在階段 1 中曾提出異議。將它放在我要求的那個變體旁邊。
  • 在情境中模擬。 顯示整個視窗或區域,而不是一個漂浮在空白頁面上的元件。
  • 使用真實的設計。 使用應用程式當前的令牌、類型和元件。如果應用程式有淺色和深色模式,兩者都要顯示。
  • 使用真實的資料。 看起來真實的名稱、數字和文字長度。絕對不要用 Lorem Ipsum,也絕對不要用真實人物或地點的資料。
  • 讓流程可點擊。 對於任何包含步驟或狀態的內容,建立一個包含情境切換器、淺色/深色模式切換、可運作的互動,以及針對每個狀態用白話說明的 HTML 檔案。
  • 讓精緻度符合問題需求。 如果是視覺方向,它看起來要像最終產品,因為外觀正是我要評斷的項目。如果是流程,它看起來要像應用程式且可運作,邊緣細節可以稍後再處理,因為我要評斷的是我是否會迷失。

完成條件: 每個變體都在情境中模擬,使用真實的令牌和真實的資料,而且每個流程都可點擊。

階段 3:傳送回合並停止

依照「必要輸出格式」中的格式傳送回合。然後停止。

完成條件: 回合已傳送。在我回覆之前,不做任何其他事情。

階段 4:解讀我的選擇

我這麼說意思你該這麼做
「C」依照展示的樣子建構 C前往階段 5
「D,但 1.5px 不是 3px」依照這個確切變更來建構 D只變更那個項目,然後前往階段 5
「A 的按鈕,C 的搜尋列」混合從我指定的變體中取出每個命名的部分。我最喜歡的那個部分主導一切。不要偏向往哪個變體比較容易建構。
「我喜歡 B,但我想測試它」暫定選擇建構 B,並保留備選方案,直到我在真實應用程式或裝置上嘗試過 B 為止
對某個變體的意見回饋疊代只展示該變體的下一輪,回到階段 3
「我看不懂這個原型」停止製作原型直接在 PR 中建構真實的東西
「這些都不行」你誤解了我的意圖回到參考資料和我說過的話。不要針對同一個想法製作第四個版本。

當我沒說原因時,要問為什麼。 如果我做了選擇卻沒有給出理由,用一個簡短的問題詢問:「是什麼讓 B 贏了?」將我的回答與決策一起記錄下來。一個沒有原因的選擇無法讓下一個 agent 了解我的品味。

完成條件: 你知道要建構哪個變體(或哪些部分的混合),以及為什麼。

階段 5:根據選擇建構

  • 向實際建構的人簡報,提供原型連結和確切數值:顏色、尺寸、間距和類型。沒有人是憑記憶重建的。
  • 用「它是什麼」來描述設計(例如,「緊湊的表格、狀態標籤、左側導覽列」),絕對不要用它的標籤。
  • 僅在我指定的地方套用後續的一般性意見回饋(例如,「太雜亂」、「沒有層級」)。這不是允許你移除我在原型中喜歡的項目的通行證。在你放棄或變更一個原型元素之前,先說出名稱並詢問。

完成條件: 建構結果符合選擇,而且在程式碼、提交訊息、PR 或議題中,沒有任何原型標籤出現。

必要輸出格式

每一輪看起來像這樣:

**在哪裡查看:** <連結或附件>,或 `git checkout proto/<主題> && <執行命令>`

| 變體 | 押注在 | 取捨 |
| --- | --- | --- |
| A | <一行:這個變體測試的想法> | <它放棄了什麼> |
| B | ... | ... |

**我提出異議的項目:** <一到兩行,或「無」>

回覆一個字母、一個混合 (`A's x, C's y`),或 `none`。

保持這個格式。原型本身會負責說明一切。

調用變體

調用方式行為
/prototype-first從階段 1 開始完整工作流程,在階段 3 後停止
/prototype-first <變體>從上一輪疊代一個變體,回到階段 3
/prototype-first compare一個原型,附帶針對目前 UI 的「現在 / 提議」切換

相關技能