Featured image of post Web Design Skill 実践マニュアル(詳細版)

Web Design Skill 実践マニュアル(詳細版)

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
claude --version

バージョン番号が表示されればインストール済み。

インストールされていない場合:

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
宇宙探索博物館のオンライン展覧ウェブページを作成してください。すべてのコードを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つの文:

  1. 設計システムが先、コードが後 — 方向が間違えばコードは無駄
  2. まず粗い V0、その後磨き上げる — 素早い反復、最低コスト
  3. 大胆な余白、すべての要素は存在を証明せよ — 抑制こそが高級感
comments powered by Disqus
Hugo で構築されています。
テーマ Stack は Jimmy によって設計されています。