Communitygithub.com

網頁設計手冊

設計技能。用於網站/LP/HTML模型設計實作工作流程,適用於新建、重新設計或「幫我弄好看一點」等設計需求,使用參考圖層→方向決定→實作→實際驗證→回饋學習的強制流程。也適用於使用者分享「這個網站不錯/請參考」的網址時,累積參考網站。

網頁設計手冊 是什麼?

這是「Web Design Playbook」技能,專為AI代理(如Claude Code、Cursor、Codex)設計,以強制執行結構化的設計實作工作流程。核心在於一個累積檔案(`~/.claude/design-taste.md`),它會隨著每次使用而成長,將使用者明確的設計偏好與經過驗證的模式加以儲存。當使用者分享喜歡的網站時,代理會立即分析它並將見解加入累積檔案;當設計獲得回饋時,會記錄哪些有效、哪些無效。此工作流程強制執行五個步驟:1) 載入參考圖層(從`DESIGN.md`、累積檔案和預設原則),2) 決定方向(透過粗略模型取得共識,並將設計標記固定在`DESIGN.md`中),3) 實作(優先使用Web Bento等現成元件,並由CSS/Framer Motion開始處理動畫),4) 實際驗證(在390/880/1280px下進行螢幕截圖檢查,特別注意中文排版),以及5) 回饋學習(將學到的知識寫回累積檔案)。此方法確保品質可重現,避免AI常見的模板感,並優先考慮使用者的經過驗證偏好。

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

在你喜歡的 AI 中提問

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

說明文件

Web Design Playbook

用模式重現品質的設計實作工作流程 核心在於與下方的「累積檔案」反覆互動,吸收好的設計,並將實作中學到的成果寫回,讓技能越用越能成為該使用者專屬的模式

累積檔案 (此技能的核心)

存放各使用者設計偏好與參考網站的正本 位置在 ~/.claude/design-taste.md 如果不存在,初次使用時會以此範本建立:

# Design Taste — 自己的設計累積

## 已驗證的原則
<!-- 根據對設計的回饋,將「有效的模式 / 無效的模式」逐行新增 -->

## 參考網站集
<!-- 將覺得「不錯」的網站,連同優點描述一起新增 -->
| 網站 | URL | 優點 |
|---|---|---|

新增時機 (吸收)

  • 當使用者說「這個網站不錯」「請參考」「像這種感覺」並分享 URL 時,立即查看該網站,並用一句話描述其優點 (佈局/配色/字體/動畫/資訊架構),然後新增到參考網站集
  • 當從使用者對設計的回饋中,了解「有效的模式 / 無效的模式」時,在已驗證的原則中新增一行

讀取時機 (使用)

  • 在進行任何設計實作之前,必須先讀取 (工作流程步驟 1) 作為實作方向、配色、動畫的判斷依據

工作流程

1. 載入參考圖層 (實作前務必執行)

依優先順序讀取:

  1. 專案根目錄的 DESIGN.md — 專案專屬的正本 最優先
  2. 累積檔案 ~/.claude/design-taste.md — 使用者個人已驗證的偏好
  3. 下方的「設計原則 (初始值)」— 若前兩者沒有對應項目時的預設值

2. 決定方向

  • 如果風格尚未確定,先用一個畫面的粗略模型 (英雄區+代表性區塊) 提出方向並取得共識 等所有頁面都做完才改變方向,成本最高
  • 方向確定後,以 DESIGN.md 格式 (YAML 代號 + 意圖說明) 將其固定在專案中 之後無論是人類還是 AI 實作,只要讀取這個檔案,風格就不會偏移

3. 實作

  • 在自行打造裝飾元件 (按鈕/標題/卡片/載入動畫/背景圖案等) 之前,先確認 Web BENTO 是否有現成元件可用
    • 各元件頁面: https://amix-design.com/tl/web-bento/parts/<slug>.html slug = gradient / heading / button / card / text-effect / divider / hover / glass-shadow / badge / loading / form / background-pattern / speech-bubble / list / alert / table
    • 使用時請根據專案的顏色、圓角、字型進行修改 (可商用・無需標註來源 僅禁止以元件集的形式重新散佈,因此不可直接包含於專案中)
  • 動畫請從輕量實作開始考慮: CSS/Framer Motion → Rive/Lottie → Three.js 務必尊重 prefers-reduced-motion

4. 實際驗證 (部署前務必執行)

  • 在瀏覽器中以 390 / 880 / 1280px 等至少三種寬度進行螢幕截圖並目視檢查 (可使用 Chrome DevTools MCP 等工具) 編譯成功與外觀正確是兩回事
  • 中文檢查: 標題的換行錯亂 (助詞孤立於行首、單詞中間斷開) / 元件內容被裁切 / 需要 hover 才能看到的資訊
  • 中文換行處理: 按語意區塊將內容拆分為 nowrap 的區塊行 / 使用 word-break: auto-phrase / 將禁止斷開的詞組用 nowrap 的 span 包裹

5. 回饋學習

  • 當從使用者對設計的回饋中,了解「有效的模式 / 無效的模式」時,立即在累積檔案的「已驗證的原則」中新增
  • 反覆執行此步驟,判斷標準會從「一般論」轉變為「此使用者已驗證的偏好」 這正是此 playbook 的本體

設計原則 (初始值)

在累積檔案累積足夠驗證之前的預設值 僅為初始值,若不適用可以自行修改:

  • 白色基底 + 一個強調色 + 大型字體 + 主題的具體視覺元素 多色或深色搭配金色的「豪華」方向容易顯得 AI 模板
  • 對操作有反應的趣味性 + 具有活動感的動畫,但絕不能犧牲資訊的可讀性
  • 用主題的隱喻來營造氛圍 (例如: 足球比賽網站→報紙版面、放映會活動→校慶風格) 避免只用通用的漸層加玻璃卡片組合

自訂指南 (這裡可以依個人需求修改)

項目自訂方式
設計原則 (初始值)當自己的驗證累積足夠後,以累積檔案為準 此小節可以刪除或改寫成自己的模式
累積檔案的位置若要團隊共享,可放在儲存庫內 (例如 design/taste.md),並更新本文中的路徑
驗證寬度 390/880/1280px配合專案實際的斷點調整
中文檢查若為多語言網站,則替換為目標語言的排版檢查 (如連字符處理等)
設計靈感來源若有自己推崇的設計師或流派,可在步驟 1 中加入其參考資料

禁止事項

  • 不使用 AI 圖像生成創造虛構的 IP、角色或商品 (在處理真實 IP 時最容易出問題) 裝飾僅限抽象幾何/字體/品牌色/官方素材/實拍照片
  • 不將禁止再散佈的素材集或他人內容包含在儲存庫中 (透過連結引用)

建議搭配 (選用)

  • Taste Skill — 防止草率輸出的品質把關: npx skills add Leonxlnx/taste-skill -g -s design-taste-frontend (可加上 high-end-visual-design / redesign-existing-projects)
  • DESIGN.md 驗證: npx @google/design.md lint

相關技能