ランディングページレビュー
ランディングページを監査し、判定結果を landing/review.md に書き込みます。ページは landing-skills パイプラインからのものでも、他の場所からのものでも構いません。ソースを読み、4つの幅でレンダリングされたページを確認し、モーションや3Dがある場合はそれをテストし、すべてを1つのルーブリックに照らして判断します。
完成しているように見えるページでも、誰も確認していない方法で壊れていることがよくあります。訪問者を感謝しながらすべてのリードを破棄するフォーム、クライアントが決して提供していない仕様や約束、WebGLが利用できないときに真っ白になる3Dページ、別のルールによってすべての幅でセクションのパディングが打ち消されることなどです。4つの幅をキャプチャして2つだけを見るレビュアーは、1つの幅でのみ現れるものを見逃します。あなたの仕事は、すべてを確認し、確認したことのみを報告することです。
<skill-dir> は、この SKILL.md を含むディレクトリを意味します。スクリプトはその scripts/ フォルダにあります。スキルがプラグインからロードされた場合、このファイルのパスはロード時に提供されています。そうでない場合は、find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null で見つけてください。すべてのコマンドはレビュー対象のプロジェクトから、スクリプトはフルパスで指定して実行します。
入力
ページと、存在するすべてのコンテキストが必要です。
- ページ. プロジェクトディレクトリ、単一のHTMLファイル、またはデプロイされたURL。エントリポイントを見つけます:
index.html、src/pages/index.astro、src/App.jsx、app/page.tsx、またはスタックが使用するもの。スタックをメモします。これにより、ビジュアルパスでページをどのように提供するかが決まります。 landing/brief.md:製品、オーディエンス、コンバージョンアクション、クライアントが提供した事実と証拠、提供されたアセット、言語。これは、ページが主張できることの真実の情報源です。landing/copy.md:承認されたコピー。ページをこれと比較します。landing/direction.mdとlanding/tokens.css:その理由を含むビジュアルディレクション、およびトークン。デフォルトのように見える選択は、ディレクションがクライアント固有の理由を示している場合に許容されます。
ファイルが欠落している場合:
- ブリーフなし. 主張を判断する前に、ユーザーに4つのことを尋ねます:製品は何か、誰のためのものか、1つのコンバージョンアクションは何か、どの事実、数値、 testimonials、ロゴが本物か。尋ねられない場合は、ページ自体がビジネスについて述べている事実を採用し、すべての testimonial、顧客名、ロゴ、評価、メトリクスを未確認として扱います:それぞれをブロッカーとして報告し、修正として「これが本物でクライアントから提供されたものであることを確認するか、削除する」を付けます。出荷される未確認の証拠は、でっち上げられた証拠と同じリスクです。
- copy.md または direction.md なし. ルーブリックを使用して、コピーとビジュアルをそれ自体のメリットでレビューします。「承認されたコピーと異なる」と言えなくなるだけで、他には影響はありません。これらのファイルを要求しないでください。
landing/フォルダなし. プロジェクト内にlanding/とlanding/shots/を作成します。レポートとスクリーンショットはそこに置かれます。- ページがビルドまたは提供されない. ルーブリックの行B15の下にエラーとともに報告します。他の方法(デプロイされたURL、以前のビルド)でレンダリングされたページを取得できない場合、ビジュアルパスは実行できず、判定は
incomplete(不完全)になります(Verdictを参照)。
パスを開始する前に references/rubric.md を読んでください。これには、合格の状態と失敗時の重大度を含むすべてのチェックが含まれています。landing/review.md を書く前に references/report-format.md を読んでください。references/snippets.md には、パスが実行するスクリプトが含まれています。
プロセス
以下の順序でパスを実行し、その後レポートを書きます:
- 静的パス:ソースをスキャンし、次に読みます。
- ビジュアルパス:ページをレンダリングし、4つの幅で見ます。
- モーションと3Dパス:ページにモーションまたは3Dシーンがある場合のみ。
references/rubric.mdのルーブリック全体をエリアごとにウォークします:コピー、アートディレクション、ビルド、モーション、ローンチ準備。landing/review-checklist.mdに作業用チェックリストを書き込みます。すべての行IDに対して1行:fail(場所付き)、pass(証拠付き)、またはn/a(理由付き)。パスは、その証拠がその行の「確認方法」の出力である場合にのみカウントされます:リストと言えばリスト、カウントと言えばカウント、すべてのセクション、ヘッダー、フッターを含み、すべてのセクションをカバーします。ページの記憶からチェックされた行はウォークされません。短い静的ページでも複雑なページと同じようにコピーとアートディレクションを注意深く読み、1つのブロッカーがすでに明らかな場合でもすべての行をウォークします:レビューは、次のラウンドが修正しなければならないすべてのものをリストアップし、判定を決定するものだけではありません。references/report-format.mdの説明に従ってlanding/review.mdを書きます:テーブル内の失敗、「Checked and fine」の下に証拠付きの合格。その後、このファイルの最後にあるセルフチェックを実行します。
見つけたことについて、メモを取りながら進めます:どこで見たか(ファイルと行、または幅とセクション)、どのように確認したか。
静的パス
リポジトリ全体ではなく、ページのソースパスをスキャナーに向けます:
node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json
読み取るもの:直接指定したファイル(拡張子は問わない)。ディレクトリ内では、.html、.htm、.css、.scss、.js、.jsx、.mjs、.ts、.tsx、.astro、.vue、.svelte、.md、.mdx ファイルを読み取り、node_modules、.git、dist、build、.next、.astro、.output、.vercel、.wrangler フォルダをスキップし、1 MBを超えるファイルをスキップします。各行は25のルールに対してチェックされます。発見は file:line [rule-id] message として表示され、その後に fix: 行が続きます。終了コード1は何かが見つかったこと、0は何も見つからなかったこと、2は不正なパスまたは使用法を示します。--self-test はスキャナー自体をチェックします。
Markdownも読み取るため、メモ、レポート、ブリーフ、以前のレビューで引用されたフレーズも報告されます。ページソースではないファイル(landing/*.md、README、メモ、以前の review.md ファイル)内の発見はすべて無視します。
すべての発見を確認のプロンプトとして扱い、判定として扱わないでください。行を開き、それが実際に何を含み、ページがそれをどう処理しているかを確認し、その後で判断してください。ルールが何にマッチしたかを説明してください:タグの色に対するパレットヒットは、ページの背景に関する発見ではありません。ルックが決定する例:
- ロゴリンクの
dead-anchorは軽微なビルド障害です。メインのコールトゥアクションでは、コンバージョンが機能しないことを意味します:ブロッカーです。 overused-fontは、一般的なフェイスがスタックをリードしていることを意味します。direction.mdが理由を与えず、フェイスが明確なディスプレイまたはモノフェイスとペアになっていない場合にのみ発見となります。palette-cream-terracottaは2つの正確な16進値で発動します。クリームだけでは決して兆候ではありません。クリーム、テラコッタのアクセント、流行のセリフの組み合わせがそうです。
クリーンなスキャンは何も証明しません。でっち上げられた主張、JavaScriptなしでは空白のページ、大きすぎるバンドル、有効なページ内IDにリンクするが購入に決してつながらないコールトゥアクションは、すべてソースにパターンを残しません。ほとんどの障害は、不在、カウント、矛盾、構成、壊れた動作であり、行ごとの正規表現では見えません。ページはクリーンにスキャンされ、他のすべてのパスで失敗する可能性があります。
そのため、スキャン後は自分でソースを読んでください。読むことで行うチェックは references/rubric.md にあり、「source」とマークされています。最も多くをキャッチするもの:
<head>:タイトル、lang、メタディスクリプション、ファビコン、Open Graphタグ。- すべてのフォーム:どこに送信するか、ハンドラーがデータをどう処理するか、成功メッセージがサーバーを待つかどうか。
- すべてのコールトゥアクション
href:実際にどこに導くか。 - フォント:各
font-familyが@font-face、スタイルシートリンク、フレームワークのフォントインポートによってロードされているか、それともシステムスタックのみか。 - ページ上のすべての主張、数字、名前、仕様、約束をブリーフと照らし合わせてチェックします。ブリーフが提供されたと言っているすべてのアセットを、ページが表示しているものと照らし合わせてチェックします。
- それ自身を打ち消すCSS。たとえば、コンテナクラスの
paddingショートハンドがセクションルールよりも特異的で、静かにセクションの垂直パディングをゼロにリセットする場合。ブラウザで計算されたパディングを読み取って確認します。 prefers-reduced-motion:存在するかどうか、そして何をするか。- ビルドされたHTMLの本文:空の
<div id="root">で<noscript>がない場合、ページはJavaScriptなしでは空白です。
ビジュアルパス
レンダリングされたページが必要です。スキャナーとソースは、重なり、レイアウトの空の半分、折り返された見出し、崩れた間隔、3Dシーンの上にあるテキストを示すことはできません。
ページを提供する
常にHTTP経由でレビューします。プレーンHTMLも含みます。いくつかのチェックはサーバーを必要とします:ルート相対アセットパス(/styles.css、/assets/...)は file:// では失敗し、ルーブリック行L7は欠落パス、/robots.txt、/sitemap.xml を要求します。node_modules がない場合は、まず依存関係をインストールします。
- デプロイされたURL: それを直接使用します。
- プレーンHTMLとCSS:
index.htmlがあるフォルダで、python3 -m http.server 8000を実行し、http://localhost:8000/を開きます。 - Vite:
npm run build、次にnpx vite preview(デフォルトでポート4173)。 - Astro:
npm run build、次にnpx astro preview(デフォルトでポート4321)。 - Next.js:
npm run build、次にnpm run start(デフォルトでポート3000)。 - その他のビルド: ビルドし、出力フォルダで同じ
python3 -m http.serverコマンドを実行します。
レビューしたURLをPassesの下に書きます。file:// パスは最後の手段としてのみ開きます。何も提供できない場合です。その場合、L7は実行されず、ルート相対パスを持つアセットはその理由だけで欠落している可能性があります。Passesの下に両方をリストし、サーバーが見つけたはずの欠落アセットを報告しないでください。
既存のビルド出力をレビューするのは、それがソースと最新である場合のみです。find src index.html -newer dist/index.html(スタックのソースと出力パスを使用)は、ビルド以降に変更されたソースファイルをリストします。何かリストされた場合、またはビルドがない場合は、再ビルドします。Passesの下に、どちらをレビューしたか、その理由を記述します。
キャプチャ方法を選択する(この順序で)
-
ブラウザツール(環境にある場合)。次の機能が必要です:URLへのナビゲート、ビューポート幅の設定、全ページスクリーンショットの取得、ページ内でのスクリプトの実行、メディア機能(カラースキーム、モーション減少)とJavaScriptオフのエミュレート。
-
フォールバックスクリプト(ブラウザツールがないか、キャプチャできない場合)。ブラウザが利用できないと言われた場合でも実行します。
npxを介して独自のブラウザを起動し、とにかく動作する可能性があります。node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots --darkこれは、1.5秒の待機後、
360.png、768.png、1280.png、1440.png(--darkを使用すると360-dark.pngなど)を全ページで書き込み、各ファイルパスを出力します。「Executable doesn't exist」で失敗した場合は、npx playwright install chromiumを実行して再試行します。ゼロ以外のコードで終了するか、capture failed at <width>pxを出力するか、画像を書き込まない場合に失敗しています。 -
どちらも機能しない。 その場合のみ、ビジュアルパスは実行されません。とにかく静的パスとソースの読み取りを行い、
incompleteに対するVerdictルールに従います。
フォールバックは、ページ内でスクリプトを実行したり、モーション減少をエミュレートしたり、JavaScriptやWebGLをオフにしたり、スクロールしたりすることはできません。それを使用する場合、画像から判断できるものを判断し、モーション減少、JavaScriptオフ、WebGLオフをソースを読んで確認し、Passesの下にライブで実行できなかった各チェックを理由とともにリストします。
4つの幅すべてをキャプチャする
各幅(360、768、1280、1440。高さ800で問題ない)に対して:
- 幅を設定し、ページをロードし、フォントと画像を待ちます。
references/snippets.mdのビューポートチェックで実際の幅を確認します。一部のツールはウィンドウを最小値以下に縮小せず、静かに広いページを提供します。代わりにツールのデバイスまたはビューポートエミュレーションを使用し、再度確認します。- 全ページスクリーンショットを
landing/shots/に取ります。 references/snippets.mdの測定スクリプトを実行し、その注意事項を読みます:オーバーフロー、ビューポートより広い要素、レイアウトシフト、キャンバス数。- ライブブラウザでページを上から下までスクロールします。
次に、すべての画像を開いて読みます:4つの幅すべて、およびダーク画像(取った場合)。メモに幅ごとに、次に進む前に見たものを1行書きます。2つの幅を見て残りを想定することは、いくつかの幅でのみ現れる障害を見逃す方法です:広い幅でのみ行の半分を空のままにする狭いブロック、または最も狭い幅でのみメニューなしで隠されたセクションリンク。
全ページキャプチャが失敗するか、途中で切れてしまう場合(キャンバスがある背の高いページで発生する)、代わりに各幅の上部といくつかのスクロール位置(4分の1、半分、4分の3、下部)でビューポートをキャプチャし、Passesの下にそのように記載します。フォールバックスクリプトは全ページキャプチャのみを取ります。その方法で失敗した場合、どの幅が欠落しているかを記録します。
スクロール駆動ページの全ページキャプチャは、パララックスやスティッキーセクションがスクロール位置ゼロでオフスクリーンにある場合に空白のバンドを示すことがあります。空白領域を報告する前に、ライブページでそこまでスクロールします。そこでレンダリングされる場合、それはキャプチャのアーティファクトであり、欠陥ではありません。
探すもの
すべての幅で、ルーブリックを開いた状態で:
- 水平スクロール、クリップされたテキスト、重なる要素、画像やキャンバスの上にあって読みにくくなるテキスト。
- 間隔:垂直パディングのないセクション、上のブロックに接した見出し、コンテンツからはみ出る境界線。
- 構成:1280と1440で半分空の行、4行に折り返されるまたは最後の行に単一の単語を残す見出し、360で折り返されるアイブロウ、ラベル、ボタン、不均一な高さのカード。
- 360でのナビゲーション:セクションリンクにまだアクセスできるか、ボタンが少なくとも44x44 pxであるか、固定ヘッダーが見出しを隠していないか。
- 360での順序:製品がフォームの上に見えるか、下に押しやられているか。
- 画像:実際のアセットか、まだ存在しないアセットに対して正しいアスペクト比のラベル付きプレースホルダーか。
- キーボード:1280でページを一度タブ移動します。フォーカスは...
[翻訳のため一部省略]