AIでのHTML修正:完全HTMLで渡す場合と差分修正の使い分け
要点
既存ページの修正は差分(該当箇所だけ置換・追記)が基本。新規ページはテンプレートのプレースホルダ置換で作る。完全HTMLの再出力は、小さいHTMLの新規作成か全面作り直しのときだけ。
| 場面 | 方法 | 理由 |
|---|---|---|
| 既存ページの一部修正(リンク、CSS追加、文言) | 差分(該当箇所の置換・末尾への追記) | 範囲外が変わらない。差分で検証できる |
| 同じ型の新規ページを大量に作る | テンプレート+プレースホルダ置換 | CSS・構造が必ず一致する。AIには中身(原稿)だけ書かせる |
| 小さい独立パーツを新しく作る | 完全HTMLで生成 | 既存に影響しない。専用クラスに限定する |
| 構造から作り直す | 完全HTML(ただし事前バックアップと見た目比較) | 差分では追えない |
差分修正の頼み方
- 「このブロックのこの行を、こう変える」「
</style>の直前にこのルールを追加」のように位置を指定する。 - チャット型AIには、変更後の全文ではなく「変更前 → 変更後」の対で出させる。
- Claude Code なら Edit(文字列置換)で変更させ、変更後に差分を確認させる。
完全HTMLを扱うときの注意
- AIが省略(「…以下同じ」)したり、属性・空白・クラスを変えたりすることがある。
- 受け取ったら、元との差分を取り、意図しない変更がないか確認してから使う。
- 長いHTMLはチャットに貼り付けず、ファイルで渡す/保存させる。
guidepocket.net の例
- 記事: テンプレートのプレースホルダだけ置換 → CSS差分0を自動確認(WEBガイドのテンプレートと記事本文HTMLのルール(HTML①・HTML②))。
- 戻るリンク修正: 174ページの
<style>末尾にルールを追記するだけ。 - トップページのカード削除: 4ブロックの削除だけで、残りはバイト一致を確認。