AIにHTML/CSS修正を頼むときの安全な指示(指定箇所以外を変更させない)
要点
変更範囲・変えてよい値・禁止事項を明示し、新しいCSSは専用クラスに限定、作業後は変更前との差分とスクショで「指定箇所以外が変わっていない」ことを機械的に確認させる。
AIは「ついでに整える」「よかれと思って直す」ことがある。言葉での禁止だけでなく、差分で確認できる形にするのが要点。
指示に入れること
- 変更してよい範囲: どのファイル・どのブロック・どのセレクタか。
- 変えてよい値: 例「
.xxx aに position と z-index を追加するだけ」。 - 変更禁止: 見た目・文字サイズ・余白・色・配置・本文・クラス名・構造。
- 追加のやり方: 既存ルールは書き換えず、
<style>の末尾に追記する/新しいクラスは専用の接頭辞(例wg-sites)に限定する。 - 確認方法: 変更前をバックアップ → 変更後に差分を出し、想定した追加部分以外の差分が0であることを確認。
- 報告: 変更した行・ページ数・差分結果だけ。
確認のさせ方(guidepocket.net で採用)
- テキスト差分: 追加ブロックを取り除くと変更前と完全一致するか(
linkfix_verify.phpの考え方)。 - 表示差分: 修正CSSあり/打ち消しでスクショを撮り、バイト単位で一致するか。ページ高さ・リンク座標・横スクロールの差も確認。
- サーバー側の一括比較: 対象外ページの差分0(
verify.php)。
よくある失敗
- 「CSSを整理して」「きれいにして」のような広い言い方 → 無関係なルールまで書き換えられる。
- 完全なHTMLを丸ごと再出力させる → 気づかない細部(属性、空白、クラス)が変わる。差分修正を優先(AIでのHTML修正:完全HTMLで渡す場合と差分修正の使い分け)。
- 修正後の確認をHTMLを読むだけで済ませる → 実表示では効いていない場合がある(リンク・ボタンがクリックできない(見えない要素の重なり・pointer-events・z-index))。
コード修正を頼むときのテンプレート
【目的】(例: スマホでCTAボタンが2行になるのを1行にしたい)
【変更箇所】(ファイル名・セレクタ・行。例: style.css の .wg-cta a だけ)
【変更禁止】(見た目・余白・色・文字サイズ・HTML構造・他のセレクタ・PC表示)
【既存コード】(該当部分だけ貼る。全文は不要)
【PC / SP】(PCは変えない。390px幅で1行になること)
【期待結果】(例: 390pxで1行、はみ出し・横スクロールなし)
【出力形式】(変更前→変更後の差分だけ/追記するCSSブロックだけ。全文を出さない)
他は一切変更しないでください。変更が必要な箇所が他にあれば、変更せずに報告してください。
- 「他は一切変更しない」だけでなく、変えてよい範囲を具体名で書き、「必要なら報告して止まる」を添えると、ついでの変更が減る。
- 受け取った修正は差分で確認し、PC・スマホの実表示で確かめる。