0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【実践】生成AIでHTML/CSS/jQueryを自動生成 要件定義から実装まで

0
Posted at

はじめに

前回の記事「【実践】生成AIでHTML/CSS/jQueryを自動生成する方法」に続き、今回は具体的な要件定義からページの作成までを実施します。

題材として「家電ショッピングサイト(KADEN SHOP)のフロントエンド制作」を取り上げ、要求定義書の整理からプロンプト作成、コード生成までの一連の流れを解説します。

なお、本記事で使用するソースコードは、以下のGitHubリポジトリからダウンロードできます
gadget-shop-starter(GitHubリポジトリ)

要求定義書の整理

本演習では、最初からHTMLやCSSを作成するのではなく、まずシステムに必要な内容を要求定義書として整理します。

その後、要求定義書に記載された目的、想定ユーザー、ユーザーの課題、必要な機能、画面、UI・UX方針などをもとに、フロントエンド制作に必要な情報を具体化します。

最終的に、具体化した内容を生成AIに指示するための「フロントエンド制作プロンプト」としてまとめ、HTML、CSS、JavaScriptを生成します。

制作の流れ

要求定義書の作成
  ↓
要求内容の整理
  ↓
画面遷移の検討
  ↓
各画面のレイアウト検討
  ↓
操作やアニメーションの検討
  ↓
技術要件の決定
  ↓
フロントエンド制作プロンプトの作成
  ↓
HTML・CSS・JavaScriptの生成
  ↓
ブラウザでの動作確認
  ↓
修正・改善

家電ショッピングサイト 要求定義書

1. 目的

項目 内容
システム名 KADEN SHOP

本システムは、利用者がスマートフォンやパソコンから家電製品を簡単に検索、比較、購入できるショッピングサイトを提供することを目的とします。

特に、忙しい会社員でも短時間で目的の商品を見つけ、レビューや配送予定日を確認しながら、安心して購入できることを目指します。

2. 想定ユーザー・ペルソナ

項目 内容
名前 佐藤 美咲(仮名)
年齢 28歳
職業 都内勤務の会社員
利用端末 スマートフォン:約80% / パソコン:約20%
利用タイミング 通勤中・昼休み・帰宅後
家族構成 一人暮らし
よく購入する商品 生活家電・小型家電・キッチン家電・美容家電
ITリテラシー 一般的なITスキル、ネットショッピングを日常的に利用

重視すること:

  • 商品を検索しやすいこと
  • レビューを確認できること
  • 配送速度が分かること
  • 商品価格を比較できること
  • スマートフォンで見やすいこと

3. ユーザーの課題

想定ユーザーは、家電製品を購入する際に次のような課題を抱えています。

  • 商品数が多く、目的の商品を探しづらい
  • 商品ごとの違いが分かりにくい
  • 購入前に利用者のレビューを確認したい
  • 配送予定日が分からず、購入を迷うことがある
  • スマートフォンでは情報量が多いと見づらい
  • 複数商品の価格や性能を比較したい

4. 機能要求

必須機能

  • 商品一覧表示
  • 商品詳細表示
  • 商品仕様表示
  • レビュー表示
  • 配送予定日表示
  • 商品検索
  • カテゴリ検索
  • 価格帯による絞り込み
  • 商品の並び替え
  • カートへの商品追加
  • カート内商品の確認
  • 注文内容の確認
  • 注文処理
  • スマートフォン、タブレット、パソコンへのレスポンシブ対応

オプション機能

  • お気に入り登録
  • 商品比較
  • クイックビュー
  • 閲覧履歴
  • レビュー投稿
  • SNS共有

5. 画面要求

次の画面を作成します。

  1. トップ画面
  2. 商品一覧画面
  3. 商品詳細画面
  4. カート画面
  5. 注文確認画面
  6. 注文完了画面

6. 優先度

最優先で実装する機能:

  • 商品一覧・商品詳細・商品検索・カテゴリ検索
  • 価格帯絞り込み・並び替え
  • カート・注文
  • レビュー表示・配送予定日表示
  • スマートフォン対応

