Claude Code UI 設計指南:安裝 Oil UI Skill、提示詞範本與多畫面走查
Claude Code 擅長讀懂程式碼庫結構、拆解多步任務並呼叫子 Agent,但在沒有設計限制時,直接讓它寫介面常會落回藍紫漸層、圓角卡片套卡片和虛構資料指標。把 Oil UI Skill 裝進 Claude Code 後,模型會先按品類做方向探索、生成同畫面對比頁,再基於真實視口截圖和盲審回饋逐輪打磨。
核心要點
要點 1
執行 npx skills add oil-oil/oil-ui 一鍵把開源設計流程裝入 Claude Code,無需改動專案框架或綁定特定元件庫。
要點 2
提示詞優先交代產品是什麼、誰在用、核心任務有哪幾步、目標視口尺寸(如 1440×900 或 390×844),少堆砌空泛形容詞。
要點 3
遇到新產品或首頁改版時,先讓 Claude Code 輸出 3 至 4 個方向的同畫面對比頁,選定一個後再深入互動與狀態。
要點 4
利用 Claude Code 的子 Agent 能力做“無上下文盲審”,只給全頁截圖與 200% 局部裁切圖,抓出字級、間距和對比度問題。
來館觀眾了解「水光與器」秋季特展展期、展廳與器物看點,並完成預約參觀。

水光
與器
暮水
把暮光與池水鋪滿畫面。器物留在暗部,襯線大字只佔安靜的一角。
晨光刊

光落在水面,
也落在器上。
一場關於日常器物與自然光線的展覽。
晨光刊
像翻開一本展覽圖錄,用報刊網格整理晨光、器物與到館資訊。
一窗霧。
半日光。

