Community影像github.com

Hyliox Pixel Perfect

將 UI 截圖(登陸頁面、應用程式畫面、儀表板、模型)轉換為像素級精確、開發者可直接使用的重建提示,供 AI 編碼代理(Cursor、v0.dev、Lovable、Codex、Claude Code)使用,目標為 Next.js 16 App Router + Tailwind + shadcn/ui + Framer Motion。

Hyliox Pixel Perfect 是什麼?

此技能專為追求極致還原度的前端開發者設計,能將任何 UI 截圖轉換成長達約 1000 行、結構固定的 Markdown 規格文件。它採用 21 個預定義章節模板,涵蓋技術棧、設計 Token、Tailwind 配置、動畫、視覺層次和精確佈局等所有細節,確保 AI 編碼代理能完全複製原始設計。支援多種觸發指令,包括 `/hyliox-pixel-perfect`、`/pixel-perfect` 或「rebuild this UI」等,並以英文產出規格文件。其核心原則是「忠實度重於解釋」,嚴格要求逐字複製所有可見文案、分解複雜背景並避免任何發明或改進建議。此工具特別適合需要使用 Cursor、v0、Lovable、Codex 或 Claude Code 等 AI 代理進行前端專案重建的開發者。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/ys-sites/video/tree/HEAD/hyliox-pixel-perfect

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 — 閱讀參考文件和一個黃金標準

在開始撰寫任何內容之前,載入:

  1. references/section-templates.md — 21 節模板,包含每個章節的角色、內容規則和格式
  2. references/idiom-library.md — 標準 CSS 程式碼片段(毛玻璃系列、細邊框、分層背景、fadeUp、浮動動畫)
  3. references/writing-patterns.md — 標記程式碼區塊模式、歧義時的迴避性措辭、反面模式格式
  4. 一個黃金標準作為長度、密度和語氣的具体參考:
    • 如果輸入的圖片是暗色/電影感/代理商風格 → 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 行

相關技能