余裕がある場合に実装する機能:

  • お気に入り・商品比較・クイックビュー
  • 閲覧履歴・レビュー投稿・SNS共有

7. UI・UX設計方針

  • モバイルファーストで設計する
  • 検索バーを画面上部の見つけやすい位置に大きく配置する
  • レビューや評価を目立たせる
  • 配送予定日を購入ボタンの近くに表示する
  • 複数商品の価格や性能を比較しやすくする
  • 商品検索から購入までの操作回数をできるだけ減らす
  • ボタンやリンクはスマートフォンでも押しやすい大きさにする
  • 商品名、価格、評価、配送情報を整理して表示する

8. 非機能要件

  • Chrome、Edge、Safariなどの主要ブラウザに対応する
  • ページを快適な速度で表示できるようにする
  • 本番環境ではHTTPSによる暗号化通信を使用する
  • アクセシビリティを考慮した配色にする
  • 読みやすい文字サイズを使用する
  • キーボードでも操作できるようにする
  • スマートフォンで横スクロールが発生しないようにする
  • 画面サイズが変わってもレイアウトが大きく崩れないようにする

9. 要求定義で重視する考え方

本システムでは、次の点を特に重視します。

  • スマートフォンで見やすく、操作しやすいこと
  • 利用者が短時間で目的の商品を検索できること
  • 複数の商品を簡単に比較できること
  • レビューや配送予定日を確認して安心して購入できること
  • 少ない操作で商品購入まで進めること

要求定義後に検討する内容

要求定義書では、「何を実現するか」を整理します。一方、HTML、CSS、JavaScriptを生成するためには、「どのように実現するか」について、さらに具体的に決める必要があります。

次の項目を順番に検討します。

1. 画面遷移

各画面をどのような順番で移動するかを整理します。

トップ画面
  ↓
商品一覧画面
  ↓
商品詳細画面
  ↓
カート画面
  ↓
注文確認画面
  ↓
注文完了画面
  • トップ画面からは、検索、カテゴリ、おすすめ商品などを通じて商品一覧画面または商品詳細画面へ移動できるようにします。
  • 商品詳細画面で商品をカートに追加し、カート画面から注文確認画面へ進みます。
  • 注文を確定すると、注文完了画面を表示します。

2. 各画面のレイアウト

画面ごとに、表示する情報と配置を決めます。

トップ画面

  • ヘッダー(ロゴ、商品検索バー、カテゴリメニュー)
  • セールやキャンペーンを表示するメインビジュアル
  • カテゴリ一覧
  • おすすめ商品
  • フッター

商品一覧画面

  • ページタイトル
  • 検索結果件数
  • カテゴリ選択
  • 価格帯絞り込み
  • 並び替え
  • 商品カード一覧

商品詳細画面

  • 商品画像
  • 商品名・メーカー名・価格
  • 評価・レビュー件数
  • 在庫状況・配送予定日
  • 数量・カート追加ボタン
  • 商品説明・商品仕様
  • レビュー・関連商品

カート画面

  • カート内の商品(商品画像、商品名、単価、数量、小計、削除ボタン)
  • 商品合計・送料・合計金額
  • 注文確認画面へ進むボタン

注文確認画面

  • 配送先
  • 注文商品(数量、金額)
  • 支払い方法
  • 配送予定日
  • 注文確定ボタン

注文完了画面

  • 注文完了メッセージ
  • 注文番号・注文日時
  • 合計金額・配送予定日
  • トップ画面へ戻るボタン
  • 商品一覧へ戻るボタン

3. 操作時の動き

