AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる)
要点
症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
渡す情報
- 症状(何をすると、どうなるか)と期待する結果
- 再現する条件(ページ、PC/スマホ、ブラウザ、ログイン有無)
- いつから、直前に何を変えたか
- 既に確認したこと(「href は正しい」「HTTP 200」など)
進め方
- 仮説を複数出させる(例: z-index、position、pointer-events、疑似要素、JS、キャッシュ)。
- 実環境で確かめる手段を使わせる: ヘッドレスブラウザでのクリック、
document.elementFromPoint()、DevTools の Computed、コンソールエラー。 - 最小の仮修正を一時的に当てて効くか確認 → 本番の修正は別ステップ。
- 修正後も同じ手段で再検査する。
教訓(guidepocket.net)
- 当初の検査は「hrefが実URL・HTTP 200・pointer-eventsなし・重なる要素なし」とHTMLとCSSを読んで判定し、問題なしとしていた。
- 実ブラウザで
elementFromPointを取ると、Astra の透明ヘッダー#mastheadがリンクの上に重なっていた(Astra透明ヘッダー(#masthead)で上部の戻るリンクが押せない)。 - 仮CSSの確認時、注入したCSSが本番CSSより前に読み込まれて効かないように見えた(テスト用に注入したCSSが本番CSSより先に読み込まれて効かない)。仮修正の効き方も疑う。
頼み方の例
「まず原因調査だけ。実ブラウザでクリックして確認し、HTMLを読むだけで判定しないこと。原因を特定したら修正案を出して止まって」
エラー調査を頼むときのテンプレート
【何をしたか】(操作・変更。例: プラグイン X を更新した後、トップを開いた)
【期待した結果】(例: トップが表示される)
【実際の結果】(例: 500 エラー/ボタンを押しても何も起きない)
【エラー文】(そのままコピー。トークン・個人情報は伏せる)
【変更直前の状態】(最後に正常だった日時、直前にした変更)
【使用環境】(PC/スマホ、ブラウザ、WordPress/PHPの版、サーバー)
【再現手順】(1. ○○を開く 2. △△を押す 3. ××が起きる)
【確認済みのこと】(HTTP 200、キャッシュ削除済み など)
まず原因調査だけ。修正はしないで、候補と確認方法を出してください。
- 最初からコード全体を渡さない。エラーに出たファイル・関係する部分・ログの該当行に範囲を絞る。足りなければAIに「どのファイルのどこが必要か」を聞く。
- ログ・エラー文はURL内のトークン・メールアドレス・注文番号を伏せてから渡す(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない、ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意)。