For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽
Codex

Codex use case

打造回應式前端設計

將螢幕截圖和視覺參考資料轉化為回應式 UI,並進行視覺檢查。

Difficulty 中級
Time horizon 1 小時

使用 Codex 將螢幕截圖和設計需求說明轉換為符合程式碼庫設計系統的程式碼,再使用 Playwright 針對不同螢幕尺寸比對實作成果與參考資料,並反覆調整,直到外觀符合預期。

最適合

  • 從零建立新的前端專案
  • 將螢幕截圖中已設計好的畫面或流程實作至現有程式碼庫

Contents

    ← 所有使用案例

    打造回應式前端設計

    將螢幕截圖和視覺參考資料轉化為回應式 UI,並進行視覺檢查。

    使用 Codex 將螢幕截圖和設計需求說明轉換為符合程式碼庫設計系統的程式碼,再使用 Playwright 針對不同螢幕尺寸比對實作成果與參考資料,並反覆調整,直到外觀符合預期。

    中級
    1 小時

    使用 Codex 將螢幕截圖和設計需求說明轉換為符合程式碼庫設計系統的程式碼,再使用 Playwright 針對不同螢幕尺寸比對實作成果與參考資料,並反覆調整,直到外觀符合預期。

    中級
    1 小時

    相關連結

    最適合

    • 從零建立新的前端專案
    • 將螢幕截圖中已設計好的畫面或流程實作至現有程式碼庫

    技能與外掛程式

    • 在實際的瀏覽器中開啟 App,以驗證實作成果,並反覆調整版面配置和行為。
    Skill Why use it
    Playwright 在實際的瀏覽器中開啟 App,以驗證實作成果,並反覆調整版面配置和行為。

    起始提示詞

    在目前專案中實作這個 UI,並以我提供的螢幕截圖和備註為準。 要求: - 沿用現有設計系統的元件和 Token。 - 依照此程式碼庫的工具類別和元件模式實作螢幕截圖中的設計,而不是另建一套平行系統。 - 讓間距、版面配置、層次結構和回應式行為與參考資料高度一致。 - 遵循此程式碼庫的路由、狀態管理和資料擷取模式。 - 讓頁面在桌面和行動裝置上均採用回應式版面。 - 如果螢幕截圖中的任何細節不明確,請選擇仍符合整體方向的最簡單實作方式,並簡短註明該項假設。 驗證: - 從外觀和行為兩方面,比對完成後的 UI 與所提供的螢幕截圖。 - 使用 $playwright-interactive 檢查 UI 是否符合參考資料,並視需要反覆調整,直到相符為止。
    在目前專案中實作這個 UI,並以我提供的螢幕截圖和備註為準。 要求: - 沿用現有設計系統的元件和 Token。 - 依照此程式碼庫的工具類別和元件模式實作螢幕截圖中的設計,而不是另建一套平行系統。 - 讓間距、版面配置、層次結構和回應式行為與參考資料高度一致。 - 遵循此程式碼庫的路由、狀態管理和資料擷取模式。 - 讓頁面在桌面和行動裝置上均採用回應式版面。 - 如果螢幕截圖中的任何細節不明確,請選擇仍符合整體方向的最簡單實作方式,並簡短註明該項假設。 驗證: - 從外觀和行為兩方面,比對完成後的 UI 與所提供的螢幕截圖。 - 使用 $playwright-interactive 檢查 UI 是否符合參考資料,並視需要反覆調整,直到相符為止。

    簡介

    當你有螢幕截圖、簡短的設計需求說明,或一些可供汲取靈感的參考資料時,Codex 能在沿用專案既有模式的前提下,將這些資料轉化為回應式 UI。

    透過 Playwright 技能,Codex 可以在實際的瀏覽器中開啟 App,針對不同螢幕尺寸比對實作成果與螢幕截圖,並反覆調整版面配置或行為,讓成果更接近目標。

    從參考資料著手

    請向 Codex 提供最清楚、最能呈現所需 UI 的參考資料。若是範圍較小的任務,一張螢幕截圖可能就足夠;但若能納入桌面版和行動版配置、游標暫留或選取狀態,以及任何重要的空白或載入畫面等多種狀態,交付內容會更完善。

    這些參考資料不必是完美的設計交付成果,只要能具體呈現預期的層次結構、間距和整體方向,讓 Codex 不必猜測即可。

    具體說明

    對預期的互動模式和想要的風格描述得越具體,結果就會越好。 模型通常會預設採用常見的模式和風格,因此如果參考資料未明確顯示你想採用其他做法,UI 可能會顯得普通。 你提供的資訊越多,無論是更多可供汲取靈感的參考資料,還是更具體的指示,就越有可能得到更具特色的 UI。

    準備設計系統

    當目標程式碼庫已有清楚明確的元件層時,Codex 的效果最佳。Codex 可以自動沿用現有的元件和設計系統,不必從零重建一套。

    如果你認為有必要(例如未使用標準技術堆疊),請向 Codex 說明應沿用哪些基礎元件、Token 存放在何處,以及此程式碼庫對按鈕、輸入欄位、卡片、排版和圖示採用哪些標準實作。

    如果是以現有程式碼庫為起點,Codex 很可能會自行理解該如何使用你的元件和設計系統;但如果從零開始,最好明確說明這些事項。

    請 Codex 將螢幕截圖視為視覺目標,但依照專案實際採用的工具類別、元件包裝器、色彩系統、排版層級、間距 Token、路由、狀態管理和資料擷取模式來實現該目標。

    善用 Playwright

    Playwright 是協助 Codex 反覆調整 UI 的絕佳工具。Codex 可以使用它在實際的瀏覽器中開啟 App,比對實作成果與你提供的螢幕截圖,並反覆調整版面配置或行為。

    它可以將瀏覽器視窗調整成不同的螢幕尺寸,並檢查各個中斷點的版面配置。

    請確認已在 Codex 中啟用 Playwright 互動式技能。如需詳細資訊,請參閱 技能文件

    反覆調整

    第一輪實作的整體方向應該就會接近螢幕截圖。如果 UI 的版面配置或互動複雜,或包含大量動畫,可以預期還需要調整幾輪。

    請 Codex 對照螢幕截圖比較實作成果,而不只是確認頁面能否成功建置。發生衝突時,應優先採用程式碼庫的設計系統 Token,並且只對間距或尺寸做維持設計整體外觀所需的最小幅度調整。

    若有助於釐清單張圖片中不明顯的狀態,請使用額外的螢幕截圖或簡短備註。

    建議的後續提示詞

    [current implementation image] [reference image] 這看起來不太對。請務必實作出與參考資料高度一致的成果: [if needed, specify what is different]

    相關使用案例