画面を表示するだけでなく、利用者の操作に応じた動きを決めます。

  • 商品カードにマウスを合わせると、カードが少し上に移動する
  • 商品画像が少し拡大する
  • ボタンにマウスを合わせると色が変化する
  • スクロールするとコンテンツが下からフェードインする
  • カートに商品を追加すると通知を表示する
  • 商品の数量を変更すると小計と合計金額が変わる
  • 削除ボタンを押すと確認メッセージを表示する
  • お気に入りボタンを押すとハートの表示を切り替える
  • クイックビューボタンを押すとモーダルを表示する
  • スマートフォンではカテゴリを横方向にスクロールできるようにする

4. 技術要件

フロントエンドは次の技術で作成します。

  • HTML5
  • CSS3
  • JavaScript
  • 外部フレームワークは使用しない
  • サーバーサイド処理は実装しない
  • データベースは使用しない
  • 商品データはHTMLまたはJavaScriptで用意する
  • 共通のCSSファイルを使用する
  • 共通のJavaScriptファイルを使用する
  • CSSのFlexboxとGrid Layoutを使用する
  • JavaScriptで検索、絞り込み、並び替え、カート計算などを行う

作成するファイル:

index.html
products.html
detail.html
cart.html
checkout.html
complete.html
style.css
script.js

5. レスポンシブ対応

モバイルファーストで設計します。

スマートフォン:

  • コンテンツを基本的に縦1列で表示する
  • 検索バーを横幅いっぱいに表示する
  • 商品カードを1列または2列で表示する
  • 商品詳細を縦並びにする
  • カートの商品をカード形式で表示する
  • ボタンを指で押しやすい大きさにする

タブレット:

  • 商品カードを2列または3列で表示する
  • 画面幅に応じて余白を調整する

パソコン:

  • 商品カードを3列または4列で表示する
  • 商品詳細を画像と商品情報の2列で表示する
  • コンテンツの最大横幅を設定する

フロントエンド制作プロンプトの作成

以上の要求定義と検討内容をもとに、生成AIへ入力するフロントエンド制作プロンプトを作成します。

プロンプトには、最低限次の内容を含めます。

  • 制作するシステムの目的
  • 想定ユーザー
  • 作成する画面
  • 必須機能
  • 各画面のレイアウト
  • 画面遷移
  • 操作時の動き
  • レスポンシブ対応
  • 使用技術
  • 作成するファイル
  • デザイン方針
  • アクセシビリティ
  • 出力方法

ポイント: 生成AIには、要求定義書をそのまま渡すだけではなく、画面ごとの具体的な構成や、クリックしたときの動作まで明確に指示します。これにより、要求定義の内容に沿った、一貫性のあるHTML、CSS、JavaScriptを生成しやすくなります。

KADEN SHOP フロントエンド制作プロンプト

以下が、生成AIに入力する完成版プロンプトです。

以下の要件定義および技術要件に基づき、家電ショッピングサイト「KADEN SHOP」のフロントエンドを作成してください。既存のHTML、CSS、JavaScriptがある場合は、その内容を確認したうえで、不整合を修正しながら完成版を作成してください。


プロンプト:1. システム概要

## 1. システム概要

### システム名
KADEN SHOP

### 目的
利用者がスマートフォンやパソコンから家電製品を簡単に検索、比較、確認、購入できる
ショッピングサイトを作成する。特に、忙しい会社員でも短時間で目的の商品を見つけ、
レビュー、価格、在庫状況、配送予定日を確認しながら、安心して購入できるサイトを目指す。

プロンプト:2. 想定ユーザー

## 2. 想定ユーザー

### ペルソナ
* 名前:佐藤 美咲
* 年齢:28歳
* 職業:都内勤務の会社員
* 家族構成:一人暮らし
* 利用端末:
  * スマートフォン:約80%
  * パソコン:約20%
* 利用タイミング:通勤中・昼休み・帰宅後
* よく購入する商品:生活家電・小型家電・キッチン家電・美容家電
* ITリテラシー:一般的、ネットショッピングを日常的に利用
* 重視する項目:商品の探しやすさ、レビュー、配送速度、価格比較、スマートフォンでの見やすさ

プロンプト:3. 使用技術

## 3. 使用技術

以下の技術だけを使用すること。

