Community影像github.com

Isometrics (線條風格)

在 React + SVG 中繪製並動畫呈現外框線條風格的等角投影物件,適用於空白狀態、封鎖狀態與插圖,具備精確的等角數學運算、1 像素外框、一個品牌標記與一個動作節拍,並透過渲染與截圖進行驗證。

Isometrics (線條風格) 是什麼?

此技能會將簡短的需求(如「畫廊等角圖」、「空的收件匣狀態」)轉化為一個繪製且帶動畫的完整物件,包含插圖、標題、說明文字與按鈕。每個物件都是由 3D 基元在世界單位中建構,並以真正的等角投影呈現,因此所有物件共享同一個網格、同一種外框與同一種外觀。技能包含一個嚴格的工作流程,分為五個階段:理解需求、提出三個概念、分解物件、選擇動作節拍、建構與驗證。最終成品需通過自動化檢查器(使用 Playwright),確保無 Hydration 錯誤、外框約 1 像素、動畫確實回到靜止姿態、且符合光學尺寸範圍(140–175 像素),並要求開發者人工審視視覺品質。支援所有 React 專案,並應用了 Tailwind CSS、shadcn/ui 與 motion 套件。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/craftUI012/Skills/tree/main/isometrics

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

在你喜歡的 AI 中提問

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

說明文件

Isometrics(線條風格)

您可將簡短的需求(例如「畫廊等角圖」、「空的收件匣狀態」)轉化為一個繪製且帶動畫的物件,作為一個完整的狀態交付:包含插圖、標題、一行說明文字與一個按鈕。每個物件皆由 3D 基元以世界單位建構,並以真正的等角投影呈現,因此所有物件共享同一個網格、同一種外框與同一種外觀。

一句話總結其外觀:一個物件,如果是平面則正面朝向,如果是立體則呈等角角度;具有 1 像素的外框、紙白色的面、一個小巧的品牌色標記、無陰影、無發光、一個動作節拍,然後回歸靜止。

您不能跳過任何階段。在檢查器通過且您已檢視過物件的 sheet 之前,不得宣告物件完成。

目錄

