Hyliox Pixel Perfect 是做什麼的?
將 UI 截圖轉換為適合前端代理的冗長、密集且具規範性的建置規格。針對最高忠實度而非簡潔性進行優化。
哲學
此技能會產生一個固定的 21 節規格,約 1000 行,可直接複製貼上至 Cursor / v0 / Lovable / Codex / Claude Code。它是規範性而非適應性:每個輸出中都會以相同順序出現相同的 21 節。如果某個章節在給定的圖片中沒有內容(例如,未見動畫),則明確說明「在此螢幕截圖中未見 — 實作為靜態」,而不是跳過它。可預測的結構勝過變化的機巧。
此技能是從兩個黃金標準輸出(assets/gold-standard-kraken.md 和 assets/gold-standard-agentai.md)逆向工程而來。若對格式、長度或粒度有疑問,請先閱讀黃金標準。它們是事實依據。
忠實度重於解釋。 描述圖片中的內容。不要發明章節、文案、功能或改進。如果圖像顯示三個功能卡片,就描述三個。如果品牌行中重複了 Logo,就重複它。如果導航列中有拼寫錯誤(例如「Why Karken」),請保留它(並提供重建者修正的選擇)。
粒度重於散文。 每個視覺屬性 — 位置、大小、顏色、內邊距、字體粗細 — 都有自己標記的 txt 程式碼區塊。僅在行內代碼中使用散文是不夠的。規格書是可複製貼上的產物,而不是一篇文章。
預設技術棧
- Next.js 16.2(App Router + Turbopack)+ React 19 + TypeScript
- Tailwind CSS(配置在
tailwind.config.ts) - shadcn/ui 基元(在有用之處)
- Framer Motion (
motion/react) - lucide-react 圖示
- 靜態資源在
/public/images/和/public/icons/ - HSL 格式的 CSS 變數(shadcn 慣例:
0 0% 100%原始值,變數內部不加hsl()包裹器)
關於黃金標準的調整說明。 兩個黃金標準範例針對 React + Vite。此技能輸出 Next.js 16 App Router。轉換規則很簡單但必須一致套用:
index.css→app/globals.css- 資源路徑從
<Image>或<img>引用/public/...,使用相對於根目錄的 URL(/images/foo.png) - 使用 Framer Motion、React hooks(
useState、useEffect、useScroll、useInView)、事件處理器、<video>控制項或瀏覽器 API(hls.js)的元件必須在頂部宣告'use client' - 純佈局/靜態內容元件保持為伺服器元件(無
'use client') - 頁面結構顯示 App Router 文件樹(
app/layout.tsx、app/page.tsx、app/globals.css、app/components/...) - 對已知尺寸的靜態圖像使用
next/image;對 GIF、動態或動畫內容使用原始<img>
其餘所有內容(CSS 工具類、毛玻璃系列、fadeUp 輔助函數、動畫模式、分層背景、細邊框技巧)均直接沿用。
工作流程
當技能觸發時,按順序執行以下步驟。不要跳過步驟。
步驟 1 — 閱讀參考文件和一個黃金標準
在開始撰寫任何內容之前,載入:
references/section-templates.md— 21 節模板,包含每個章節的角色、內容規則和格式references/idiom-library.md— 標準 CSS 程式碼片段(毛玻璃系列、細邊框、分層背景、fadeUp、浮動動畫)references/writing-patterns.md— 標記程式碼區塊模式、歧義時的迴避性措辭、反面模式格式- 一個黃金標準作為長度、密度和語氣的具体參考:
- 如果輸入的圖片是暗色/電影感/代理商風格 →
assets/gold-standard-agentai.md - 如果輸入是產品/SaaS/金融科技/支付相關 →
assets/gold-standard-kraken.md - 如果不確定 →
assets/gold-standard-kraken.md(章節覆蓋更全面)
- 如果輸入的圖片是暗色/電影感/代理商風格 →
這些文件很大。在開始時閱讀一次;不要在生成過程中重新閱讀。
步驟 2 — 分析圖片
在撰寫之前,先在內部盤點:
- 分類 沿三個軸(介面類型、藝術方向、情緒基調)— 請參閱
references/section-templates.md中的「寫前準備」章節以獲取完整的標籤詞彙表。分類驅動字體預設、設計 Token 方向以及開頭的「應該感覺像」列表。 - 品牌名稱和 Logo(在導航列中可見)
- 定義頁面的視覺隱喻(Kraken:懸掛的加密貨幣吊墜。AgentAI:紅色生物螢光水母。始終嘗試用一句話命名頁面的視覺靈魂。)
- 章節列表從上到下(導航列、英雄區、證明、品牌條、服務等)
- 調色板 — 主要背景、強調色、卡片表面
- 字體搭配 — 用於標題的展示無襯線字體、用於內文的無襯線字體、可選的用於斜體強調的襯線字體
- 所有可見文案 — 逐字提取,包括錯字和重複
- 毛玻璃 / 模糊 / 噪點 / 顆粒 處理
- 動畫線索 — 任何暗示運動的內容(浮動元素、光暈、懸停提示)
如果有任何內容部分模糊或無法讀取,計劃在規格中標註,使用迴避性措辭(「…與您的客戶」— 如果使用者想要完整的句子則擴展,否則保持逐字)。
步驟 3 — 將規格寫入文件
將規格產出為單一的 Markdown 文件,位於 /mnt/user-data/outputs/<slug>-spec.md,其中 <slug> 是從圖片中可見的品牌名稱衍生的 kebab-case(例如 kraken-spec.md、agentai-spec.md、bloom-spec.md)。只有在無法識別品牌時才回退到 ui-rebuild-spec.md。
文件遵循來自 references/section-templates.md 的固定的 21 節模板。長度目標:800–1300 行。少於 800 行表示粒度不足;多於 1300 行表示冗餘填充。
步驟 4 — 在聊天中呈現文件並簡潔回覆
使用 present_files 呈現規範路徑。聊天回覆最多 3–6 行:
- 涵蓋了哪些章節(或哪些標記為「在此螢幕截圖中未見」)
- 規格中標註的任何不確定性或假設
- 重建者需要做出的任何明確決定(例如,保留錯字、重複的 Logo)
不要在聊天中重複規格。不要總結它。文件才是交付物。
忠實度的硬性規則
這些是不可協商的。它們凌駕於便利性、簡潔性和禮貌性之上。
逐字文案。 圖片中每個可見的文字 — 標題、按鈕、標籤、頁尾、微型文案 — 都必須以原始語言、完全按照書寫方式出現在規格中,包括錯字、標點符號怪癖和重複內容。當保留錯字時,可選擇性地提供重建者選擇(「僅在完全複製可見螢幕截圖時使用 Why Karken;否則使用 Why Kraken」)。
明確的反面模式。 視覺細節比對章節始終包含一個反面模式列表:應避免什麼、不要做什麼、應跳過的顏色方向。例如:「避免藍色、綠色、橙色或多色漸層。將調色板嚴格限制在黑色、紫色、薰衣草色、白色和灰色。不要讓它看起來卡通化。」
不發明。 不要添加圖片中不可見的章節、功能、社交證明、推薦或任何內容。如果圖片在中間被截斷(底部被裁剪),只描述可見的部分並註明截斷。
對無法讀取的內容使用迴避性措辭。 當文字被截斷、部分遮擋或確實有歧義時,不要捏造。標記它:「此卡片在螢幕截圖底部被部分裁剪;顯示的正文是可見的 — 如果使用者想要完整的句子則自然擴展,加上『…』,否則保持逐字。」
分解分層背景。 每個複雜的背景都會被分解為 N 個明確的絕對定位圖層(底色、徑向漸層、噪點疊加、暗角等),並指定它們的堆疊順序。不要合併(例如「點狀網格 + 紫色光暈 + 像素地板」);列出每個圖層及其自己的程式碼片段。
毛玻璃系列命名。 不要強加一個統一的名稱,例如「液體玻璃」。根據它們在圖片中的用途來命名毛玻璃工具類:.glass-nav、.glass-card、.glass-card-soft、.glass-pill、.glass-panel。圖片引導命名。
品牌化色彩命名空間。 當設計具有強烈的品牌調色板時,為 Tailwind 擴展設定命名空間:colors: { kraken: { black, panel, purple, ... } } 或 colors: { redai: { DEFAULT, dark, soft } }。這使規格感覺有針對性而不是通用。
盒子陰影作為命名 Token。 在 Tailwind 配置中定義 boxShadow: { 'red-glow': '...', 'glass': '...' },而不是到處使用行內的 shadow-[...] 字串。然後引用為 shadow-red-glow。
何時在生成過程中諮詢黃金標準
如果你正要撰寫一個章節,但不確定它應該多密集、多細粒度或格式化 — 停下來,重新閱讀匹配的黃金標準中的等效章節。黃金標準定義了標準。例如:
- 正要撰寫 HERO 章節但不確定有多少個子章節(2a、2b、2c)?查看匹配的黃金標準如何建構其英雄區。
- 正要撰寫
間距和佈局細節但不確定 JSON 中應包含哪些鍵?從黃金標準複製結構並將值調整為你的圖片。 - 正要撰寫
視覺細節比對但只有 5 個項目?黃金標準有 15-25 個。找到更多。
黃金標準是校準工具。使用它們。
交付前的格式檢查清單
在呼叫 present_files 之前,掃描草稿一次:
- 長度在 800–1300 行之間(更短 = 規格不足;更長 = 冗餘填充)
- 以「使用…技術棧和核心美學建置一個…」句子開頭
- 所有 21 個章節按順序出現,即使有些顯示「在此螢幕截圖中未見」
- 視覺隱喻在開頭或
全局頁面方向中陳述 - 技術棧已調整為 Next.js 16 App Router(非 Vite)
- 動畫/互動元件上提醒使用
'use client' - 所有可見文案已逐字提取,使用原始語言
- 標題中的斜體襯線強調已被檢測並指出
- CSS 工具類根據其用途命名,而不是根據通用的「液體玻璃」
- Tailwind 配置中的品牌化色彩命名空間
- Tailwind 配置中的盒子陰影命名 Token
- 背景被分解為 N 個絕對定位圖層(未合併)
- 每個視覺屬性都在其自己的標記
txt程式碼區塊中(樣式:、位置:、實作:) -
精確視覺層級按視覺權重對元素進行排名(編號列表) -
間距和佈局細節包含一個帶有像素幾何資訊的 JSON 區塊 -
視覺細節比對包含反面模式(「避免 X,不要 Y」) -
文案內容將所有文案重新組合到一個易於掃描的區塊中 - 對任何被裁剪、歧義或無法讀取的內容應用了迴避性措辭
- 沒有評論、沒有改進建議、沒有開場白
- 規格已寫入
/mnt/user-data/outputs/<slug>-spec.md - 聊天回覆最多 3–6 行