* HTML5
* CSS3
* JavaScript
* 外部ライブラリは使用しない
* JavaScriptフレームワークは使用しない
* サーバーサイド処理は実装しない
* 商品情報やカート情報はJavaScriptで管理する
* カート情報、お気に入り情報、閲覧履歴はlocalStorageに保存する
* 文字コードはUTF-8とする
* 表示言語は日本語とする

プロンプト:4. 作成ファイル

## 4. 作成ファイル

以下のファイルを作成すること。

kaden-shop/
├── index.html
├── products.html
├── detail.html
├── cart.html
├── checkout.html
├── complete.html
├── style.css
├── script.js
└── images/

HTMLから参照するファイル名は、必ず上記の名前に統一すること。
すべてのHTMLで次のように記述する。

<link rel="stylesheet" href="style.css">
<script src="script.js"></script>

ページ間リンクも次の名前に統一する。
index.html / products.html / detail.html / cart.html / checkout.html / complete.html

プロンプト:5. 画面遷移

## 5. 画面遷移

基本的な画面遷移を次のようにする。

トップ画面
├─ 商品一覧を見る
├─ カテゴリを選択
├─ おすすめ商品を選択
└─ キーワード検索
  ↓
商品一覧画面
├─ 商品検索
├─ カテゴリ絞り込み
├─ 価格帯絞り込み
├─ メーカー絞り込み
├─ 並び替え
├─ お気に入り登録
├─ クイックビュー
└─ 商品詳細を見る
  ↓
商品詳細画面
├─ 商品画像切り替え
├─ 数量選択
├─ お気に入り登録
├─ カートに追加
└─ 関連商品を選択
  ↓
カート画面
├─ 数量変更
├─ 商品削除
├─ 買い物を続ける
└─ 注文確認へ進む
  ↓
注文確認画面
├─ 配送先確認
├─ 支払い方法確認
├─ 注文内容確認
├─ カートへ戻る
└─ 注文を確定する
  ↓
注文完了画面
├─ 注文番号表示
├─ 配送予定日表示
├─ 商品一覧へ戻る
└─ トップページへ戻る

戻る操作を行っても、カート内の商品や数量が消えないようにすること。

プロンプト:6. 共通レイアウト

## 6. 共通レイアウト

すべての画面に、共通ヘッダーと共通フッターを配置する。

### 6.1 ヘッダー
ヘッダーには次の要素を配置する。
* KADEN SHOPロゴ
* 商品検索フォーム
* ホームへのリンク
* 商品一覧へのリンク
* お気に入りへのリンクまたはアイコン
* カートへのリンク
* カート商品数を示すバッジ
* ログインリンク

PC表示では、1行の横並びを基本とする。
ロゴ | 検索フォーム | 商品一覧 | お気に入り | カート(2)| ログイン

ヘッダーはスクロールしても画面上部に残るスティッキーヘッダーとする。
スクロール前は高さを広めにし、一定量スクロールした後は高さと余白を少し縮小する。

### 6.2 カテゴリナビゲーション
ヘッダーの下に、次のカテゴリを配置する。
* テレビ / 冷蔵庫 / 洗濯機 / 掃除機 / エアコン / キッチン家電 / 美容家電

PCでは横並びとし、スマートフォンでは横スクロールできるようにする。

### 6.3 フッター
フッターには次の内容を配置する。
* 会社概要 / 利用規約 / プライバシーポリシー / お問い合わせ / よくある質問
* コピーライト

プロンプト:7. トップ画面

## 7. トップ画面

### 7.1 ヒーローエリア
画面上部に大きなヒーローエリアを配置する。
表示内容:
* 「SUMMER SALE」などのキャンペーンラベル
* メインメッセージ(例:「あなたの暮らしを家電でもっと快適に。」)
* 補足説明
* 「商品一覧を見る」ボタン

ヒーローエリアには家電ショッピングサイトらしい清潔感のある背景を設定する。
背景画像を使用しない場合は、青系のグラデーションと装飾図形を使用する。

