AIへの作業依頼の型(目的・対象・禁止事項・検査・報告形式)
要点
目的・対象・現状・やること・禁止事項・検査・止める条件・報告形式を分けて書く。guidepocket.net 制作で繰り返し使い、手戻りが少なかった指示の型。
guidepocket.net 制作で実際に使い、AIが範囲外を触らず最後まで進められた指示の構成。
型
【目的】何のための作業か(1〜2行)
【現在の状態】完了していること・前回の続きの位置
【今回やること】番号付きで順番どおり
【対象】ページ・ファイル・範囲(ID、URL、ファイル名)
【変更禁止】触ってはいけないもの(本文、CSS、URL、スラッグ、親子、menu_order、トップページ、設定 など)
【検査】終わったら何を確認するか(HTTP、H1、リンク、PC/スマホ390px、横スクロール、既存差分)
【止める条件】重大な問題・削除が必要・解釈が確定できない場合だけ停止して報告
【報告】報告してほしい項目だけを列挙(件数、結果、バックアップ先、要確認)
途中確認は不要です。/まず調査だけ、変更はしないでください。
コツ
- 「調査だけ」「変更してよい」をはっきり分ける。調査フェーズと実行フェーズを別の依頼にすると安全。
- 変更禁止は具体名で書く(「既存ページ」だけでなく「本文・CSS・URL・menu_order」)。
- 数値の基準を書く(本文1,500〜2,500字、スマホ390px など)。
- 報告は項目と行数を指定すると、全文HTMLなど不要な出力を防げる。
- 前回の続きは「完了済み」「再開位置」を書くと重複作成を防げる(作業の再開方法(途中停止・API Error・コンテキスト切れのあと))。
- 検索ルール: 作業前に knowledge を検索させる(Claude Code が作業前にナレッジを検索・追加する手順)。