在 Cursor、Windsurf 與主流編程 Agent 中使用 Oil UI 設計介面
日常開發中,很多團隊是在 Cursor、Windsurf、Antigravity 或 Gemini CLI 裡一邊改業務程式碼、一邊調整介面。Oil UI 採用標準開放的 Skill 目錄結構,透過 npx skills add oil-oil/oil-ui 即可裝入這些主流編程 Agent,讓模型在你的真實程式碼庫裡遵守“先看任務與方向、再寫元件與狀態、最後看瀏覽器截圖”的流程。
核心要點
一條指令支援主流 Agent
npx skills add oil-oil/oil-ui 可安裝到 Cursor、Windsurf、Claude Code、Codex 等環境。
要點 2
在既有專案裡用 IDE Agent 改介面時,先圈定單頁面或單任務範圍,並聲明哪些API 欄位和業務行為不能動。
要點 3
做局部元件或獨立模組(如上傳器、結帳框、機械鍵盤配置器)時,直接要求覆蓋預設、操作中、完成與異常四個狀態。
要點 4
善用 IDE 內建終端機啟動本機開發服,讓 Agent 截取真實渲染畫面自查,而不是只看程式碼 diff。
跨 Agent 安裝方式與目錄選擇
無論你偏好在 IDE 側邊欄裡用 Cursor Agent、Windsurf Cascade,還是在終端機裡搭配 CLI Agent 工作,Oil UI 讀取的都是同一套結構化設計指南與檢查表。
執行通用安裝指令
在專案根目錄或任意終端機執行安裝器,按介面提示勾選你正在使用的 Agent(如 Cursor、Windsurf、Claude Code、Codex 等)。
npx skills add oil-oil/oil-ui團隊協作建議選專案級安裝
如果希望團隊成員在各自 IDE 裡開啟專案都能用上同樣的 UI 走查標準,安裝時選擇當前專案範圍,讓每個人的 Agent 都讀取同一份規範。
在對話開頭顯式喚醒 Skill
在 IDE 對話框裡輸入“用 Oil UI 設計……”或“按 Oil UI 改造當前頁面”,Agent 就會按設計流程執行,而不是直接往檔案裡塞零散樣式。
在 IDE 裡邊寫業務邊做 UI 的四個實用習慣
在 IDE 裡做介面最常見的翻車原因,是把“加一個後端欄位”和“重做整頁視覺”混在同一條對話裡,導致模型既改壞了狀態邏輯,又只做了半截樣式。把任務邊界劃清楚,產出品質會高得多:
- 一次只改一個閉環任務或一個獨立模組
- 例如先專門打磨檔案上傳模組(如畫廊中的《Chute》上傳元件),把拖曳進入、分片進度、連結複製與過期設定做扎實,再推進下一個模組。
- 明確列出必須保留的 props、路由與狀態欄位
- 改造現有 React/Vue 元件時,告訴 Agent:“保留現有的 useCheckout 鈎子、表單送出函式和路由參數,只重構檢視層與互動回饋。”
- 把方向對比頁放到臨時路由或獨立 HTML
- 需要探索新視覺方向時,讓 Agent 先在獨立預覽頁裡把 3 個方向排出來。選定方向後,再把勝出方向的變數和結構合入主工程。
- 要求 Agent 開啟本機端口截圖驗證
- 不要只看 IDE 裡的程式碼變更就點全部接受。讓 Agent 連上 localhost 截取 1440px 與 390px 的實際畫面,確認沒有擠壓變形後再合併。
IDE 內常用的兩類提示詞範本
在 Cursor 或 Windsurf 中,最常遇到的兩類需求是“新建一個高完成度的互動模組”和“把專案裡現有的粗糙頁面改順眼”。下面給出可直接套用的提示詞:
用 Oil UI 設計並實現當前專案中的 [模組名稱,例如:檔案分享上傳模組 / 線上配置面板]。
- 保留限制:沿用現有的 [元件框架與API 定義],不改動後端 API 資料結構。
- 互動與狀態:完整實現 1) 預設待操作態、2) 拖曳或輸入中的即時回饋、3) 處理進度與完成態(含複製/匯出回饋)、4) 驗證失敗或超限錯誤提示態。
- 視覺要求:去掉多餘的外層巢狀卡片與裝飾性小膠囊,靠字級對比、留白和清晰的焦點狀態組織版面。完成後在本機瀏覽器截圖檢查。適合在 IDE 中選中目標元件檔案後直接發送給 Agent。
畫廊真實案例與提示詞參考
瀏覽同類案例合集 →在 IDE 中啟用 Oil UI Pro 的既有專案分步改造與元件精修
Oil UI Pro 針對已有程式碼庫提供了專門的“單頁診斷標註”和“三步改造流程”(只收拾視覺噪音 / 升級佈局與狀態 / 重梳任務流並沉澱 DESIGN.md),同時包含單一元件精修與 19 種卡片容器原型。
了解 Oil UI Pro 完整功能 →npx github:oil-oil/oil-cli install oil-ui-pro常見問題
Cursor 和 Windsurf 裡用哪個底層模型搭配 Oil UI 效果更好?
在探索新頁面方向、定版式基調時,建議選用 Claude Opus 或最新一代 GPT/Codex 模型;在方向已定、需要批量補齊表單狀態或按 DESIGN.md 統一相鄰頁面時,Claude Sonnet 或高速模型也能高效完成。
我的專案用了 shadcn/ui、Radix 或 Ant Design,還能用 Oil UI 嗎?
完全可以。無頭元件庫(如 Radix)或基礎元件集解決的是底層無障礙與基礎控制項封裝,但無法阻止模型把頁面排成千篇一律的卡片網格。Oil UI 負責決定頁面怎麼佈局、資訊怎麼分主次、多餘的框線怎麼刪減,兩者互補。
怎麼防止 IDE Agent 在改樣式時誤刪原有的點擊事件或表單驗證?
在提示詞裡明確寫出“保持現有事件綁定與驗證邏輯不變”,並在改完後按 Oil UI 的走查步驟,在瀏覽器裡真點、真填一遍核心任務(包括故意輸錯一次看看錯誤提示是否正常顯示)。
可以在同一個倉庫裡既用 Cursor 又用終端機裡的 Claude Code / Codex 嗎?
可以。安裝時勾選你常用的多個 Agent,或者使用統一的走查與 DESIGN.md 規範,不同工具都能接著上一輪的進度繼續打磨。