### 7.2 カテゴリ一覧
カテゴリをカード形式で表示する。
各カードには:カテゴリアイコン、カテゴリ名、短い説明
カードをクリックすると、対象カテゴリで絞り込まれた商品一覧画面へ移動する。
例:products.html?category=テレビ

### 7.3 おすすめ商品
おすすめ商品を4件以上表示する。
商品カードには次の情報を表示する。
* 商品画像 / メーカー名 / 商品名 / 販売価格 / 元価格 / 割引率
* 星評価 / レビュー件数 / 配送予定 / 在庫状況
* お気に入りボタン / 詳細を見るボタン / クイックビューボタン

商品カード全体をクリックした場合も、商品詳細画面へ移動できるようにする。
ただし、お気に入りボタンやクイックビューボタンを押した場合は、
商品詳細へ遷移しないようにイベント伝播を制御する。

### 7.4 最近チェックした商品
localStorageに保存した閲覧履歴から、最近閲覧した商品を最大4件表示する。
閲覧履歴がない場合は、このセクションを非表示にする。

プロンプト:8. 商品一覧画面

## 8. 商品一覧画面

### 8.1 画面上部
* パンくずリスト
* ページタイトル
* 検索結果件数
* 現在適用中の条件

### 8.2 絞り込みエリア
次の条件を指定できるようにする。
* カテゴリ / メーカー / 最低価格 / 最高価格 / 評価 / 在庫ありのみ / 翌日配送のみ

PCでは左側にサイドバーとして配置する。
スマートフォンでは「絞り込み」ボタンを表示し、押すとパネルを表示する。

### 8.3 並び替え
* おすすめ順 / 価格が安い順 / 価格が高い順
* 評価が高い順 / レビュー件数が多い順 / 配送が早い順

並び替えを変更したら、ページを再読み込みせずJavaScriptで商品カードの順番を変更する。

### 8.4 商品一覧
PCでは横4列、タブレットでは横2列、スマートフォンでは横1列を基本とする。
商品カードの高さをできるだけ統一し、Flexboxを使用する。

### 8.5 検索・絞り込み処理
検索対象:商品名、メーカー名、カテゴリ、商品説明
検索条件はURLパラメータまたはlocalStorageを利用して商品一覧画面に引き継ぐ。
検索結果が0件の場合は、メッセージと「条件をクリア」ボタンを表示する。

プロンプト:9. 商品詳細画面

## 9. 商品詳細画面

### 9.1 パンくずリスト
例:ホーム > 商品一覧 > テレビ > 4K液晶テレビ 50インチ

### 9.2 商品詳細レイアウト
PCでは左右2カラム。
左側:メイン商品画像、サムネイル画像、画像切り替え
右側:メーカー名、商品名、型番、星評価、レビュー件数、販売価格、税込表記、
   在庫状況、配送予定日、数量選択、カートに追加ボタン、お気に入りボタン、商品比較ボタン
スマートフォンでは縦1列にする。

### 9.3 商品画像切り替え
サムネイル画像をクリックすると、メイン画像を切り替える。
選択中のサムネイルには枠線を表示する。
画像切り替え時は、軽いフェードアニメーションを設定する。

### 9.4 カート追加
「カートに追加」ボタンを押したとき:
1. 商品ID、商品名、価格、数量、画像、配送情報を取得する
2. localStorageのカート情報に保存する
3. 同じ商品がすでに存在する場合は数量を加算する
4. ヘッダーのカート件数を更新する
5. トースト通知を表示する(alert()は使用しない)

### 9.5 配送予定日
購入ボタンの近くに目立つ形で表示する。
例:「在庫あり 本日12時までの注文で、最短7月29日にお届け」

### 9.6 商品説明・仕様・レビュー
商品情報の下に配置:商品説明、主な特徴、商品仕様、配送・設置について、レビュー、関連商品
スマートフォンでは、アコーディオン形式にしてもよい。

