webbuild は何をしますか?
事業主が料金を払いたくなるウェブサイトを作る:そのビジネスに特化し、スマホで高速、一つの記憶に残る瞬間を持ち、「AI が作りました」と叫ぶような要素は一切排除します。技術のほとんどは、コードを書く前の選択と、結果を正直に評価することにあります。
以下のパスは、このスキルのフォルダ(scripts/、references/、assets/)からの相対パスです。
0. プロジェクトのセットアップ(2分)
- 新規サイト →
assets/starter/をプロジェクトフォルダにコピー(プレーンなHTML + CSS + ESモジュール、バージョン固定のCDNインポート、ビルドステップ無し:どこにでもデプロイでき、編集も簡単)。ユーザーが明示的に希望するか、プロジェクトが既にそれらを使用している場合のみ、Next.js / Astro / R3F を使用します(references/3d-playbook.md§5)。 - 既存プロジェクト → フレームワーク、トークン、コンポーネントはそのまま維持。このスキルは方向性、モーション、QAを追加するものであって、書き換えではありません。
- プロジェクトのルートに
BUILD_NOTES.mdを作成します。これはコンテキストリセット間のメモリとして機能します:概要、決定事項、未解決の質問、うまくいった修正内容を記録します。
1. ブリーフ — 本当のビジネスを理解する
(ユーザー、ビジネスの現在のサイト、Googleビジネスプロフィール、Instagramから)以下の情報を収集します:会社名、提供内容、所在地、創業時期、最も重要なアクション(電話 / 予約 / 注文 / 見積もり / 来店)、実際の証拠(評価と件数、実績年数、ライセンス、掲載実績)、実際の写真、ロゴ/カラー、営業時間、住所、電話番号。references/design-system.md §2 の5行のブリーフを BUILD_NOTES.md に書き込みます。
事実を決して捏造しないでください。捏造されたレビュー、統計、価格、住所は、オーナーが読んだ瞬間に信頼を破壊します。代わりに以下のようにします:
- 不明な点は回避して記述し、デモが完成しているように見せます:架空の番地ではなく「プネ、コレガオンパーク」;架空の引用ではなく「Google評価4.7」;価格不明のサービス名、または確実に分かっている場合のみ「₹…から」。
- 事実が本当に必要な場合(電話番号、正確な住所、営業時間)は、可視の
{{プレースホルダ}}を使用します —slop_check.pyはこれが埋められるまで出荷をブロックします。 - 全ての不明点と仮定は、最終報告用の「クライアントに確認する」リストにまとめます。
クリエイターやチャンネルサイトの場合、事前に(またはデータを取得して)ダッシュボードの数値とプロフィール写真を入手します:YouTube Studio / Instagramインサイトのスクリーンショット、およびvidIQ等の接続済みツール。実際の数字から構築された「結果」セクションが、提案を成功させます。
ブリーフが薄く、ユーザーがそばにいる場合は、最大3つの質問をします(ビジネスと都市、主要アクション、気に入っているサイト)。ユーザーに「とにかく進めて」と言われた場合は、合理的な仮定を立て、それを書き留めて、先に進みます。
2. リファレンス(ユーザーがサイト名を挙げた、録画を送った、または「リビルド」を希望した場合)
references/reverse-engineer.md に従います:node scripts/teardown.mjs <url> でスタック、フォント、パレット、メディア、シェーダーの証拠を測定し、スクロールのスクリーンショットを撮ります;画面録画はフレームとして読み取り、拍ごとのモーション仕様に変換します。簡単なパスで効果を説明できない場合は、REAのエンジンを使ってさらに深く掘り下げます:scripts/rea-teardown.sh <url> はページをキャプチャし、バンドルをフィンガープリントし、すべてのスクリプトをエクスポートして、どのように実際に構築されているかを読めるようにします(ガイドは references/rea/)。OBSERVED → INFERENCE → DECISION を記録します。テクニックを学びますが、ブランド、コピー、アセット、コードを決してコピーしないでください。
3. 方向性 — 計画を立て、計画を攻める
references/design-system.md(スロップ防止ルール — 古典的なものと、「趣味の良いAI」の兆候(クリーム×テラコッタ、大文字のアイブロー、エディトリアルなヘアライン))を読みます。BUILD_NOTES.md に以下を書きます:
- ビジネスから取った4~6個の名前付きカラートークン、タイプペアリングと役割、角丸のルール
- 各セクションのASCIIワイヤーフレーム(リズムを変える — ヒーロー → 3つのカード → ロゴ → お客様の声、の繰り返しにしない)
- 特徴的な瞬間(正確に一つ)と、それがこのビジネスに適している理由
- 個性的にするための3つの原則
次に、計画をスロップ兆候リストと照らし合わせてレビューし、デフォルトと読める選択については、このビジネスにとって正当化するか、変更します。「ロゴを入れ替えたら別のビジネスにも当てはまるだろうか?」と自問することで、ここでの問題のほとんどを低コストで発見できます。
ユーザーが方向性を決めかねている場合は、構築する前に2~3の真に異なる方向性(各静止画または簡単なHTMLスケッチ)を示します — 21st-ui-explore がインストールされていれば役立ちます。
4. ヒーロー — ビジネスに最適なモードを選ぶ
references/3d-playbook.md §1 に判断基準表があります。簡略版:
- 静止画(優れた写真/タイポグラフィ)— 飲食店、食品、サロン、クリニック、サービス業。多くの場合、正しい選択です。
- 動画 — 雰囲気ループ。理想的には
assets/starter/grade.jsで処理して、AI/ストック映像に特注のグレーディング(粒子、ハレーション、リフト/ガンマ/ゲイン、ビネット)を施します。LOOKを選び、控えめに保ちます。 - フレーム — 「$10Kの3Dウェブサイト」:AIの開始/終了キーフレーム → 最初/最後のフレームの動画 →
scripts/frames.sh→ スクロールで操作するキャンバス。キーフレームのルール、プロンプト、ブレンドについてはreferences/scroll-video-playbook.mdを読んでください。 - シーン — 3Dが製品のストーリーである場合(設定可能な製品、建築、テクノロジー)のライブThree.js / R3F。被写体はビジネスの核となるものでなければならず、プレースホルダーの結び目であってはなりません。
- ページ全体 — オーナーが「3Dウェブサイト」を希望する場合、通常は3Dヒーローではなく、サイト全体に3Dを意味します。セクションごとに固定カメラステーションを持つ1つの固定シーンを使用します(
references/3d-playbook.md§6)。
接続されているもの(Higgsfield / Kling / kie.ai / Nano Banana MCPsやスキル)でアセットを生成するか、ユーザーにファイルをドロップするよう依頼します。何も利用できない場合は、明確にラベル付けされたプレースホルダーで構築し、生成するアセットをプロンプトと共に正確にリストします。
5. 構築
順序:トークン(styles.css :root)→ 実際のコピーを含むセマンティックなHTMLセクション → 390pxと1440pxでのレイアウト → ヒーローモード → モーションは最後。
- コピーのルール:
references/design-system.md§8(成果 + 場所 + 具体性、実際のCTA動詞、禁止ワード)。 - ビジネスサイトに必須:ページ上部と最後に明確なCTAを一つずつ、
tel:/ 予約 / フォーム、営業時間 + 住所 + マップリンク、実際の証拠、タイトル + 説明 + OG画像、LocalBusiness JSON-LD、ファビコン、アクションが電話の場合のモバイル用スティッキーな電話/予約バー。 - モーション:一つの特徴的な瞬間 + 控えめな150~300msのマイクロフィードバック;イーズアウト、バウンスは禁止;
transform/opacityのみ;動きの軽減設定では終了状態を表示。 - コンポーネント:複雑なエフェクトを手書きする前に、
references/resources.mdのレジストリ(21st.dev、React Bits、Aceternity、Motion Primitives…)を検索し、トークンに再スタイリングします。静的サイトでは、一つのエフェクトのためにReactを追加するのではなく、Reactコンポーネントをバニラで再構築します。 - フッター:
references/design-system.md§11 に従って構築します(ブランドブロック、プラットフォームロゴ付きリンク列、お問い合わせボタン、特大ワードマーク、最下行)。オーナーはフッターでサイト全体を判断します。小さなビルダークレジットはスターターに既に含まれています;クライアントは削除を依頼できます。 - ボタンとスクロール:
references/design-system.md§12 に従います(触感のある0.16秒のボタン、スターターのcursor.jsによるカーソルリング、ネイティブスクロールバー無し:スターターのblockbar.jsが置き換えます)。 - 完了と呼ぶ前に、
references/design-system.md§10 を読み直してください:すべてのルールをパスしてもオーナーがまだスロップと呼ぶものです。
6. 確認する — ここで良いサイトが作られる
ローカルでサーブし(npx serve . またはプロジェクトの開発サーバー)、次に:
node scripts/shoot.mjs http://localhost:3000 ./shots— スマホ / ノートPC / デスクトップのスクロールに沿ったスクリーンショット + コンソールエラー、オーバーフロー、LCP、重量。PNGを読んでください。(利用可能な場合はブラウザペインやPlaywright MCPも使用可。)また、--reduced-motionを付けて一度実行します。python3 scripts/slop_check.py .— 0 FAILで終了しなければなりません。WARNは質問として扱います。(npx impeccable detectもインストールされていれば良い二次チェックです。)- ブリーフに照らして正直に批評します:階層、タイポグラフィ、カラー、特徴的な瞬間、モバイル、コピーの具体性。明確な意図を持ってバッチで修正します(「下のセクションが一般的に見える — もっと高級感を、ごちゃごちゃさせずに」)。
- 完了と呼ぶ前に、装飾要素を一つ削除します。
3~6ラウンドを想定してください;誰も一発では成功しません。何が何を修正したかを BUILD_NOTES.md に記録します。
7. 出荷 + 提案
- デプロイ:Vercel / Netlify / Cloudflare Pages / GitHub Pages。フレームフォルダをコミットします(最も一般的な「本番環境でヒーローが消えた」バグ)。クライアントが購入するまで、スペックデモには
<meta name="robots" content="noindex">を追加します。 - 提案用の場合、
references/pitch-and-sell.mdを読んでください:ビフォー/アフター動画、アウトリーチスクリプト、価格アンカー、提案準備完了チェックリスト、引き継ぎ。
ユーザーへの最終報告
簡潔かつ具体的に:
- 構築したもの(方向性を一行で、特徴的な瞬間、ヒーローモード)と場所(パス、URL)
- 実行方法(
npx serve .または開発コマンド) - QA結果:slop_checkのFAIL/WARN数、shoot.mjsのビューポートごとのLCP/エラー、確認して修正した内容
- クライアントに確認するリスト:全ての
{{プレースホルダ}}と仮定 - まだ生成すべきアセット(すぐに使えるプロンプト付き)(ある場合)
リファレンスマップ
| 読むもの | いつ |
|---|---|
references/design-system.md | 常に、色/タイプ/レイアウト/コピーを選ぶ前に |
references/3d-playbook.md | ヒーローを選ぶとき;Three.js/R3F全般;パフォーマンス + a11yの予算 |
references/scroll-video-playbook.md | AI動画からのスクロール同期「3D」ヒーロー |
references/reverse-engineer.md | リファレンスサイト、録画、見込み客サイトのリビルド |
references/rea/README.md | REAのツールでteardown.mjsより深く掘り下げる |
references/resources.md | コンポーネントレジストリ、エフェクトツール、インスピレーション、補助スキル |
references/pitch-and-sell.md | 見込み客向けスペックサイト、価格設定、アウトリーチ、引き継ぎ |
| スクリプト | 機能 |
|---|---|
scripts/teardown.mjs <url> | リファレンスサイトの測定(スタック、フォント、パレット、メディア、シェーダー、スクリーンショット) |
scripts/rea-teardown.sh <url> | REAエンジンによる詳細解析:ページキャプチャ、バンドルフィンガープリント、エクスポートされたスクリプト |
scripts/frames.sh <video> <out> | 動画 → WebPフレームシーケンス(デスクトップ + モバイル)+ マニフェスト |
scripts/shoot.mjs <url> [out] | 3つの幅でスクロールに沿ったスクリーンショット + エラー/LCP/オーバーフロー |
scripts/slop_check.py <dir> | AIスロップ + 出荷準備状態リンター(出荷には0 FAIL) |
.mjs スクリプト用のPlaywright:npm i -D playwright && npx playwright install chromium。