Featured image of post Web Design Skill 實操手冊(詳細版)

Web Design Skill 實操手冊(詳細版)

Web Design Skill 實操手冊(詳細版)

適用工具: Claude Code / OpenCode 目標: 跟著本筆記,你將用 AI 生成一個高品質的太空探索博物館網頁 預計耗時: 40-90 分鐘


在開始之前:理解我們要做什麼

整體流程概覽

1
準備環境 → 安裝 Skill → 創建項目 → 裸跑體驗 → Skill 加持 → 對比

為什麼先「裸跑」再用 Skill?

這是一個對比實驗:

  • 如果你直接用 Skill,你不會感受到 Skill 的價值
  • 先讓 AI 自由發揮 → 你會看到典型的 AI 味網頁(紫粉藍漸變、大圓角卡片、Emoji 圖標……)
  • 然後用 Skill 再做一遍 → 你會親眼看到同一個主題、同一個模型做出截然不同的效果

你需要的工具清單

工具 是什麼 去哪裡獲取
終端 你和 AI 對話的地方 Windows: PowerShell / Terminal;macOS: Terminal
Claude Code 或 OpenCode AI 編碼 Agent 見下方安裝說明
Git 從 GitHub 下載 Skill 文件 winget install Git.Git(Win)/ brew install git(macOS)
瀏覽器 預覽網頁效果 Chrome / Edge / Firefox
錄屏軟件(可選) 錄製操作過程 OBS Studio(免費)/ 系統自帶錄屏

確認 Agent 已就緒

如果你用 Claude Code

是什麼: Anthropic 官方的終端 AI 編碼工具。

確認已安裝:

1
claude --version

如果顯示版本號(如 1.0.x),說明已安裝。

如果沒安裝:

1
2
# 需要先安裝 Node.js(https://nodejs.org),然後:
npm install -g @anthropic-ai/claude-code

如果你用 OpenCode

是什麼: SST 團隊開發的開源終端 AI 編碼工具。

確認已安裝:

1
opencode --version

如果沒安裝:

1
2
3
4
5
# 方法 1:通過 Go 安裝
go install github.com/sst/opencode@latest

# 方法 2:通過 Homebrew(macOS/Linux)
brew install sst/tap/opencode

創建項目目錄

創建工作文件夾

1
2
3
cd ~/Desktop
mkdir space-museum-demo
cd space-museum-demo

初始化 Git 倉庫

1
git init

創建初始文件

1
claude

輸入:

1
請在當前目錄創建一個 index.html 文件,只包含最基本的 HTML5 結構(DOCTYPE、head、body),不需要任何樣式和內容。HTML lang 設為 zh-CN,title 設為「太空探索博物館」。

啟動本地預覽服務器

1
npx serve .

打開瀏覽器訪問 http://localhost:3000。


下載 web-design-skill

克隆倉庫

1
2
cd ~/Desktop/space-museum-demo
git clone https://github.com/ConardLi/web-design-skill.git

裸跑體驗 — 見識 AI 的「原生審美」

🎯 目的: 讓 AI 用默認方式生成網頁,觀察它的「原生審美」。

啟動 Agent(不加載 Skill)

1
2
3
claude
# 或
opencode

輸入設計需求

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
請幫我做一個太空探索博物館的線上展覽網頁,所有代碼寫在一個 index.html 文件裡(HTML + CSS + JS 都內聯),要求如下:

1. 深色主題,有宇宙感和科幻氛圍
2. Hero 區域展示博物館名稱「星際探索博物館」和一句標語
3. 展品卡片區域,展示 4 個太空探索裡程碑事件(加加林、阿波羅 11 號、哈勃望遠鏡、韋伯望遠鏡)
4. 時間線區域,展示太空探索的關鍵年份
5. 有滾動動畫效果(元素隨滾動漸入)
6. 響應式布局,手機端也能看

請直接生成完整代碼,寫入 index.html 文件。

等待 AI 生成

整個過程大約需要 1-3 分鐘。

查看結果

刷新 http://localhost:3000。

觀察清單:

  • 配色:是否有紫粉藍的漸變?
  • 布局:Hero 區域是不是標準的「居中標題 + 副標題」?
  • AI 味特徵:有沒有用 Emoji 當圖標?有沒有大圓角卡片?

保存裸跑版本

1
請把當前的 index.html 複製一份,命名為 index-no-skill.html

安裝 Skill 到 Agent 中

🎯 目的: 把 web-design-skill 的規則注入到 Agent 的系統提示中。

Claude Code — 兩種安裝方式

方式 A:寫入 CLAUDE.md(推薦,永久生效)

1
請讀取 web-design-skill/skill.md 文件的全部內容,然後創建一個 CLAUDE.md 文件,把 skill.md 的內容寫進去。

方式 B:在對話中引用(臨時生效)