プロンプト:10〜12. クイックビュー・お気に入り・商品比較

## 10. クイックビュー
商品カードの「クイックビュー」ボタンを押すとモーダルを表示する。
モーダル内容:商品画像、メーカー名、商品名、価格、星評価、配送予定、
       商品説明の一部、詳細を見るボタン、カートに追加ボタン
モーダル表示時は背景に半透明のオーバーレイを表示する。
閉じる操作:閉じるボタン、背景オーバーレイのクリック、Escapeキー
モーダル表示中は、背景ページがスクロールしないようにする。

## 11. お気に入り
商品カードおよび商品詳細画面にハート型のお気に入りボタンを配置する。
未登録時:♡ / 登録時:♥
お気に入り状態はlocalStorageに保存し、ページ再読み込みでも維持する。
aria-label="お気に入りに追加" と aria-pressed を設定する。

## 12. 商品比較
最大3件まで比較対象へ追加可能。
比較対象が1件以上ある場合は、画面下部に固定の比較バーを表示する。
比較バー内容:選択中の商品名、商品削除ボタン、比較するボタン、すべて解除ボタン
3件超過時はトーストで通知。
比較モーダルで表形式表示:商品画像、商品名、メーカー、価格、評価、サイズ、
             消費電力、保証期間、配送予定日

プロンプト:13〜15. カート・注文確認・注文完了

## 13. カート画面

### 13.1 カート内商品
各商品:商品画像、メーカー名、商品名、単価、数量(1〜10)、小計、配送予定、削除ボタン
数量変更時はJavaScriptで即座に再計算する(小計、商品合計、送料、注文合計)。
計算にはdata-price属性またはJavaScriptの商品データを使用する。

### 13.2 商品削除
削除ボタンで確認ダイアログ表示。削除後にすべての表示を更新。

### 13.3 空のカート
表を表示せず、「カートに商品がありません。」メッセージと「商品一覧を見る」ボタンを表示。

### 13.4 注文ボタン
カートが空の場合は「注文確認へ進む」ボタンを無効化する。

## 14. 注文確認画面
配送先(氏名、郵便番号、住所、電話番号)
支払い方法(クレジットカード、下4桁のみ表示)
注文商品(画像、商品名、メーカー、単価、数量、小計)
注文金額(商品合計、送料、合計金額)
配送予定(商品ごと+注文全体)
注文内容はlocalStorageのカート情報から取得する。
「注文を確定する」ボタンは二重クリック防止のため一時的に無効化する。

## 15. 注文完了画面
注文確定時に注文情報をsessionStorageに保存する。
注文番号例:KS-20260728-0001
表示内容:チェックアイコン、完了メッセージ、注文番号、注文日時、
     支払い金額、配送予定日、配送先、トップページへ戻るボタン、商品一覧へ戻るボタン
注文完了後にカート情報を空にする。再読み込みでも注文情報は消えない。

プロンプト:16. アニメーション・操作時の動き

## 16. アニメーション・操作時の動き

### 16.1 ページ表示
ページ読み込み時にヘッダーを上から軽く表示する。0.3秒から0.6秒程度。

### 16.2 スクロールフェードイン
画面内に入ったときに下から軽くフェードインする。Intersection Observerを使用する。
対象:コンテンツセクション、商品カード、カテゴリカード、商品詳細、カート合計、注文完了メッセージ

初期状態のCSS:
.js-fade-target { opacity: 0; transform: translateY(30px); }
.js-fade-target.is-visible { opacity: 1; transform: translateY(0); }

JavaScriptが無効な場合でも内容が見えるように配慮する。

### 16.3 商品カード
hover時:カードを上方向へ6px移動、影を強く、商品画像を1.03〜1.05倍拡大、ボタン色変化
画像の親要素にoverflow: hiddenを設定する。

### 16.4 ボタン
状態:通常、hover、focus-visible、active、disabled
キーボード操作時にフォーカス位置が明確に分かるアウトラインを表示する。