檔案何時閱讀
SKILL.md始終:工作流程與規則
references/brief-to-concept.md第 1–2 階段:將模糊的需求轉化為三個概念
references/motion.md第 4 階段:選擇與設定節拍時機
references/line-style.md第 3–5 階段:所有繪圖規則、應做與不應做的事項及原因
references/engine-api.md建構過程中:引擎與 Line 套件
references/isometric-math.md當形狀需要引擎未提供的數學運算時
examples/*.tsx建構之前:從最接近的範例開始
engine/iso-core.tsx、engine/iso-line.tsx每個專案複製一次
scripts/check.mjs第 5 階段:嚴格的渲染檢查

設定(每個專案一次)

物件是 React Client Component,專案需使用 Tailwind CSS 與 shadcn/ui(使用 @/lib/utils 中的 cn 與 @/components/ui/button),以及 motion 套件。

  1. 檢查 components/isometrics/iso-core.tsx 是否存在。如果缺少,請將此技能中的 engine/iso-core.tsx 與 engine/iso-line.tsx 複製到 components/isometrics/(或使用者偏好的資料夾;物件會以相對路徑匯入它們,因此它們需位於同一個資料夾)。

  2. 如果專案沒有 motion:安裝它(npm i motion,或使用專案的套件管理器)。如果沒有 shadcn Button:執行 npx shadcn@latest add button。

  3. 針對檢查器,需要 Playwright:npm i -D playwright 與 npx playwright install chromium(或使用已安裝的 Chrome)。

  4. 建立一個頁面來單獨渲染一個物件,並使用 PlayOnHover 包裹(檢查器透過懸停來播放動畫),例如在 Next.js 中的 app/isometrics-preview/<name>/page.tsx,或使用專案自己的路由:

    import { PlayOnHover } from "@/components/isometrics/iso-line";
    import { MapPin } from "@/components/isometrics/map-pin";
    
    export default function Page() {
      return (
        <main className="flex min-h-svh items-center justify-center p-10">
          <PlayOnHover><MapPin /></PlayOnHover>
        </main>
      );
    }
    

    為每個物件建立此頁面;告知使用者這是可刪除的預覽頁面。

切勿為了讓單一物件運作而編輯引擎。如果確實缺少某種形狀,請在物件本身的檔案內新增一個輔助函式,並從 3D 建構,然後告知使用者。

工作流程

第 1 階段 · 理解需求

在開始任何其他事情之前,將要求轉化為三個答案:

  • 主題: 事物或主題(「畫廊」→ 照片、相簿、圖片)。
  • 用途: 它所服務的狀態:empty(尚無任何內容)、blocked(無法存取、離線、未連線、找不到)、nothing found(搜尋、篩選)、success / all clear,或功能卡中的 spot 插圖。
  • 訊息: 狀態所傳達的一句平實句子(「您還沒有任何照片」)。

如果未明確說明用途,需求通常可能符合多種用途;概念就是為此而生。請參閱 references/brief-to-concept.md。

第 2 階段 · 提出三個概念,然後等待

除非需求已明確指定一個物件與一種狀態,否則請向使用者展示一個包含三個概念的表格,然後停止並等待他們選擇:

物件訊息(標題)一個節拍
A ★………
B………
C………

每個概念必須通過以下四項測試:

  1. 在 120 像素的縮圖中可被辨識為輪廓。 一個無需顏色就能被認知的剪影。
  2. 圓潤勝過方正。 圓潤的物體在線條風格中讀起來更友善;單純的方盒讀起來像包裹或線框。
  3. 單一物件。 不是場景,也不是一堆物體。僅在第二個小零件屬於該物件的一部分時(例如蓋子、旗幟、手)才允許。
  4. 節拍傳達了訊息。 動作是句子的動詞(請參閱 references/motion.md)。如果您無法為節拍命名,那就選錯了物件。

用 ★ 標記您的推薦,並用一行說明原因。三個概念要有所變化:不同的物件、不同的節拍。當需求很具體時(例如「一個帶托盤的空收件匣狀態」),請跳過表格,直接說明您的選擇與節拍,然後繼續。

第 3 階段 · 將物件分解為零件

在編寫程式碼之前,以世界單位建立一個零件表格:每個零件、它所使用的基元(Extrude、Slice、Ring、FacePath、Box…)、在 0.5 網格上的尺寸與位置、是否會移動,以及哪個零件是品牌標記。然後是文案:標題(≤ 28 個字元)、一兩句說明、按鈕標籤(≤ 22 個字元)及其圖示(圖示需與動詞一致:只有在動作是新增時才使用加號)。

決定零件的規則(全部在 references/line-style.md 中):

  • 首先選擇視角。 扁平或薄型物件(頁面、徽章、圓盤)使用 view="front";方正或深型物件(印表機、盒子、伺服器、托盤、放在桌上的棍子)使用 view="isometric"。正面朝向的方盒讀起來像是帶有雙線的扁平貼紙。
  • 建構在 +y 方向、以 x = 0 為中心,立足於 z = 0。
  • 三個細節層級:外形、人們用來辨識它的零件,以及低調的標記(螺絲、通風口、接縫、標籤)。
  • 乾淨的線條:正面視角的實體沒有深度,或具有明確的深度(條帶 ≥ ~4 像素);零件要嘛齊平,要嘛凸起 ≥ 0.5;圓形堆疊共用一個半徑與一條接縫線。
  • 扁平物體(紙張、標籤、螢幕)是面,不是實體。
  • 圓形實體是水平圓之間的切片,從底部向上繪製。
  • 非凸面的外輪廓需要繪製其遠端邊緣。
  • 從外殼滑出的零件應在外殼處被切斷,而非懸浮。
  • 一個品牌標記(色板 main);其他所有東西都是紙色(surface)。

第 4 階段 · 選擇與編寫節拍

根據訊息選擇動作(references/motion.md),然後在繪圖程式碼之前,在檔案頂端撰寫分鏡腳本註解:時間、移動什麼、移動多遠、原因。每個值都應是命名常數。節拍會在畫面捲入視野後等待 400 毫秒,持續 1.2–2.4 秒,並播放一次。當使用者的程式碼傳遞 active 時,它會改為在每次 active 變為 true 時播放(延遲 80 毫秒),不會自行播放。減少動畫模式會顯示靜止姿態。

第 5 階段 · 建構、渲染、檢查、檢視、修正

  1. 從 examples/ 中最接近的範例開始(下方表格)。保留其結構:分鏡腳本、TIMING、幾何、軌跡、姿勢、零件、LineState。

  2. 在預覽頁面上渲染它,然後執行檢查器:

    node <skill>/scripts/check.mjs http://localhost:3000/<preview-path>/<name> --duration <wait+beat ms>
    

    它會在淺色與深色模式下渲染,透過在虛擬時鐘上懸停於藝術作品上來播放節拍(因此預覽頁面必須將物件包裹在 <PlayOnHover> 中),在 0%、25%、50%、75%、100% 及之後儲存影格,並檢查:

    • 在淺色、深色與減少動畫模式下,無 Hydration 或主控台錯誤;
    • 當 active 時會播放,且藝術作品內部沒有按鈕;
    • 節拍精確地回到其靜止姿態;
    • 減少動畫模式下保持靜止,顯示靜止姿態,忽略 active;
    • 每個外框約 1 像素;無濾鏡、發光、陰影或漸層塗色;
    • 靜止繪圖符合其框架;
    • 繪圖與標題的水平中心對齊誤差在 2 像素以內;
    • 乾淨的線條:在深色模式、4 倍放大下,最多 6% 的外框是持續的雙線(兩條線相距 0.5–2 像素,沿著真實長度;線條交會處的小點不計)(lines.png,雙線以紅色顯示在 lines-marked.png 中);
    • 其光學尺寸符合設定(√(w×h) 140–175 像素)。
  3. 檢視 sheet.png 與 lines.png(兩者都打開),並逐一核對下方的檢查清單。檢查器無法看到設計問題,但您可以。

  4. 修正並再次執行。 最多三輪。如果三輪後仍有不足,請停止並明確告知使用者問題所在,並附上 sheet。

  5. 回報:概念、分鏡腳本、檢查器結果、檢視後修正了什麼、仍有什麼不足,以及 sheet 的路徑。

檢視 sheet:檢查清單

可讀性

  • 沒有標題的情況下,陌生人能在縮圖尺寸下說出物體名稱嗎?
  • 沒有意外被看成臉孔的零件(兩個圓形零件在一個曲線上)。
  • 品牌標記是一個小零件,並且是視線應停留的零件。

靜止端正

  • 靜止時,所有直立零件垂直,所有邊緣水平;沒有任何東西傾斜或歪斜,第二張紙片是偏移而非旋轉。
  • 靜止姿態等於減少動畫模式的姿態(檢查器會比較像素;您需檢查它看起來是有意為之)。

線條(檢視 lines.png:深色、4 倍放大)

  • 所有外框粗細一致;無重疊的邊緣、無填充之間的細微接縫、無缺少的曲線外框遠端邊緣、無填充突出於外框之外、無線條懸在空中。
  • 每個零件要麼齊平,要麼明顯凸起(≥ 0.5);無細條。

真實感

  • 正確的視角:扁平物體正面朝向,方正物體等角投影。
  • 三個層級:外形、可辨識的零件、低調的標記。擁有該物體的人會說「對,這是一台印表機」嗎?
  • 頂部條帶(從上方 30° 看到的厚度)存在於實體上,不存在於薄面上。

動畫

  • 節拍傳達了訊息;每個動作都是由前一個動作引起的(延遲、跟隨、穩定)。
  • 鉸接零件絕不會擺動到外殼內部;尖端絕不會越過靜止位置;擺動幅度小(懸掛零件 ≤ 6°,蓋板 ≤ 25°)。
  • 沒有任何東西淡入或淡出;出現的東西透過縮放生成。

符合頁面

  • 以文案為中心;框架沒有被空白空間填充。
  • 在深色模式下看起來正確:紙色面變成深色紙色,品牌標記保持品牌色。

絕不再犯:此技能曾經犯過的錯誤

以下每個錯誤都曾交付過一次,在審查中被發現,現在已成為規則。在回報物件之前,請根據每一條規則檢查它。

錯誤現在的規則
正面朝向的方盒看起來像扁平貼紙首先選擇視角:扁平物體正面,方正物體 view="isometric"(line-style.md)
薄的頂部條帶、幾乎不凸起的零件與階梯狀圓環繪出了重疊且骯髒的線條無細條;齊平或凸起 ≥ 0.5;圓形堆疊使用單一半徑;檢查器的乾淨線條測試必須通過,並且您需檢視 lines.png(深色、4 倍放大)
物體只有外框(「不真實」)三個細節層級:外形、可辨識的零件、低調的標記
同一組物件之間尺寸跳動透過 defaultArtClassName 設定光學尺寸 140–175 像素
頁面飛出框架 3 個單位動畫保持在藝術作品的空間內;最多稍微超出框架邊緣
兩個卡榫、一個全寬條紋作為「一個品牌標記」一個小標記,真的只有一個
一個槽在一個點上、兩個卡榫在一條接縫上,看起來像臉孔在縮圖尺寸下檢查意外的臉孔
朝向觀眾的角落翻轉在正面視角中看不見朝向觀眾的旋轉僅需很小的角度即可被察覺;偏好畫面平面內的移動,或使用大角度(motion.md)
一個頁面在其平面內傾斜,在等角視角中產生了剪切在等角視角中,僅能圍繞零件自身的法線或其邊緣上的鉸鏈旋轉零件(motion.md)
一個零件在第一次播放時閃現其起始姿勢一幀由時鐘 state 驅動的零件在剪輯變更時重置,並在保持時從靜止開始(engine-api.md)
薄的托盤壁看起來像薄塑膠堅固的牆壁需有厚度(≥ 0.5);薄面僅用於紙張
每個物件單獨看都很好,但整組不協調在回報前,以淺色與深色模式並排檢視整個批次
鈴鐺的身體、U 形環、指針沿著它們的曲線繪製了雙重外框正面視角中,曲線零件是扁平的面(或明確有深度的面);指針應有平行邊,絕不漸縮
玻璃外框上的沙子圖案形成了一條粗的污跡內容物位於內嵌牆內,絕不在容器外框上
一個門凸起 0.25 於其盒子,導致拱形線條重疊形狀與開口相同的門在靜止時共用一個外框
一個保險箱門在等角視角中呈 32°,看起來像邊緣等角視角中的門和蓋子應打開約 24–26°,以便其面仍可被辨識
鑰匙環放在鑰匙上方,而不是穿過它們的孔(「環不在鑰匙圈內」)穿線的零件應交錯:環在其孔的一側從每個零件後方穿過,並在另一側從前方穿過(line-style.md)
縮小物體到其尺寸後,雙重線條又出現了先設定預設寬度,然後確保條帶 ≥ 0.5 用於繪製較小的物體
一個「!!!」徽章未能通過線條檢查將標記繪製為具有清晰間隙的形狀;避免在文字中使用間隙字形

不可協商的規則

  1. 僅限真正的等角投影。 軸線與水平線成 30°,彼此 120°,等比例。絕不使用 2:1 的「遊戲」投影(26.565°)。
  2. 幾何優先。 以世界單位放置基元。絕不手寫投影後的畫面路徑。
  3. 單一網格。 位置與尺寸以 0.5 世界單位為單位;面細節以 0.25 為單位。
  4. 單一外觀。 variant="ink"(預設)或 "line";絕不在單一物件中混合外觀。1 像素外框、紙色牆面、無陰影、無發光、無漸層。
  5. 來自代碼記號的主題。 顏色僅來自使用者的 shadcn 主題,透過 --iso-* 變數。物件檔案中無十六進位色碼,無 oklch。品牌標記遵循 tone(預設 primary)。
  6. Props,而非分支。 文案、色調、變體、線條粗細、動畫開關是具有文件註解的 props (LineStateProps)。絕不將內容 prop 命名為 title:它是可存取的名稱。
  7. 可存取且可嵌入。 除非提供 title,否則藝術作品是裝飾性的。

相關技能