audit-website

ウェブサイトを監査して修正する

ウェブサイトに対して squirrelscan 監査を実行し、LLM レポートを読み、各問題の原因となっているコードやコンテンツを特定して、まとめて修正し、スコア目標を達成するまで再監査します。

squirrel CLI が必要です（squirrelscan.com/download。squirrel --version で確認してください）。CLI のセットアップ、ログイン、公開、MCP、および一般的な CLI の使い方については、関連する squirrelscan スキルを使用してください。

ルールドキュメント

ルールを確認するには、https://docs.squirrelscan.com/rules/{rule_category}/{rule_id} を参照してください。例：

https://docs.squirrelscan.com/rules/links/external-links

監査の実行

squirrel audit https://example.com --format llm

• --format llm を使用してください。コンパクトかつ網羅的で、エージェント向けに作られています。
• ユーザーが URL を指定していない場合は、監査するサイトを尋ねてください。
• 可能な限り公開中のサイトを監査してください。実際のレンダリング、パフォーマンス、リダイレクトの動作を確認できるのは公開中のサイトだけです。ローカル開発サーバーと公開中のサイトの両方がある場合は、公開中のサイトを提案してください。いずれの場合も、修正はローカルのコードに適用します。
• 監査結果はローカルにキャッシュされます。再クロールせずに後から再レンダリングするには、squirrel report <audit-id> --format llm を実行してください。

スキャンの進行

1. 最初のパス、高速な網羅（デフォルト）：サイトに影響を与えずに、サイトの構造、技術、主な問題を把握するための高速で浅いスキャンです。
2. 2 回目のパス、より詳細な網羅：テンプレートレベルの網羅には -C surface（URL パターンごとに 1 ページ）、承認前の包括的なクロールには -C full を使用します。

モード	デフォルトのページ数	用途
quick	25	初回確認、CI チェック
surface	100	テンプレートレベルの網羅（/blog/{slug} のようなパターンごとにサンプルを 1 件）
full	500	最終確認、詳細な分析

便利なフラグ：--refresh（キャッシュを無視して完全に再取得）、--resume（中断したクロールを再開）、-m <n>（ページ上限）、--verbose（進行状況の詳細）。

サイトが不明なクローラーをブロックする場合（Shopify／Cloudflare）、-H "Name: Value" フラグを繰り返し指定して Web Bot Auth ヘッダーを渡してください。ヘッダーの値は機密情報として、出力では伏せられます。https://docs.squirrelscan.com/guides/web-bot-auth を参照してください。

修正のループ

1. レポートを提示する：スコア、評価、重要度順の主な問題を示します。
2. 修正を提案する：修正可能な問題を列挙し、変更を加える前にユーザーに確認します。
3. 問題をソースに対応付ける：各指摘の原因となっているテンプレート、コンポーネント、コンテンツファイルを特定します。
4. まとめて修正する：承認された修正を適用します。
5. 再監査する（デプロイ後やコンテンツ変更後は --refresh を使用）し、変更前後のスコアを示します。
6. 目標を達成するまで、または判断が必要な問題だけが残るまで繰り返します（例：「このリンクを削除すべきか？」）。推測で判断せず、ユーザーの確認が必要な問題として提示してください。

各修正後に、プロジェクトが引き続きビルドでき、既存のチェックに合格することを確認してください。

スコア目標

開始スコア	目標	想定される作業
< 50 (F)	75+ (C)	大規模な修正
50-70 (D)	85+ (B)	中程度の修正
70-85 (C)	90+ (A)	仕上げ
> 85 (B+)	95+	微調整

最終確認は -C full クロールを基準にしてください。quick パスではサイトの一部しかサンプルされません。

ルールにはレベル（error、warning、notice）とランク（1-10）があります。まずエラーを修正し、次にランクの高い警告を修正してください。コンテンツの編集が必要な指摘も、コードの編集が必要な指摘と同様に扱います。リンク切れは通常、人による判断（削除、置換、維持）が必要です。推測で判断せず、ユーザーに確認してください。

リグレッションの検証

ベースラインと比較して、改善を証明するか、リグレッションを検出します。

squirrel report --diff <baseline-audit-id> --format llm
squirrel report --regression-since example.com --format llm

完了

完了とは、すべてのエラーが修正され、警告が修正されるか人による確認が必要であると記録され、再監査で改善が確認され、変更前後のスコア比較と実施したすべての変更の概要をユーザーに提示した状態です。サイトの健全性を保つため、定期的に再監査してください。ユーザーが結果の共有を希望する場合は、公開レポートを提案してください（squirrelscan スキルを参照）。

レポート形式

LLM レポートは、トークン効率を最適化した簡潔な XML とテキストのハイブリッド形式です。健全性スコア付きの概要、影響を受ける URL を含むカテゴリ別の問題、リンク切れ、優先順位付けされた推奨事項で構成されます。完全な仕様：OUTPUT-FORMAT.md