AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる)

確定 AI活用トラブル解決 更新 2026-09-26
要点

症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。

渡す情報

  • 症状(何をすると、どうなるか)と期待する結果
  • 再現する条件(ページ、PC/スマホ、ブラウザ、ログイン有無)
  • いつから、直前に何を変えたか
  • 既に確認したこと(「href は正しい」「HTTP 200」など)

進め方

  1. 仮説を複数出させる(例: z-index、position、pointer-events、疑似要素、JS、キャッシュ)。
  2. 実環境で確かめる手段を使わせる: ヘッドレスブラウザでのクリック、document.elementFromPoint()、DevTools の Computed、コンソールエラー。
  3. 最小の仮修正を一時的に当てて効くか確認 → 本番の修正は別ステップ。
  4. 修正後も同じ手段で再検査する。

教訓(guidepocket.net)

頼み方の例

「まず原因調査だけ。実ブラウザでクリックして確認し、HTMLを読むだけで判定しないこと。原因を特定したら修正案を出して止まって」

エラー調査を頼むときのテンプレート

【何をしたか】(操作・変更。例: プラグイン X を更新した後、トップを開いた)
【期待した結果】(例: トップが表示される)
【実際の結果】(例: 500 エラー/ボタンを押しても何も起きない)
【エラー文】(そのままコピー。トークン・個人情報は伏せる)
【変更直前の状態】(最後に正常だった日時、直前にした変更)
【使用環境】(PC/スマホ、ブラウザ、WordPress/PHPの版、サーバー)
【再現手順】(1. ○○を開く 2. △△を押す 3. ××が起きる)
【確認済みのこと】(HTTP 200、キャッシュ削除済み など)
まず原因調査だけ。修正はしないで、候補と確認方法を出してください。