### 16.5 トースト通知
表示タイミング:カート追加、お気に入り追加/解除、比較追加、比較上限、商品削除
一定時間後に自動で閉じる。同時に複数表示された場合は縦に並べる。

プロンプト:17. レスポンシブ対応

## 17. レスポンシブ対応

モバイルファーストで実装する。主なブレークポイント:

/* スマートフォン */ 基本スタイル:0px以上
/* タブレット */    @media (min-width: 768px)
/* PC */           @media (min-width: 1024px)
/* 大画面 */       @media (min-width: 1280px)

### スマートフォン
* ヘッダーをコンパクトにする
* 検索フォームは横幅100%
* 商品カードは1列または2列
* 商品詳細は縦1列
* ボタンは最小タップ領域44px程度
* カテゴリナビゲーションは横スクロール
* カート表はカード型表示へ切り替える

### タブレット
* 商品一覧を2列または3列
* 商品詳細は画面幅に応じて2カラム
* 絞り込み条件は折りたたみ可能にする

### PC
* 商品一覧は最大4列
* 商品詳細は左右2カラム
* 絞り込みは左サイドバー
* 最大コンテンツ幅は1200px〜1280px程度

プロンプト:18. デザイン方針

## 18. デザイン方針

### 色(CSSカスタムプロパティ)
:root {
  --color-primary: #2c5f8a;
  --color-primary-dark: #234b6b;
  --color-accent: #e8523f;
  --color-success: #2e7d32;
  --color-warning: #f59e0b;
  --color-background: #f8fafb;
  --color-surface: #ffffff;
  --color-text: #333333;
  --color-muted: #6b7280;
  --color-border: #dddddd;
}

### デザインイメージ
清潔感、信頼感、家電量販店らしさ、情報が整理されている、
価格と配送予定が見つけやすい、スマートフォンでも窮屈に見えない

### 文字
* Noto Sans JPを使用
* 本文はスマートフォンで16px以上
* 価格は大きく目立たせる
* レビューと配送予定も見つけやすくする

プロンプト:19. アクセシビリティ

## 19. アクセシビリティ

* すべての画像に適切なalt属性を設定
* フォーム要素にはlabelを関連付ける
* アイコンのみのボタンにはaria-labelを設定
* モーダルにはrole="dialog"とaria-modal="true"を設定
* キーボードだけでも操作できるようにする
* Tabキーで自然な順番に移動できるようにする
* Escapeキーでモーダルを閉じられるようにする
* 色だけで状態を伝えない
* 文字と背景のコントラストを確保する
* prefers-reduced-motionに対応し、アニメーションを減らせるようにする

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    scroll-behavior: auto !important;
    animation-duration: 0.01ms !important;
    transition-duration: 0.01ms !important;
  }
}

プロンプト:20. JavaScript設計

## 20. JavaScript設計

処理ごとに関数を分ける。最低限、次の関数を用意する。

initializeApp() / loadProducts() / renderProducts() / filterProducts()
sortProducts() / searchProducts() / getCart() / saveCart()
addToCart() / updateCartQuantity() / removeFromCart() / calculateCartTotals()
updateCartBadge() / getFavorites() / toggleFavorite() / renderRecentlyViewed()
openQuickView() / closeQuickView() / showToast() / createOrder()

グローバル変数を必要以上に増やさない。
DOM取得結果が存在するか確認してからイベントを登録し、
ページごとに対象要素が存在しなくてもエラーにならないようにする。

例:
const cartButton = document.querySelector(".cart-button");
if (cartButton) {
  cartButton.addEventListener("click", addToCart);
}

プロンプト:21. 商品データ

## 21. 商品データ

商品情報はJavaScriptの配列で一元管理する。最低12件用意する。

例:
const products = [
  {
    id: "tv001",
    name: "4K液晶テレビ 50インチ",
    brand: "Panasonic",
    category: "テレビ",
    price: 89800,
    originalPrice: 99800,
    rating: 4.8,
    reviewCount: 126,
    stock: 8,
    deliveryDays: 1,
    deliveryText: "最短翌日配送",
    image: "images/tv001.jpg",
    description: "高画質4Kパネルを搭載した50インチ液晶テレビです。",
    featured: true
  }
];