霧窗
把油畫裝進一扇畫窗,讓水霧青瓷與紙面留白慢慢展開。
為什麼在 Claude Code 裡做介面需要設計 Skill
很多開發者習慣在 Claude Code 裡直接輸入“幫我做一個現代、簡潔、高級的 SaaS 首頁”。模型收到這類指令後,通常會調取訓練資料裡最常見的一套範本:置中大標題上方放一個膠囊小標籤,下方排三張等寬圓角卡片,右側塞滿生造的百分比漲跌和折線圖。程式碼能跑通,但頁面看起來像隨手生成的演示稿。
Oil UI 給 Claude Code 補上了一套貼近人類設計師的工作順序:先根據產品品類和使用者任務找參考坐標,再把幾個截然不同的視覺方向放到同一張網頁裡對比;選定方向後,在真實瀏覽器視口裡檢查首屏重心、長文閱讀、表單錯誤提示和手機端折行。
| 環節 | 直接讓 Claude Code 寫介面 | 搭配 Oil UI Skill 後的做法 |
|---|---|---|
| 起點 | 憑空套用通用 SaaS 範本與預設配色 | 先梳理品類特徵、目標使用者與主操作,提出多個不同方向 |
| 方向選擇 | 一次只給一版,不滿意只能重寫 | 內建同畫面對比頁,在 1440px 或 390px 下並排挑方向 |
| 內容與資料 | 容易生造 99.9%、+24% 等假指標充版面 | 圍繞真實業務欄位排布層級,刪掉無意義的裝飾數字 |
| 品質驗收 | 寫完程式碼即結束,靠肉眼重新整理排查 | 啟動無上下文子 Agent 看真實截圖盲審,逐項修完再交付 |
三步完成安裝與環境準備
Oil UI 支援個人全局安裝與專案級安裝。全局安裝適合日常在不同倉庫間切換;專案級安裝適合把設計規範隨程式碼庫共享給團隊成員。
執行安裝器並勾選 Claude Code
在終端機執行安裝指令,按提示選擇 Claude Code 以及安裝範圍(全局 ~/.claude 或當前專案目錄)。
npx skills add oil-oil/oil-ui準備可截圖的本機瀏覽器環境
Oil UI 的視覺檢驗依賴真實頁面渲染。確保本機可以透過 Playwright、本機開發服或瀏覽器工具開啟頁面並截取 1440×900(桌面)與 390×844(手機)視口圖片。
需要完整互動、既有專案改造與深度走查時安裝 Pro
如果已經購買 Oil UI Pro,直接執行 CLI 安裝並完成設備授權。已裝 Pro 時無需同時保留開源版,避免兩個 Skill 爭搶同一類請求。
npx github:oil-oil/oil-cli install oil-ui-pro
給 Claude Code 的高信噪比提示詞寫法
在畫廊收錄的 Claude 系列作品裡(如 Claude Opus 5.5 製作的平板閱讀器《頁邊》、語音助手《應聲》,以及 Claude Sonnet 5.5 製作的打車應用《來接》與《Pinch 結帳》),提示詞都遵循同一個結構:先寫產品與受眾,再寫核心互動與關鍵狀態,最後標明視口尺寸和交付物。
- 交代清楚誰在什麼場景下用
- 比如做打車 App,直接寫明“乘客從上車點確認、等待司機接駕到行程中改目的地的三畫面流程”,比寫“做一個好看的出行軟體”清楚得多。
- 點出最值得打磨的那一個動作
- 每個介面都應該有一個視覺和互動重心。例如結帳模組的重心是優惠碼展開、運費重算與支付按鈕的狀態回饋;閱讀器的重心是正文排版、目錄抽屜與批註高亮。
- 明確視口尺寸與需要覆蓋的狀態
- 寫明桌面端從 1440×900 到 390 寬響應式,或行動端 390×844 三畫面並排(screens.html),並列出需要看到的 3 個真實狀態。
用 Oil UI 為我們的 [產品類型,例如:獨立書店線上結帳模組] 設計介面。
- 目標使用者與任務:[例如:買書讀者在單欄或雙欄結帳頁核對書目、切換自提或快遞、輸入優惠碼並完成支付]
- 核心互動與狀態:重點打磨 [最關鍵的操作],需要覆蓋 [狀態 1:預設填寫]、[狀態 2:運費與折扣即時更新]、[狀態 3:卡號驗證錯誤提示與恢復]。
- 技術與環境限制:沿用當前倉庫技術棧,桌面視口 1440×900 並相容 390 寬手機視口。
請先提出幾個不同的設計方向供我對比,選定後再進入實現與截圖走查。把方括號裡的內容換成你的真實業務欄位,直接發給 Claude Code。
用 Claude Code 子 Agent 做真實截圖盲審
寫完程式碼的 Agent 往往對自己剛寫出的佈局有濾鏡,看到擁擠的卡片或看不清的淺灰小字也會覺得合理。Oil UI 的做法是讓主 Agent 截取渲染後的頁面圖片,再啟動一個完全不知道剛才寫過什麼程式碼的獨立子 Agent 來挑毛病。
子 Agent 會同時檢視三類畫面:100% 原始比例的首屏與長頁捲動截圖、200% 放大的高頻互動局部(如導覽列、表格行、表單輸入區),以及把文字模糊成色塊後的版面結構圖。只有當盲審不再指出層級混亂、溢出截斷或 AI 俗套痕跡時,這一輪打磨才算完成。
畫廊真實案例與提示詞參考
瀏覽同類案例合集 →什麼時候從開源版升級到 Oil UI Pro?
開源版適合把單個新頁面做好看。如果你在用 Claude Code 改造正在跑的真實既有專案、搭建複雜後台工作台,或者需要把表單錯誤提示恢復、手機端適配和可選最多 3 輪衝 9 分的實機深度打磨一次配齊,可以直接升級到 Oil UI Pro($19.99 一次買斷)。
了解 Oil UI Pro 完整功能 →npx github:oil-oil/oil-cli install oil-ui-pro常見問題
Oil UI 會強制 Claude Code 使用 React、Tailwind 或某套元件庫嗎?
不會。Oil UI 提供的是設計方法、版式判斷和視覺走查流程。無論你的倉庫用 Next.js、Vue、Svelte、原生 HTML/CSS 還是現有元件庫,Claude Code 都會在你的工程限制內實現介面。
Claude Opus 和 Claude Sonnet 搭配 Oil UI 有什麼差別?
Opus 在字級比例、留白節奏和長頁面的整體視覺敘事上通常更穩;Sonnet 響應速度更快,適合單模組打磨、元件狀態補齊或已有設計方向下的頁面擴展。兩者都能直接讀取同一套 Skill。
如果我想參考某張現有的參考圖或截圖,該怎麼和 Claude Code 說?
直接把參考圖路徑發給 Claude Code,並說明是“按原圖高保真還原(透過像素差異比對逐輪收斂)”還是“只借用這張圖的色調與排版節奏,換成我自己的產品內容”。Oil UI 針對這兩種場景有專門的執行分支。
裝好後怎麼確認 Claude Code 已經用上了 Oil UI?
你可以在提示詞開頭直接寫“用 Oil UI 設計……”。正常工作時,Claude Code 不會一上來直接改業務程式碼,而會先梳理任務焦點、給出方向建議或生成方向對比頁,並在實現後主動開啟瀏覽器截圖檢查。



