ウェブサイト構築
差別化された、本番品質のウェブサイトを構築します。各サイトはすべて異なる見た目にします。タイプ、色、モーション、レイアウトのあらゆる選択は、主題から導き出さなければなりません。パレットジェネレーター(bun run shared/generate-palette.ts "キーワード")を実行して、プロジェクトごとにユニークな配色を生成します。同じパレットをサイト間で再利用してはいけません。
**このスキルはWebプロジェクトに関するすべてをカバーします。**プロジェクトの種類に応じて、このディレクトリ内のサブファイルを必要に応じて読んでください。Webアプリケーションの場合は、skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md も読んでください。
ユニバーサルデザイン原則(色の哲学、デフォルトパレット、フォント選択)は、design-foundations を介して他のスキルと共有されています。このスキルの共有ファイルは、それらの基礎をWeb固有の実装(CSS変数、レスポンシブトークン、ベーススタイルシート)で拡張します。design-foundations を個別に読み込む必要はありません。shared/ 内のWeb固有バージョンで網羅されています。
read はフルパスで使用します。例:skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md
プロジェクトタイプルーティング
ステップ1:プロジェクトタイプを特定し、ドメイン固有のガイダンスを読み込む:
| プロジェクトタイプ | アクション | 例 |
|---|---|---|
| 情報サイト | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/informational/informational.md | 個人サイト、ポートフォリオ、エディトリアル/ブログ、小規模ビジネス、ランディングページ |
| Webアプリケーション | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | SaaS製品、ダッシュボード、管理パネル、Eコマース、ブランド体験 |
| ブラウザゲーム | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.md | 2D Canvasゲーム、Three.js/WebGL、HTML5ゲーム、インタラクティブ3D体験 |
ステップ2:共有ファイルを読む — 最初に skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md と skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md を読んでください(すべてのプロジェクトタイプで必須、webappも含む)。これらにより、Kortixデザインシステムのデフォルトと、普遍的に適用されるタイポグラフィルールが確立されます。Webアプリケーションとダッシュボードの場合、以下の表で † が付いたファイルはスキップしてください。これらのファイルには、フルスタックテンプレートで事前構成された実装の詳細が含まれています。
ユーザーが詳細なしで単に「ウェブサイト」または「サイト」と言った場合は、タイプを尋ねるか、情報サイトをデフォルトにします。
サブファイルリファレンス
共有 (shared/) — すべてのプロジェクト
| ファイル | カバー範囲 | 読み込み |
|---|---|---|
shared/01-design-tokens.md | タイプスケール、スペーシング、Kortixパレット、base.css | 常に |
shared/02-typography.md | フォント選択、ペアリング、読み込み、ブラックリスト | 常に |
shared/04-layout.md | 空間構成、レスポンシブ、モバイルファースト | 常に † |
shared/05-taste.md | スケルトンローダー、空/エラー状態、洗練 | 常に |
shared/08-standards.md | アクセシビリティ、パフォーマンス、アンチパターン | 常に |
shared/09-technical.md | プロジェクト構造、サンドボックス、デプロイ、チェックリスト | 常に † |
shared/head-defaults.html | <head> 用アトリビューションブロック | 常に † |
shared/03-motion.md | スクロールアニメーション、Motionライブラリ、GSAP SVGプラグイン、ホバー/カーソル | アニメーションが必要な場合 |
shared/06-css-and-tailwind.md | Tailwind CSS v3、shadcn/ui、モダンCSS | Tailwindを使用する場合 |
shared/07-toolkit.md | CDNライブラリ、React、Three.js、アイコン、マップ、SVGパターン/フィルター、esm.sh | ライブラリを選択する場合 |
shared/10-charts-and-dataviz.md | Chart.js、Recharts、D3、KPI、スパークライン | データ可視化が必要な場合 |
shared/11-web-technologies.md | フレームワークバージョン、ブラウザ互換性 | 互換性を確認する場合 |
shared/12-playwright-interactive.md | 永続的なPlaywrightブラウザQA、スクリーンショット、ビジュアルテスト | テスト時 |
shared/19-backend.md | FastAPI/Express/Flaskサーバー、WebSocket、SSE、ポートフォワーディング | バックエンドが必要な場合 |
shared/20-llm-api.md | LLM/AI API統合リファレンス | サイトがAI APIを使用する場合 |
すべてのパスは skills/GENERAL-KNOWLEDGE-WORKER/website-building/ からの相対パスです。
† webappとダッシュボードではスキップ — 実装の詳細はフルスタックテンプレートで事前構成されています。デザイントークンとタイポグラフィはスキップしません。これらは、すべてのプロジェクトタイプに権威あるデザインシステムのデフォルトとフォント選択のガイダンスを提供します。
ドメイン固有 — 1つを読み込む
| ファイル | 読み込むタイミング |
|---|---|
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | SaaS、ダッシュボード、管理、Eコマース、ブランド体験(フルスタックテンプレートを持つ子スキル) |
webapp/dashboards.md | ダッシュボードまたはデータ密度の高いインターフェース(webappのコンパニオン) |
informational/informational.md | 個人サイト、ポートフォリオ、エディトリアル、小規模ビジネス、ランディング |
game/game.md | ブラウザゲーム、Three.js、WebGL、インタラクティブ3D |
game/2d-canvas.md | 2D Canvasゲーム(game.mdのコンパニオン) |
game/game-testing.md | 任意のブラウザゲーム — game.mdと一緒に読み込む |
インタラクティブQA: Playwrightを使用した永続的なブラウザ自動化(スクリーンショット、機能テスト、ビジュアルQA)については、skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md を読んでください。ゲームテストでは必須であり、複雑なサイトすべてに役立ちます。
ワークフロー
ステップ0:すべての必須ファイルを読み込む(これを最初に、並行して行う)
以下をすべて一度に読み込みます。これらはすべてのプロジェクトで必須です:
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/04-layout.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/05-taste.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md")
次に、以下のステップ1からドメイン固有のファイル(informational、webapp、またはgame)を読み込みます。
ステップ1:ユニークなパレットを生成する
主題を説明するキーワードを使用してパレットジェネレーターを実行します:
bun run skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/generate-palette.ts "主題のキーワード"
最適なハーモニーを選び、必要に応じてカスタマイズします。
ステップ2:デザインと構築
生成されたパレットを使用して、読み込まれたすべてのデザインガイダンスに従ってサイトを構築します。
ステップ3:プレビュー
静的サーバーを介して表示:show(type: "url", url: "http://localhost:3211/open?path=/workspace/project/index.html")
すべてのツールを使う
- 最初にリサーチ。 デザイン前に、参考サイト、トレンド、競合他社の例をWebで検索します。特定のサイトタイプの受賞歴のある例を閲覧します。ユーザーが提供したURLがあれば取得します。
- 実際のアセットを惜しみなく生成。 ヒーローイメージ、セクションイラスト、エディトリアルフィーチャービジュアル、雰囲気のある背景など、単なるヒーロー画像1枚ではありません。長いページには、サイトのアートディレクションに合致した生成画像による視覚的なリズムが必要です。プレースホルダーは使わないでください。すべてのプロジェクトにカスタムSVGロゴを生成します(下記参照) — SVGはロゴ専用であり、ユーザーが特にSVG出力を要求した場合を除きます。方向性を示すWeb参考画像を保存します。
- Playwrightでスクリーンショットを撮る。
skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.mdを読んで、デスクトップ(1280px以上)とモバイル(375px)でスクリーンショットを撮ります。参考画像と比較します。これは必須であり、オプションではありません。以下のビジュアルQAを参照してください。 - プロダクションコードを直接書く。 HTML、CSS、JS、SVG。ビルドツールとファイル処理にはbashを使用します。
SVGロゴ生成
すべてのプロジェクトはカスタムインラインSVGロゴを取得します。スタイル付きテキスト見出しで代用してはいけません。
- ブランドを理解する — 目的、トーン、1つの定義単語
- SVGを直接書く — 幾何学図形、レターフォーム、または抽象的なマーク。1つだけ記憶に残る形状。
- 原則: 幾何学的/ミニマル(Paul Rand、Vignelli)。24pxでも200pxでも機能。モノクロームを基本とし、色は強化として追加。ダーク/ライトモードには
currentColorを使用。 - インライン実装 —
aria-label、viewBox、fill="none"、currentColorストロークを使用 - ファビコンを生成 — 必要に応じて簡略化された32x32バージョン
SVGアニメーション(DrawSVG、MorphSVG)については、shared/03-motion.md を参照。SVGパターン/フィルターについては、shared/07-toolkit.md を参照。
ビジュアルQAテストプロセス
すべてのデプロイメントはビジュアルQAに合格しなければなりません。スクリーンショットは品質ゲートです。
すべてのビジュアルQAについては、skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md を読んでください。Playwrightは、スクリーンショット、インタラクションテスト、ビューポート検証のための永続的なブラウザセッションを提供します。
サイクル: 構築 → Playwright QA → 評価 → 修正 → 繰り返し → 準備ができたらデプロイ
ステージ1:ページごとのQA
各ページを構築した後:
- Playwrightを介して**デスクトップ(1280px以上)とモバイル(375px)**でスクリーンショットを撮る
- 批判的に評価: プロフェッショナルなデザインに見えるか(AI生成っぽくないか)?タイポグラフィは個性的か?ホワイトスペースはたっぷりあるか?明確な視覚的階層は1つあるか?
- 先に進む前にすべての問題を修正する。 ビジュアル負債を残さない。
ステージ2:最終QA(公開前)
- すべてのページをデスクトップとモバイルでスクリーンショット
- ページ間の一貫性を確認(スペーシング、カラー、タイプ処理)
- ダークモードを確認(少なくともホームページで両方のテーマをスクリーンショット)
- インタラクティブな状態を確認:ホバー、フォーカス、アクティブ、ローディング、空、エラー
- コールドオープンでの第一印象テスト:洗練され、意図的に作られたと感じられるか?
QA失敗条件: テキストオーバーフロー、不整合なスペーシング、トークン外の色、ダークモードの欠如、モバイルで潰れている、ジェネリックなAIルック、プレースホルダーコンテンツ、ロゴの欠如。
ステップ1:アートディレクション — 聞く前に推測し、デフォルトにする前に聞く
すべてのサイトは、そのコンテンツから導き出されたビジュアルアイデンティティを持つべきです。Kortixフォールバックパレットに飛びついてはいけません。 Kortixパレットは、推測と質問の両方が失敗した場合の最後の手段であり、便利なデフォルトではありません。
- 主題から推測する。 コーヒー焙煎所のサイト → アーシーな茶色、温かみのあるクリーム色、手描き風。フィンテックダッシュボード → クールなスレート、シャープなサンセリフ、データ密度大。子供向け学習アプリ → 明るい原色、丸みのあるフォント、遊び心のあるモーション。ユーザーが何も言わなくても、コンテンツ自体がパレット、タイポグラフィ、スペーシングを教えてくれます。
- アートディレクションテーブルを確認する。 各ドメインファイル(
informational.md、webapp/SKILL.md、game/game.md)には、サイト/製品タイプをコンセプト駆動の方向性とトークンの出発点にマッピングするアートディレクションテーブルがあります。これらを足がかりとして使用します。 - 5つの柱を導き出す: 色(暖色/寒色、アクセントは主題から)、タイポグラフィ(セリフ/サンセリフ、ディスプレイの個性)、スペーシング(密/余裕あり)、モーション(最小限/表現豊か)、イメージ(写真/イラスト/タイプのみ)。
- 主題が本当に曖昧な場合、質問する — 「どのような雰囲気を目指していますか?」「参考サイトはありますか?」1つの質問で十分です。
- Kortixフォールバック — 推測と質問の両方が何ももたらさなかった場合のみ。 ユーザーに質問したが方向性がなく、主題から明確なシグナルが得られない場合にのみ、Kortix/スイス風デフォルトにフォールバックします。
フォールバック:クリーン&スイス風(最後の手段)
推測で明確な方向性が得られず、ユーザーに質問したがスタイルガイダンスがなかった場合、skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md のデフォルトを以下とともに使用します:
- タイポグラフィ: SatoshiまたはGeneral Sansボディ(Fontshare推奨)、またはInter/DM Sans。フォントのコントラストよりもウェイトのコントラストを重視。最大3〜4サイズ。テキストはコンパクトに保つ —
--text-3xl/--text-heroは情報サイトのヒーロー専用。 - 色: Kortixパレット。ニュートラルなサーフェス + CTAのみに1つのティールアクセント。
- レイアウト: グリッド整列。余裕のあるマージン。興味深い箇所では非対称に。
- モーション: 最小限、機能的。スムーズな状態遷移のみ。
- イメージ: クリーンで関連性の高いビジュアルを生成。ストックフォトは使用しない。
アートディレクション — AI的な美観を避ける
完全なアンチパターンリストについては、skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md を参照してください。
ステップ2:公開
最初に実際のローカルプレビューコマンドを使用し、対象プロジェクトの実際のデプロイメントワークフローでのみ公開してください。推奨されるプレビューと配信のフローについては、skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/09-technical.md を参照してください。
納品
- 常に最初にサイトをローカルで確認してください。
- プレビューまたは開発サーバーには
pty_spawnを使用してください。 - 対象リポジトリに既にデプロイメントワークフローがある場合は、その正確なワークフローを使用してください。
- 確立されたデプロイ先がない場合は、プラットフォーム固有のデプロイストーリーを発明する代わりに、ファイルと確認済みのローカルプレビューを納品してください。