Vibe Coding 方法論 · 第 3 節

PlayGround:元件的試衣間

UI 功能直接寫進頁面,改一處影響一片,調一個按鈕要把整個頁面跑起來。解法是先做獨立的元件 PlayGround:每個 UI 元素有單獨的 demo,調好了再整合進正式頁面。

互動演示一 · 現場體驗一個迷你 PlayGround

下面就是一個最小的 PlayGround:左邊是元件的即時預覽,右邊是參數控制。隨便調,這裡怎麼改都不會影響頁面上任何其他東西,這就是「隔離除錯」。

元件預覽 · PrimaryButton
參數控制

在 PlayGround 裡調

剛才的每一次調整,影響範圍只有這一個 demo。樣式和業務邏輯互不干擾,調好的參數直接抄進正式元件,整合時它已經是成品。

直接寫進頁面會怎樣

同樣是調這個按鈕:先把整個頁面跑起來,登入、拉資料、切到目標狀態,才能看到它一眼。樣式和業務邏輯糾纏在一起,圓角改大了可能擠歪旁邊的佈局,牽一髮動全身。

和 Storybook 的關係

思路一致,成本不同。Storybook 是行業標準方案,但配置太重,對 AI 輔助的快速原型專案屬於 overkill。PlayGround 取其思路:用一個靜態頁面把所有元件 demo 排在一起,改元件不影響業務邏輯,調業務邏輯不搞亂元件樣式,成本幾乎為零。

三條維護規則
何時建立

涉及動效必須先建

涉及頁面動效時,必須先建立靜態頁面 PlayGround,用於自由調整和測試元件,之後才允許寫進正式頁面。

同步更新

需求變了 demo 跟著變

需求變化後必須同步更新 PlayGround,保證 demo 始終反映元件的最新形態,別讓它變成過期的擺設。

只增不刪

取消的需求 demo 也保留

demo 元件只增改、不刪除。功能需求取消了,對應 demo 也要留著,它是設計過程的歷史存檔,未來復活需求時直接撿回來用。

互動演示二 · 情景選擇題:這條 demo 怎麼處理

三個真實情景,點選你認為正確的做法,看判定和理由。

AI 對話專案的特殊要求

必須有對話測試頁

專案涉及 AI 對話功能時,PlayGround 中必須實現簡單的對話測試頁面,脫離完整業務流程也能單獨調一輪對話。

列出所有提示詞

頁面上必須列出專案用到的所有 Prompt。提示詞是 AI 產品的核心資產,藏在程式碼字串裡沒法除錯,攤開在頁面上才能快速對比和調整。

本節要點

元件先在試衣間裡調好,再走上臺。PlayGround 用一個靜態頁面的成本,換來元件與業務邏輯的雙向隔離。

試衣間解決的是「新元件怎麼調」。如果專案裡已經攢了八個長得差不多的按鈕,那要先做一次清理才有東西往試衣間裡擺——下一節講樣式收斂:樣式為什麼會增殖,怎麼分批收進 token。

素材來源:對應 rule-opensource.mdc 第三章「PlayGround 元件頁規範」,倉庫 itshen/xs_vibe_rules。