Web Design Skill 実践マニュアル(詳細版)
対象ツール: Claude Code / OpenCode
目標: このガイドに従って、AI を使用して高品質な宇宙探索博物館のウェブページを生成します
所要時間: 40〜90 分
ゼロ:始める前に - やることを理解する
全体プロセス概要
1
|
環境構築 → Skill インストール → プロジェクト作成 → ベアラン体験 → Skill 活用 → 比較
|
なぜ先に「ベアラン」してから Skill を使うのか?
これは比較実験です:
- 直接 Skill を使うと、その価値を実感できません
- まず AI に自由にやらせる → 典型的な AI 風ウェブページが見える(紫ピンク青のグラデーション、角丸カード、絵文字アイコン…)
- そして 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
2
|
# まず Node.js をインストール(https://nodejs.org)、その後:
npm install -g @anthropic-ai/claude-code
|
OpenCode を使う場合
説明: SST チームが開発したオープンソースのターミナル AI コーディングツール。
インストール確認:
インストールされていない場合:
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
|
現在のディレクトリに index.html ファイルを作成してください。基本的な HTML5 構造のみ(DOCTYPE、head、body)、スタイルやコンテンツは不要です。HTML lang は zh-CN、title は「宇宙探索博物館」に設定してください。
|
ローカルプレビューサーバー起動
ブラウザで 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
|
宇宙探索博物館のオンライン展覧ウェブページを作成してください。すべてのコードを1つの index.html ファイルに(HTML + CSS + JS インライン)。要件:
1. ダークテーマ、宇宙感とSF的な雰囲気
2. ヒーローエリアに博物館名「星間探索博物館」とスローガンを表示
3. 展示カードエリアに4つの宇宙探索マイルストーン(ガガーリン、アポロ11号、ハッブル望遠鏡、ジェイズ・ウェッブ望遠鏡)
4. タイムラインエリアに宇宙探索の重要な年号
5. スクロールアニメーション効果(要素がスクロール時にフェードイン)
6. レスポンシブレイアウト、モバイル対応
完全なコードを生成し、index.html に書き込んでください。
|
AI 生成待ち
約1〜3分かかります。
結果確認
ブラウザで http://localhost:3000 を更新。
観察チェックリスト:
- カラー:紫ピンク青のグラデーションはあるか?
- レイアウト:標準的な「中央揃えタイトル + サブタイトル」か?
- AI 風の特徴:絵文字アイコン?大きな角丸カード?
ベアランバージョン保存
1
|
現在の index.html をコピーして、index-no-skill.html という名前を付けてください。
|
Agent に Skill をインストール
🎯 目的: web-design-skill のルールを Agent のシステムプロンプトに注入する。
Claude Code - 2つのインストール方法
方法 A:CLAUDE.md に書き込む(推奨、永続的)
1
|
web-design-skill/skill.md ファイルの内容を読み込み、CLAUDE.md ファイルを作成してください。
|
方法 B:会話で参照(一時的)
1
|
@web-design-skill/skill.md この Skill ファイルのルールに従ってウェブページを設計してください。
|
OpenCode - インストール
方法 A:AGENTS.md に書き込む(推奨)
1
|
cp web-design-skill/skill.md AGENTS.md
|
Skill が有効か確認
1
|
設計を始める前に、お聞きください:設計システムに従って、どのような配色方案を使いますか?フォントは?間隔のルールは?絶対にやってはいけないことは?
|
Skill が有効なら、AI は OKLCH 色空間、具体的なフォント推薦、「AI 風を除去する」ルールについて言及します。
Skill 活用 - 高級感を磨く
🎯 目的: 同じ要件で、Skill が AI を導いて全く異なるウェブページを作らせる。
新しい会話開始
重要:新しい会話を開始すること!
設計要件入力
今回は意図的に最小限の要件のみ:
1
|
宇宙探索博物館のオンライン展覧ウェブページを作成してください。すべてのコードを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回のフィードバックで1〜2点のみ。
フェーズ E:最終検証
1
2
3
4
5
6
7
|
新しいデザインレビューエキスパートとして、このウェブページを包括的にチェックしてください:
1. 「明らかに AI が作った」特徴はありますか?すべて列挙してください。
2. 配色は調和していますか?OKLCH を使っていますか?
3. フォントの使用は適切ですか?使い古されたフォントはありませんか?
4. レイアウトは創造的ですか?標準的なヒーロー + カードグリッドではありませんか?
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
|
2つのバージョンを比較
ブラウザで両方のファイルを開く:
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
|
コードを書く前に、設計システムを自然言語で説明してください:
1. 配色方案(OKLCH 使用)
2. フォント選択(見出しと本文それぞれ)
3. 間隔システム
4. レイアウト戦略
5. 絶対にやってはいけないことを確認してからコーディングを開始します。
|
素早い V0 を要求
1
2
3
4
|
まず最小限の実用版(V0)をください。
プレースホルダーと未完成の部分があって構いません。
方向を確認してから詳細を洗練してください。
詳細に時間をかけすぎないでください。
|
包括的検証をトリガー
1
2
|
新しいデザインレビューエキスパートとして、現在のウェブページを包括的にチェックしてください。
「明らかに AI が作った」特徴をすべて列挙し、配色、フォント、レイアウトのすべての問題を修正してください。
|
まとめ
1
2
|
ウェブデザインのコアワークフロー:
要件理解 → 設計システム確認 → 素早い V0 → 反復改善 → 検証
|
Skill のエッセンスを覚える3つの文:
- 設計システムが先、コードが後 — 方向が間違えばコードは無駄
- まず粗い V0、その後磨き上げる — 素早い反復、最低コスト
- 大胆な余白、すべての要素は存在を証明せよ — 抑制こそが高級感