website-audit は何をしますか?
1つのコマンドでサイトを測定し、スクリプトで判断できない部分を確認した上で、創業者がすぐに行動できるレポートを提供します。監査は読み取り専用です:フォームを送信したり、ログインしたり、状態を変更するクリックを一切行わず、robots.txtを尊重し、ページ読み込み間に待機時間を入れます。
入力
- URL(必須)。ユーザーが指定していない場合は確認します。
- ページ数制限(オプション、デフォルト10)。簡単な確認には3〜5、リビルド前の完全なベースラインには15〜25を使用します。
- レポートの言語(オプション、デフォルトはユーザーが使用している言語)。
必要条件
- Node.js 22以降(
node --version)。Lighthouseは追加でNode ≥ 22.19とnpm(npx)が必要です。 - Google ChromeまたはChromium。macOS、Linux、Windowsで自動検出されます(
npx playwright install chromiumでダウンロードしたChromiumも含む)。それ以外の場合はCHROME_BIN=/path/to/chromeを設定します。 - 監査対象サイトへのネットワークアクセス、および公開npm CDN(axe-core)とnpmレジストリ(Lighthouse)へのアクセス。どちらかのツールが取得できない場合、その項目はレポートでスキップされた旨と理由が記載され、実行自体は失敗しません。
手順
1. 監査の実行
<skill-dir>はこのSKILL.mdが存在するフォルダです。
node <skill-dir>/scripts/audit.mjs https://example.com --limit 10
オプション:--limit N · --delay MS(ページ間の待機時間、デフォルト1000) · --max-links N(内部リンクチェック数、デフォルト150) · --no-lighthouse · --no-axe · --max-minutes N(デフォルト15) · --out DIR。
出力先はカレントフォルダからの相対パス./website-audit/<ドメイン>/(--outまたはWEBSITE_AUDIT_OUT環境変数で上書き可能):
website-audit-<ドメイン>-<日付>.md:レポートwebsite-audit-<ドメイン>-<日付>.json:生の測定値、所見、スコア、スナップショットscreens/:各ページのファーストスクリーンショット(デスクトップおよび390px)
進捗はstderrに出力されます。最後のstdout行はJSONサマリーです(ok、report、pages、seconds、overall、counts、scores、skipped)。終了コード2は監査がまったく実行できなかったことを意味します(Node 22なし、Chromeなし、サイト到達不能):ユーザーにメッセージを表示し、何をインストールまたは確認すべきかを伝えます。
10ページの実行には約2〜4分かかります。Lighthouseにより30〜60秒追加されます。
2. 手動レビューのパス
<skill-dir>/references/manual-review.md に従います:
- すべてのP0が証拠と一致することを確認します(スクリプトは文字通り解釈するため、ボット対策やJavaScriptフォームによってP0が誤検出される可能性があります)。
- 「手動で確認」とマークされた各項目を、
screens/のスクリーンショットを見て解決します。 - 「Fix first」がリビルドの最初のスプリントとして読めることを確認します。
マークダウンレポートをその場で編集します。JSONは変更しないでください。これは生のベースラインです。
3. 言語
スクリプトは英語で出力します。ユーザーが別の言語で記述している場合は、レポートの見出し、「なぜリードにとって重要なのか」および「Fix」の行を翻訳します。URL、セレクター、メトリクス名、HTTPコード、P0〜P3のラベルはそのままにします。
4. 引き渡し
以下の内容で返信します:全体スコア、P0 / P1の件数、「Fix first」リスト、スキップされた項目とその理由、レポートへのパス。後日、新しいサイトで同じ制限で再実行し、スナップショットの「after」列を埋めることを提案します。
ユーザーがしきい値を編集して再レンダリングを希望する場合:
node <skill-dir>/scripts/report.mjs <パス-to-run>.json でJSONからマークダウンを再生成します。
各領域の内容
詳細、しきい値、優先順位ルールは<skill-dir>/references/checks.mdにあります。簡潔にまとめると:
| 領域 | 方法 |
|---|---|
| モバイルレイアウト | 各ページを360 / 390 / 768pxで確認:横スクロール、画面端からはみ出る要素、viewport meta、タップターゲット、小さなテキスト |
| バグ | コンソールエラーと例外、4xx/5xxおよび失敗リクエスト、 mixed content、画像切れ、内部リンク(HEAD/GET)、フォームターゲット(HEADのみ) |
| アクセシビリティ | axe-coreを各ページに注入、WCAG 2.0/2.1 A + AAタグ |
| パフォーマンス | ホームページのLighthouseモバイル;すべてのページのブラウザタイミング(TTFB、LCP、CLS、重さ、リクエスト数) |
| コンバージョンパス | デスクトップと電話でのファーストスクリーンCTA、連絡先までのクリック数、メール/電話/予約/リードフォーム、 testimonial、事例、ロゴ、数字 |
| SEO基礎 | title、description、1つのH1、canonical、Open Graph、noindex、robots.txt、sitemap.xml |
ルール
- フォームの送信、記入、クリックを絶対に行わないでください。ログインも行わないでください。ボット対策やCAPTCHAをバイパスしないでください。サイトがチャレンジページを表示した場合は、その旨を報告して停止します。
- robots.txtのdisallowルールを尊重し、ユーザーがサイト所有者でかつ高速実行を依頼した場合を除き、デフォルトの遅延を維持します。
- 「手動で確認」とマークされた所見は、スクリーンショットを確認するまでは仮説です。
- レポートを自身で公開しないでください。クライアントの弱点を記述している可能性があります。
このスキルではありません
- コピー、ポジショニング、メッセージの批評 →
website-copy-reframe - サイトからのブランド/デザインシステム →
design-system-generator - キーワード順位、バックリンク、トラフィック推計 → SEOデータツール