Oil UI
場景實戰 · 既有專案介面改造

既有專案 UI 改造與體驗翻新:在不改壞業務邏輯的前提下重整介面

從零生成一個新演示頁很容易,難的是改一個已經在跑的真實專案:API 欄位不能動、已有表單驗證和路由參數不能丟、改了首頁還得讓列表頁和設定頁長成一家人。最穩妥的做法是先鎖死不能碰的業務紅線,按痛點分步推進改造,親自把核心任務點一遍數清步數,在第一個標桿頁定稿後寫成 DESIGN.md,再推向全站。

核心要點

動手前先劃清紅線

列出絕對不能改動的API 欄位、路由參數、權限判斷與提交流程。

分三步穩妥翻新

第 1 步只清多餘框線與雜色,第 2 步重排單頁主次與狀態,第 3 步砍掉繁瑣跳轉。

用「數點擊次數」檢驗體驗

把「進詳情頁逐條改再返回」的 8 步流程壓成同畫面 2 步批處理,比換套顏色更有價值。

要點 4

首個標桿頁過關後,把色彩、字級和間距規則寫成專案裡的 DESIGN.md,後續頁面自動長成一家人。

完成任務點擊步數
2步
跨頁跳轉次數
0次
走查回頭路風險
一步到位 · 同屏看上下文,2 步批次標完
枝間 · 客戶通訊簿
上週未回覆佇列 (3)
10.06
10.08
10.09
已勾選 2 位客戶
通訊上下文預覽

周予 · 小滿書店

秋刊書展導視與會員卡設計

上次發信
10.06 · 初稿方案已發送
當前狀態
等待客戶回覆
「秋刊書展導視與會員卡設計的初稿已發,請方便時過目。若本週可以確認,我們就按計畫推進下一階段。」
安裝 Oil UI Pro 獲取完整既有專案分步改造與診斷工作流
npx github:oil-oil/oil-cli install oil-ui-pro

如果只想先在單個頁面試試基礎方向對比與去塑膠感,也可先執行 npx skills add oil-oil/oil-ui 安裝免費開源版。

既有專案改造的三個步驟:別把小修做成傷筋動骨的重構

很多團隊不敢讓 AI 碰既有專案,是因為一句“幫我美化一下這個頁面”下去,模型常常把元件拆得七零八落,甚至順手刪掉了原本好用的篩選器和匯出按鈕。在 Oil UI(特別是 Oil UI Pro 的既有專案改造模組)中,我們會先根據專案現狀分三步穩妥推進:

既有專案 UI 改造的三個步驟與適用場景
改造步驟適用現狀改動範圍不改動的部分
第 1 步:收拾視覺噪音 (Tidy up)功能流程沒問題,但框線過多、字級混亂、配色顯髒或充滿早期 AI 套路統一字級行高、刪掉多餘外框與巢狀卡片、收斂色彩、對齊表格與表單間距DOM 主結構、路由、狀態管理與所有互動流程保持原樣
第 2 步:單頁佈局與狀態升級 (Upgrade)頁面資訊主次顛倒、首屏抓不住重點,或缺少空狀態、載入態與錯誤提示恢復重排頁面區塊主次、調整多欄比例、補齊載入/空/錯誤/完成四態與行動端適配後端 API 契約、已有業務規則與跨頁面跳轉關係保持不變
第 3 步:重梳任務流與設計規範 (Rework flow)操作路徑繞遠路、彈出視窗套彈出視窗、多頁風格割裂,使用者完成一次任務要多點好幾步合併冗余步驟、把深埋的高頻操作拿到明面、確立標桿頁並生成全站 DESIGN.md底層資料模型與核心商業邏輯不變,前端互動路徑做減法重構

四步穩妥翻新一個運作中的專案

