Codex Goal modeとは

このページでわかること

• Codexまわりの検索意図を、初心者向けに役割別で整理できます。
• ローカルファイル、認証情報、APIキー、パスワード、DB情報、.env、秘密鍵を慎重に扱う理由が分かります。
• AIの変更提案をそのまま反映せず、人間が差分確認する流れを確認できます。

目標文と完了条件

Codexに作業を頼む時は、「サイトをよくして」ではなく、「対象ページにこの説明を追加し、titleとcanonicalは変えず、公開URLで200 OKを確認する」のように、目標と完了条件を分けます。Goal modeという言葉を調べた人は、まずAIに渡すゴールを人間が言語化する考え方から押さえると安全です。

停止条件を決める

長い作業では、途中で止まる条件も必要です。未作成URLへのリンクが必要、秘密情報が見つかった、公式情報なしに断定が必要、DBやcronや.htaccessに触る必要がある、表示崩れの原因が大きい、といった条件を先に書いておくと、AIが危ないまま進むのを防ぎやすくなります。

初心者向けの書き方

初心者は「やること」「やらないこと」「確認項目」「報告形式」を分けて書くと、Codexに伝わりやすくなります。AI作業は速い一方、意図しない変更や見落としも起きます。完了条件を人間が読み返せる形にしておくことが、作業後の確認にも役立ちます。

大きな作業を分ける

1回のGoalに調査、実装、公開、検証、記事化まで詰め込むと、どこで失敗したのか分かりにくくなります。まず調査、次に小さな実装、最後に公開確認というように段階を分けると、AIにも人間にも確認しやすい作業になります。

完了後の確認まで含める

Goalを決める時は、作業が終わったあとに何を確認するかもセットで書きます。ページが200 OKか、sitemapに載ったか、noindexがないか、内部リンクが切れていないか、スマホ表示が崩れていないかまで含めると、成果物の受け取りが曖昧になりにくくなります。

比較表

完了条件の書き方

「よくして」「直して」で頼むと、どこで終わりか決まらないまま作業が広がります。完了条件は、あとから見て○×を付けられる形で書きます。

コツは、変えないものも書くことです。「触らないファイル」「変更しない項目」を明示しておくと、意図しない変更を防げます。やることだけ書くと、周辺まで手が入ります。

止める条件を先に決める

長い作業では、完了条件と同じくらい「止まる条件」が重要です。判断に迷ったまま進むと、戻す作業が大きくなります。次のような場面は、進めずに止めて確認する対象です。

• まだ存在しないURLへリンクが必要になった：先に作るのか、リンクを外すのかを決めてから進みます
• 秘密情報が見つかった：認証情報やAPIキーが混ざっていた場合は、その場で止めます
• 公式情報なしに断定が必要になった：根拠のない記述を足すくらいなら、未確認と書いて残すほうが安全です
• 設定ファイルや公開範囲にかかわる変更が必要になった：影響がサイト全体に及ぶ変更は、個別に判断します
• 想定していなかったファイルを変更する必要が出た：範囲の外に出た時点で一度止めます

また、1回の指示に調査・実装・公開・検証を詰め込まないでください。どこで失敗したか分からなくなります。調査、小さな実装、公開確認の順に分けると、途中で止まっても状態が壊れにくくなります。仕様や機能の呼び方は変わることがあるため、詳細は提供元の公式情報で確認してください。

確認チェックリスト

• 対象URLと対象ファイルを確認した
• 触らないファイルと停止条件を決めた
• 秘密情報や認証情報を入力していない
• 差分、リンク、スマホ表示、SEOタグを人間が確認した
• 仕様や画面の最新情報が必要な場合は提供元の情報も確認する

関連ページ