1
@web-design-skill/skill.md 請根據這個 Skill 文件的規則來幫我設計網頁。

OpenCode — 安裝方式

方式 A:寫入 AGENTS.md(推薦)

1
cp web-design-skill/skill.md AGENTS.md

驗證 Skill 是否生效

啟動 Agent,輸入:

1
在開始設計之前,請告訴我:按照你的設計系統,你會使用什麼配色方案?什麼字體?什麼間距規則?有哪些絕對不能做的事情?

如果 Skill 生效了,AI 的回答應該包含:

  • 提到 OKLCH 色彩空間
  • 列出具體的字體推薦
  • 提到「去除 AI 味」的具體規則

Skill 加持 — 打磨高級感

🎯 目的: 用同樣的需求,讓 Skill 引導 AI 做出完全不同的網頁。

啟動新的對話

重要:必須新開一個對話!

輸入設計需求

這次我們故意只給極簡需求:

1
幫我做一個太空探索博物館的線上展覽網頁,所有代碼寫在一個 index.html 文件裡。

階段 A:AI 提問

AI 先問你幾個關鍵問題。

階段 B:AI 說明設計系統

AI 在寫代碼之前,先用自然語言描述它的設計系統:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
設計系統:
━━━━━━━━━━━━
配色方案(基於 OKLCH):
- 背景:oklch(15% 0.02 260) — 極深的太空藍
- 主色:oklch(70% 0.15 250) — 冷藍色
- 輔色:oklch(60% 0.12 310) — 深紫色
- 文字:oklch(95% 0.01 260) — 近白色

字體:
- 標題:Orbitron(科技感強)
- 正文:Space Grotesk(可讀性好)

間距系統:基於 8px 網格

布局策略:雜誌式大圖排版,非傳統的卡片網格

階段 C:AI 輸出 V0(粗糙初版)

刷新瀏覽器查看效果,判斷方向是否正確。

階段 D:迭代打磨

每輪只提 1-2 個修改點。

階段 E:最終驗證

1
2
3
4
5
6
7
8
請你現在以一個全新設計評審專家的視角,全面檢查這個網頁:
1. 是否有任何「一看就是 AI 做的」的特徵?逐一列出。
2. 配色是否和諧?有沒有用 OKLCH?
3. 字體使用是否恰當?有沒有用到爛大街的字體?
4. 布局是否有創意?還是標準的 Hero + 卡片網格?
5. 動畫是否自然?有沒有過度使用發光效果?
6. 移動端適配是否正常?
列出所有需要改進的地方,然後逐一修復。

保存 Skill 版本

AI 完成後,保存最終版:

1
2
3
4
5
# 如果你還在 Agent 對話中,讓 AI 幫你複製:
# "請把當前的 index.html 複製一份,命名為 index-with-skill.html"

# 或者退出 Agent 後手動複製:
cp index.html index-with-skill.html

對比兩個版本

在瀏覽器中同時打開兩個文件:

1
2
http://localhost:3000/index-no-skill.html     ← 裸跑版本
http://localhost:3000/index.html               ← Skill 版本

錄製成視頻(可選)

建議錄製的鏡頭

1
2
3
4
5
鏡頭 1:【成品展示】(30 秒)
鏡頭 2:【對比展示】(1 分鐘)
鏡頭 3:【過程回放】(2-3 分鐘)
鏡頭 4:【設計細節講解】(1 分鐘)
鏡頭 5:【總結】(30 秒)

附錄 A:常用提示詞速查

讓 AI 先說設計系統

1
2
3
4
5
6
7
在寫任何代碼之前,請先用自然語言描述你的設計系統,包括:
1. 配色方案(使用 OKLCH)
2. 字體選擇(標題和正文分別用什麼)
3. 間距系統
4. 布局策略
5. 絕對不能做的事情
我確認後再開始寫代碼。

要求快速 V0

1
2
3
4
先給我一個最小可用版本(V0)。
可以有佔位符和未完成的部分。
我確認方向後再完善細節。
不要花太多時間在細節上。

觸發全面驗證

1
2
3
4
請以一個全新的設計評審專家視角,全面檢查當前網頁。
列出所有「一看就是 AI 做的」的特徵,
以及配色、字體、布局上的所有問題。
然後逐一修復。

最後總結

1
2
做網頁的核心流程:
理解需求 → 確認設計系統 → 快速 V0 → 迭代打磨 → 驗證

三句話記住 Skill 的精髓:

  1. 先說設計系統,再寫代碼 — 方向不對,代碼白寫
  2. 先出粗糙 V0,再精雕細琢 — 快速試錯,成本最低
  3. 大膽留白,每個元素要證明自己 — 克制即高級
comments powered by Disqus
使用 Hugo 建立
主題 Stack 由 Jimmy 設計