無論你的專案是合同審閱工具(可參考畫廊中的《墨契 MOQI》)、迭代看板(《Relay》)、郵件用戶端(《Post》)還是電商結帳頁(《Pinch 結帳》),都可以按下面四步推進改造:

  1. 對當前頁面截圖,做帶編號的單頁診斷

    先讓 Agent 開啟本機執行中的舊頁面截圖,標出真正影響閱讀和操作的病灶(例如:1. 頂部三個同色按鈕分不清主次;2. 表格 12 列擠在 1000px 內導致文字直排;3. 錯誤提示只彈 alert 不標紅具體輸入框)。

  2. 選定一個代表性標桿頁,做方向探索

    不要一上來同時改 20 個路由。挑出使用者每天停留最久的那一個頁面(如主工作台或核心詳情頁),用真實業務資料跑出 2 至 3 個改造方向,在瀏覽器裡並排比對。

  3. 走完一次真實任務,並數一數點擊次數

    在改好的頁面上模擬真實使用者從進入到完成任務的全過程:填表、篩選、觸發一次錯誤提示並恢復、提交保存。檢查是否減少了不必要的彈出視窗確認和來回跳轉。

  4. 把標桿頁沉澱為 DESIGN.md,再批量統一其餘頁面

    標桿頁驗收通過後,讓 Agent 把這套頁面的背景色階、正文字級、表格密度、按鈕樣式和停用套路寫進專案根目錄的 DESIGN.md,再按同一份規範依次改造相鄰頁面。

既有專案單頁改造提示詞範本

在 Claude Code、Codex 或 Cursor 裡改造現有頁面時,用下面的提示詞可以把風險鎖在可控範圍內:

既有專案 UI 改造提示詞範本(保護現有業務邏輯)
用 Oil UI 改造當前專案中的 [頁面路由或元件路徑,例如:app/billing/page.tsx]。
- 嚴禁改動的業務行為:完整保留現有的 [資料拉取鈎子、篩選參數、表單驗證規則、匯出與提交事件],不要刪減任何已有業務欄位。
- 當前頁面痛點:[例如:資訊全部堆在等寬卡片裡分不清主次;表格列太擠;缺少篩選為空和扣款失敗時的介面回饋]。
- 本次改造步驟:[選擇:第 1 步 僅清理視覺噪音與對齊間距 / 第 2 步 重排單頁主次佈局並補齊狀態 / 第 3 步 簡化操作步驟並提煉 DESIGN.md]。
請先截取當前舊頁面做問題診斷,給出改造方案對比,完成後在 1440×900 與 390×844 下截圖核對。

先把“嚴禁改動的業務行為”列在第一條,能有效防止 Agent 誤刪業務程式碼。

畫廊真實案例與提示詞參考

瀏覽同類案例合集 →
Oil UI Pro

用 Oil UI Pro 穩妥翻新正在跑的既有專案

改既有專案最怕 AI 順手刪掉原有篩選器或改壞表單邏輯。Oil UI Pro 會先對舊頁面截圖示注病灶,按「清噪音、調佈局、省步驟」分三步改造,親手點完真實任務削減點擊步數,並生成全站共用的 DESIGN.md($19.99 一次買斷)。

了解 Oil UI Pro 完整功能 →
複製 Pro 安裝提示詞
npx github:oil-oil/oil-cli install oil-ui-pro

常見問題

改造既有專案時,應該先改全局 CSS 變數還是先改某一個具體頁面?

先改一個最有代表性的具體頁面。憑空定一套全局 CSS 變數往往脫離真實業務密度;先把核心工作台或核心落地頁改到順眼、好用,再從這個真實頁面裡反推出 DESIGN.md 和全局樣式變數,準確率高得多。

既有專案裡用了很多第三方歷史元件,能一點點漸進改造嗎?

可以。先做第 1 步(收拾視覺噪音)或第 2 步(單頁佈局升級)時,可以讓 Agent 只調整外層網格佈局、間距、字級和顏色變數,保留內部複雜的歷史元件不動,按頁面逐個推進。

怎麼判斷一次既有專案改造是真的變好用了,而不只是換了層皮?

看兩件事:第一,遮住文字看版面色塊,首屏主操作和異常告警是否一眼能掃到;第二,親自走一遍最常用的任務,看點擊次數、視線跳躍和表單錯誤提示恢復是不是比舊版更順手。

DESIGN.md 生成後放在哪裡?之後怎麼用?

放在專案根目錄或 docs/ 下。之後無論你或團隊成員在 Claude Code、Codex 還是 Cursor 裡新寫頁面,只需帶上一句“遵循專案 DESIGN.md 並使用 Oil UI”,新頁面就會自動沿用統一的視覺語言。

延伸閱讀

Cursor 與 Windsurf UI 設計指南 ↗去掉 AI 介面塑膠感指南 ↗真實視口截圖與子 Agent 盲審 ↗