Communitygithub.com

設計工藝

引導代理如何進行「設計工藝」的藝術指導與建構,最終產出落地頁、首頁或作品集。流程涵蓋設計工藝、需求層次、以及框架(編寫任何程式碼之前)。適用於需要此工藝的新任務。

設計工藝 是什麼?

此技能為 AI 代理提供一套結構化的工作方法,用於前端設計與建構,特別適用於建立落地頁、首頁或作品集等「設計工藝」要求高的專案。它強調在撰寫任何程式碼之前先進行「框架設定」,透過工作故事(Job Story)明確情境與動機,並根據任務類型(品牌網站、行銷頁面、應用程式等)選擇適當的投入重點。 此方法遵循「功能 → 可靠 → 可用 → 愉悅」的需求層次,確保不為有缺陷的體驗添加華麗裝飾,同時也避免因延遲「個性化」而最終未能交付。技能涵蓋從尋找主題的關鍵互動特性、低成本探索與驗證最難部分、建立基於 token 的設計系統、處理所有 UI 狀態(包括錯誤與邊緣案例)、情感化文案與誠實標籤,到有目的性的動畫設計與實機驗證等八個步驟。 此技能支援 Claude Code、Cursor、Codex 等 AI 代理平台,透過其 `SKILL.md` 文件與 `references/` 目錄中的深度參考資料來引導代理。最終產出需通過真實瀏覽器測試,並提供完整的設計 rationale(包含問題、方法、替代方案及限制),確保交付品質符合專業設計標準。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Iitian001/design-craft/tree/HEAD/skills/design-craft

在你喜歡的 AI 中提問

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

說明文件

設計工藝 是做什麼的?

前端設計與建構的工作方法。SKILL.md 包含每項任務所需內容;references/ 文件則提供深度、數字與程式碼。當結尾表格中的觸發條件適用時,請閱讀對應文件。

範圍: 新頁面、流程或元件需執行步驟 1-8。小幅度變更(一個狀態、一個動畫、一個字串)僅需執行受影響的步驟,然後對變更部分執行步驟 8。

需求層次

功能 → 可靠 → 可用 → 愉悅。切勿為有缺陷、緩慢或令人困惑的事物增添愉悅感,也絕不能在缺少頂層愉悅感的情況下出貨:被推遲到「之後」的個性化設計很少能真正實現。

1. 框架設定(編寫任何程式碼之前)

  • 工作故事: 當 [情境] 時,我想要 [動機],以便 [成果]。 若情境或成果不明確 → 詢問,或在你的摘要中將該假設陳述為一個假說。
  • 挑選簡報要求的重點,並將心力投入於此:
簡報類型投入重點首要驗證方式
品牌網站、「高級」、「獎項級別」、「充滿動畫」一個基於主題的關鍵互動(步驟 2)該互動在真實內容上運作:開始、中間、中斷、釋放
發布、編輯、行銷頁面優惠訊息清晰明瞭,且最佳證據可供探索在手機上閱讀第一屏;主要操作無需等待即可觸及
應用程式、工具、儀表板最困難的決策、錯誤的成本、重複使用的速度一個包含變化數據的真實任務,以及一次故障後的恢復
元件或設計系統一個能經得起兩個不同消費者考驗的行為契約在兩個包含長內容的上下文中使用同一個元件
  • 區分事實與假設。指明訪客到達時的情緒狀態;這將決定整體基調。
  • 檢查現有資源:token、元件、模式、慣例。在創造之前先重用。

2. 在主題中尋找標誌性特徵

對於表現力要求高的工作,尋找一個主題的屬性,讓訪客即使遮住 Logo 也能辨識出來,以及一個讓訪客能操控它的動詞。啤酒會傾倒、起泡並展現其色澤;布料會垂墜;字體有其軸線;手錶有其機芯。圍繞這個屬性設計互動。

  • 替換測試: 換成一個不相關的品牌。如果效果依然不變且不受影響,那就還不是關於該主題的設計。在添加修飾之前,先回到主題本身。
  • 四個節拍: 什麼引發輸入 → 接觸時如何回應 → 持續輸入下揭示什麼 → 釋放後留下什麼。應由一個持續存在的物件承載所有四個節拍。
  • 更多效果永遠無法解決「感覺很基本」的問題。改改變核心想法或機制。
  • 每個手勢都有一個單純的對等替代方案(滑桿、按鈕、選項群組)能達到相同的資訊。