カテゴリ:テレビ、冷蔵庫、洗濯機、掃除機、エアコン、キッチン家電、美容家電

プロンプト:22. 既存ソース修正時の注意

## 22. 現在のソースを修正する場合の注意

HTML、CSS、JavaScriptの名称を統一する。特に次の点を確認する。

### 商品詳細
.product-detail / .detail-image / .main-image / .thumbnail-list / .thumbnail / .detail-info

### カート
削除ボタン:.remove-button
数量入力:.quantity
数量変更イベントはinputまたはchangeで処理する。

### フェードイン
対象要素にjs-fade-targetクラスを付ける。表示時にis-visibleクラスを付与する。

### 合計金額
商品単価はdata-price属性またはカートデータから取得する。

プロンプト:23. 動作確認項目

## 23. 動作確認項目

完成後は、次の操作を確認する。

1. トップ画面から商品一覧へ移動できる
2. カテゴリを選択すると商品が絞り込まれる
3. キーワード検索が商品一覧に反映される
4. 価格帯で絞り込める
5. 並び替えが正しく動作する
6. 商品詳細へ移動できる
7. サムネイルで商品画像を切り替えられる
8. 商品をカートに追加できる
9. 同じ商品を追加すると数量が増える
10. カート件数バッジが更新される
11. カート内で数量変更ができる
12. 数量変更時に小計と合計が更新される
13. 商品を削除できる
14. カート情報が再読み込み後も残る
15. 注文確認画面にカート内容が表示される
16. 注文確定後に注文完了画面へ移動できる
17. 注文完了後にカートが空になる
18. お気に入り状態が保存される
19. クイックビューモーダルが開閉できる
20. スマートフォン表示で横スクロールが発生しない
21. Chrome、Edge、Safariで大きな表示崩れがない
22. JavaScriptコンソールにエラーが出ない

プロンプト:24. 出力方法

## 24. 出力方法

以下の順番で、すべての完成コードを省略せずに出力する。

1. index.html
2. products.html
3. detail.html
4. cart.html
5. checkout.html
6. complete.html
7. style.css
8. script.js

各ファイルは別々のコードブロックにする。
既存コードの一部分だけを提示せず、コピーしてそのまま実行できる完全版を提示する。
HTML、CSS、JavaScript間で、クラス名、ID名、ファイル名、リンク先を完全に一致させる。

最後に、次の内容を説明する。
* ファイルの配置方法
* ブラウザでの起動方法
* 主な機能の確認方法
* localStorageを初期化する方法
* 商品画像を差し替える場所
* 商品情報を追加・変更する場所

まとめ

本記事では、生成AIを活用してHTML/CSS/JavaScriptを自動生成する際の要件定義からプロンプト作成までの全工程を解説しました。

ポイント

  1. いきなりコードを書かない — まず要求定義書を整理し、「何を実現するか」を明確にする
  2. 具体的に検討する — 画面遷移、レイアウト、操作時の動き、技術要件を順番に決める
  3. プロンプトは詳細に — 生成AIには画面ごとの構成やクリック時の動作まで明確に指示する
  4. 一貫性を保つ — ファイル名、クラス名、リンク先を統一ルールで管理する
  5. 動作確認を忘れない — 生成されたコードは必ずブラウザで確認し、修正・改善を行う

次のステップ

本記事でプロンプトエンジニアリングの基礎とフロントエンド生成の流れを学びました。次は、この「AIへの指示設計」スキルをバックエンド・業務システム開発に応用していきます。

Python・Dify・RAGを組み合わせた本格的な業務システム開発に挑戦したい方は、ぜひ以下の記事へ進んでください。

👉 Python × Dify × RAGで学ぶ業務システム開発入門【第1回 業務システム全体設計編】

参考

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?