3. 低成本探索,先驗證最困難的部分

  • 用短短幾行描述至少三種結構上不同的方法。選擇一個,說明原因。
  • 在動畫之前,先用真實內容組成一個靜態畫面:閱讀順序、字體、圖像、主要操作。任何動畫中途的畫面也應看起來經過設計。
  • 先建構風險最高的主張(手勢、滾動場景、困難的工作流程),並在真實瀏覽器中驗證,然後再圍繞它建構頁面的其餘部分。

4. 系統優先

  • 先有 Token,再有元件。元件使用語意化 token(--color-action)來別名原始 token(--amber-400)。元件樣式中不得出現十六進位色碼、px 或魔術數字。
  • 間距採用基數為 4 的刻度(4, 8, 12, 16, 24, 32, 48, 64)。內文尺寸 16px/1rem,行高 1.5;標題行高 1.1-1.25。使用一個模組化字體比例。最多兩種字體(+ 等寬字體)。變化中的數字使用表格數字。
  • 1-3 種品牌色、中性色、狀態色。每個文字組合需通過 WCAG AA 標準(內文 4.5:1,大型文字/UI 元素 3:1)。顏色絕不能是唯一的信號。
  • 動畫 token(持續時間、緩動函數)與顏色和間距並列。
  • Props 命名應表達意義(variant="destructive"),而非外觀。重複的覆寫表示缺少一個變體。

5. 所有狀態,而不只是快樂路徑

互動元件:預設、懸停、focus-visible、啟用、停用、載入、錯誤、選取。 畫面:空白、載入、部分、錯誤、成功、離線。 非同步工作:

  • 最新請求優先;較慢的舊回應不得覆寫較新的回應。
  • 任何失敗後保留使用者的輸入,並在載入時保持之前的結果可見(半透明)。
  • 空帳戶、無結果和擷取失敗是不同的狀態,各自具有不同的下一步操作。

鍵盤可操作、語意化 HTML 優先,僅在 HTML 無法表達時使用 ARIA,每個欄位都有標籤,每個彈出視窗都有明顯的關閉方式,並在關閉時將焦點返回到合理的元素上。

6. 情感、文案與誠實

  • 清晰勝過巧妙。 如果一個笑話需要額外一句話來解釋,就刪掉它。使用縮寫、平實的詞語。
  • 語調保持一致,語氣則有所變化:成功時溫暖,錯誤時平實冷靜,處理敏感輸入時溫和。
  • 錯誤訊息: 發生了什麼、為什麼、下一步該做什麼、以及保留了什麼。絕不責怪使用者。這裡不適合幽默。
  • 空白狀態 應引導使用者:這裡將出現什麼,以及一個清晰的首要操作。
  • 峰終定律: 將一個大的愉悅點放在真正成就的結尾,絕不要放在挫折低谷中。
  • 在高風險頁面上,點出訪客的恐懼,並在行動呼籲之前逐一解答。
  • 圖像:預設應具有多元性;詢問「我們排除了誰?」
  • 誠實: 在人們可能誤認為真實的地方,標註 AI 生成的圖像和示範數據。文案必須與圖像顯示的內容一致(印有 5.0% 的罐頭,頁面就應顯示 5.0%)。
  • 受監管類別(酒類、金融、健康、兒童):添加必要的進入限制或揭露事項,並根據該類別的廣告規範檢查圖像,例如酒類廣告不得使用情色圖像。

7. 動畫

每個動畫都有一個任務:脈絡、注意力、回饋 或 個性。沒有任務,就沒有動畫。

Token值用途
--dur-1100ms按下、焦點、切換(≈ 感知最低限度)
--dur-2200ms大多數 UI 轉場、懸停、小型進入
--dur-3300ms面板、抽屜、彈窗
--dur-4400-500ms僅限全螢幕或主視覺畫面編排
--ease-outcubic-bezier(0,0,.2,1)進入 / 獲得注意力
--ease-incubic-bezier(.4,0,1,1)離開 / 失去注意力(退出時間縮短約 20-30%)
--ease-in-outcubic-bezier(.4,0,.2,1)在螢幕上位置之間移動
彈簧效果臨界阻尼、可重新定位手勢;當目標改變時保留速度
  • 絕不能讓編排動畫阻塞主要操作。 預載畫面或片頭不得將主要操作延遲超過大約一秒,且回訪訪客應跳過此環節。
  • 空間一致性: 事物以進場的方式離場;共享元素在原位置變形。
  • 錯開時間 30-60ms,並使用遞減延遲(base*√i);保持整個序列在約 300ms 以下。
  • 滾動場景: 進度映射來自章節的實際滾動距離,因此相同的滾動位置始終產生相同的畫面,向上滾動能乾淨地反向,且直接連結到中間位置也能正常運作。
  • 手勢: 只有一個進度擁有者;抓取點應始終附著在指針上;釋放時將速度傳遞給彈簧;中途中斷應使 UI 保持可操作。
  • 僅對 transform 和 opacity 進行動畫。在 prefers-reduced-motion 設定下,移除移動、視差、縮放和自動播放,保留簡短的淡入淡出,但仍允許使用者驅動的手勢運作。
  • 曾破壞真實專案的工程陷阱(一個屬性一個擁有者;暫停的滾動時間軸;時間軸內的貼齊標籤;非負幀時間;預載可交換資產):請參考 references/motion-engineering.md。

8. 在真實瀏覽器中驗證,然後交付

在桌面、手機和減少動畫模式下執行 scripts/walk.py(Playwright + 本地 Chrome):真實的指針拖曳、滾動瀏覽每個章節、檢查主控台錯誤、檢查橫向溢出。隱藏或最小化的預覽面板會限制動畫幀率,因此不要據此判斷動畫效果。詳細資訊請參考 references/verification.md。

然後根據工作故事進行評判,而非個人品味:

  1. 是否滿足工作故事?主要操作是否最為突出,且處處可達?
  2. 所有狀態是否存在(步驟 5)?鍵盤操作、螢幕閱讀器標籤、對比度?
  3. 是否僅使用 Token?是否重用了現有元件?
  4. 文案是否遵循步驟 6,包括誠實標籤?
  5. 每個動畫是否有其任務、正確的緩動方向、中斷路徑以及減少動畫的路徑?
  6. 標誌性特徵是否通過替換測試?是否有一個高峰,並放置在結尾?
  7. 我會刪除什麼?移除一個元素或效果,看看是否變得更好。

交付時附上設計 rationale:問題、方法、被拒絕的替代方案及其原因、被測試的內容及方式(模擬 vs 真實裝置)、以及已知的限制。範本請參考 references/process-and-teams.md 附錄 B。

參考資料

參考文件何時閱讀
references/motion-engineering.md建構任何 GSAP/ScrollTrigger/Lenis、Canvas、手勢或滾動場景工作時
references/verification.md在宣告任何視覺或互動工作完成之前
references/imagery.md生成或準備圖像、產品去背、藝術指導時
references/animation.md關於編排動畫、7 項動畫原則、錯開時間計算、動畫 token
references/emotion.md關於設計角色、入門引導、愉悅感、信任與恐懼、故障文案
references/design-systems.md關於 token、元件 API、治理、版本控制、文件
references/product-design.md關於研究、故事優先、草圖、回饋、原型、測試
references/design-thinking.md處理需要同理/定義/發想/原型/測試的模糊問題時
references/design-engineering.md選擇原型保真度、設計↔程式碼交接協作時
references/process-and-teams.md關於評審會議、設計 rationale 和交付範本、DesignOps

相關技能