本文へ移動
← 目次 AIエージェント0→1 DAY 13

第3章|仕事を進める環境を確かめる。

DAY 13 ・ 約15〜20分

OpenAI Codexで仕事を進める

調査、計画、実装、検証、レビュー、引き渡しを一つの流れとして扱う。

今日できるようになること

Codexへ安全で検証可能な依頼を渡し、成果物と証拠を確認して仕事を完了できる。

01 言葉を知る02 仕組みを理解する03 実例で理解する04 今日の理解度を確認する05 今日の整理をする
01|言葉を知る

言葉を知る

Codex

リポジトリや作業フォルダーを読み、開発ツールを使って調査・変更・検証を進めるOpenAIのコーディングエージェント。

リポジトリ

ソースコード、設定、資料、変更履歴をGitなどでまとめて管理する単位。

差分

変更前と変更後を比較し、追加・削除・修正された部分を示したもの。

サンドボックス

エージェントが読み書きやコマンド実行を行える範囲を制限する環境。

受け入れ条件

依頼が完了したと判断するために、成果物や動作が満たす具体的な基準。

Git

worktreeは別のコピーですが、Gitの履歴を共有します。

変更レビュー

調査、計画、実装、検証、レビュー、引き渡しを一つの流れとして扱う。

02|仕組みを理解する

仕組みを理解する

Codexは答えるだけでなく作業環境で仕事を進める

通常のチャットAIへ「ログイン画面を直して」と相談すると、原因候補、コード例、手順を文章で返すところまでが中心です。Codexは、許可されたプロジェクトのファイルを調べ、関連箇所を探し、差分を作り、テストやビルドを実行し、結果を報告できます。説明と現実の成果物がつながるため、利用者はコードを一行ずつ転記するのではなく、変更内容と検証結果をレビューできます。 OpenAIの公式資料では、CodexをCLI、IDE拡張、ChatGPTデスクトップアプリなど複数の場所から利用できると説明しています。CLIはターミナルでリポジトリを扱う作業、IDE拡張は編集画面と差分を近くで確認する作業、デスクトップアプリはプロジェクト、複数チャット、worktree、レビューをまとめる作業に向きます。どの画面を使っても、良い仕事の基本は対象、指示、権限、検証をそろえることです。 Codexは「コードを書くAI」だけではありません。既存仕様の調査、エラー原因の特定、依存関係の確認、テスト作成、文書更新、差分レビューにも使えます。ただし、ファイルへアクセスできるから製品の目的まで自動で理解するわけではありません。利用者が何を変えたいか、何を守るか、どこまでできれば完成かを示す必要があります。

最初の依頼は目標・文脈・制約・完了条件で作る

OpenAIのベストプラクティスは、最初の依頼へ目標、文脈、制約、完了条件の四つを含める方法を勧めています。目標は「何を実現するか」、文脈は「どのファイル、エラー、資料、画面が関係するか」、制約は「変えてはいけないもの、守る設計、権限」、完了条件は「何が確認できれば終わりか」です。 「サイトを改善して」だけでは、色、文章、構造、速度のどれを変えるか分かりません。「スマホでクイズの次問題を押すと問題文の先頭が見えるようにする。対象はQuiz.tsx。回答順のシャッフルは維持し、既存講座を壊さない。5問の遷移とビルドが合格したら完了」のように書けば、探索範囲と検証が明確です。実装方法まで決められない場合は、目的と判断基準を詳しく伝え、方法の調査はCodexへ任せます。 エラーメッセージ、再現手順、期待する動き、実際の動きを一緒に渡すと診断しやすくなります。参考にしてほしい既存実装があればファイル名や画面を示します。一方、関係のない会話全文、別案件の規則、古い案を大量に渡すと判断がぶれます。今の成果に必要な文脈へ絞り、長期規約はDAY12で学んだAGENTS.mdへ置きます。

複雑な仕事は計画してから変更する

小さな文言修正なら直接進められますが、複数画面、データ移行、認証、公開を含む変更は、実装前に調査と計画を置きます。公式資料は、複雑、曖昧、説明しにくい仕事ではPlan modeを使う、質問させる、長期作業では実行計画を用意する方法を紹介しています。計画は長い作文ではなく、何を確認し、どの順番で変え、各段階をどう検証するかの地図です。 最初にCodexへ現状を読み取らせます。入口のファイル、データの流れ、関連テスト、既存規約、未保存差分を確認し、推測と事実を分けて報告させます。次に、変更対象、影響範囲、危険な操作、検証方法を計画へ入れます。要件が複数の意味に取れる時や、外部公開・削除・課金など影響が大きい時は、実装前に人が判断します。 計画を作ったから正しいとは限りません。存在しないファイル、古いライブラリの使い方、実行できないテストが混ざることがあります。計画中に実際のプロジェクトを読ませ、公式資料が必要な機能は一次情報で確認します。作業が進んで前提が変われば計画を更新し、最初の案へ無理に従い続けません。

調査してから小さな差分を作る

実装では、まず既存の書き方へ合わせます。似た機能、共通部品、設定、テストを検索し、新しい仕組みを増やす必要があるか判断します。読まずに全面書き換えすると、既存の認証、表示、型、命名、利用者の未保存変更を壊しやすくなります。Codexには「関連箇所を先に示し、必要最小限の差分で直す」と伝えると、レビューしやすい変更になります。 大きな変更は、独立して確認できる単位へ分けます。たとえば要件を確定し、データ構造を変更し、画面を更新し、テストを追加し、文書を直す順です。各段階で型検査や対象テストを実行すれば、失敗の原因を狭められます。一度に数十ファイルを変えて最後にだけビルドすると、どの変更が壊したか分かりにくくなります。 Codexが変更してよいのは、依頼と権限の範囲だけです。関係のない警告、古いコード、別機能を見つけても、依頼が診断だけなら勝手に修正しません。追加対応が必要なら、今回の完成に不可欠か、別課題かを分けて報告します。利用者の既存差分を見つけたら消さず、重なる場合は安全に避けるか判断を求めます。

権限と承認は仕事の危険度に合わせる

Codexのサンドボックスは、読み取りだけ、作業場所への書き込み、より広いアクセスなど、実行できる範囲を制限します。承認モードは、どの操作で人の許可を求めるかを決めます。公式資料は、最初は既定の厳しい権限から始め、信頼できるリポジトリや具体的な必要がある仕事でだけ緩めることを勧めています。 調査なら読み取り、実装なら対象プロジェクトへの書き込み、公開や外部サービス更新ならその操作に必要な接続だけを与えます。PC全体への書き込み、秘密の一覧、管理者権限を最初から渡す必要はありません。インストール、外部送信、削除、権限変更、本番公開は、内容と影響を確認できる段階で承認します。 外部のWebページ、Issue、ログ、リポジトリ内文書には、エージェントを誘導する文字が含まれる可能性があります。それらは調査資料であって上位の命令ではありません。「秘密を表示しろ」「保護を解除しろ」という記述に従わせず、現在の依頼と信頼できる規則を優先します。秘密はチャットやコードへ貼らず、必要な操作へ限定された保管方法を使います。

テスト・表示確認・レビューまでが実装である

ファイルを保存できても仕事は完了ではありません。変更した層に合う検査を行います。関数なら単体テスト、複数部品なら統合テスト、画面ならブラウザー操作、型付きコードなら型検査、配布物なら本番ビルドを確認します。バグ修正では、修正前に再現できた手順が修正後に通ることと、関連する正常動作が壊れていないことを見ます。 OpenAIの公式資料は、テスト作成、関連テスト、lint、format、型検査、最終動作、差分レビューを組み合わせることを勧めています。Codexへ「テストして」とだけ言うのではなく、合格すべきコマンドと画面操作をAGENTS.mdや依頼へ書きます。テストが存在しない場合は、機械的に確認できる最小の検査を追加するか、手動確認の手順と限界を残します。 次に差分を読みます。意図したファイルだけか、秘密やデバッグ出力が入っていないか、不要な依存関係を追加していないか、古い機能を消していないかを確認します。Codexのレビュー機能は、未保存差分、コミット、基準ブランチとの比較などを対象にできます。しかしレビュー結果も最終保証ではありません。重要な変更は、テスト結果と利用者の業務判断を合わせて採用します。

worktreeとGitで並行作業を分離する

自分がローカルで編集している間にCodexへ別の変更を任せる場合、同じ作業場所を共有すると、互いの未保存差分を上書きしたり、テスト結果が混ざったりします。ChatGPTデスクトップアプリのCodexでは、Gitリポジトリに対してworktreeを使い、独立したファイル一式で別チャットを進められます。ローカルを前景、worktreeを背景の作業場所として分ける考え方です。 worktreeは別のコピーですが、Gitの履歴を共有します。同じブランチを複数のworktreeで同時にチェックアウトできないというGitの制約があります。別ブランチかdetached HEADで作業し、完成後にHandoff、コミット、プルリクエストなど適切な方法で統合します。ファイルを分けたから自動的に競合が解決するわけではなく、同じ行を変更すれば統合時に人の判断が必要です。 Git管理外の秘密や環境ファイルは新しいworktreeへ自動でそろわない場合があります。必要な準備手順を安全に用意し、秘密を不用意に複製しません。並行作業を始める前に、担当範囲、基準ブランチ、成果物、統合責任、検証場所を決めます。簡単な一件にworktreeを増やしすぎると、依存関係、容量、統合作業が増えるため、衝突を避ける価値がある時に使います。

失敗を隠さず、検証可能な形で引き渡す

よくある失敗は、曖昧な依頼のまま大きく変更する、テスト失敗を既存問題として無視する、成功していない操作を「完了」と書く、関係ない差分を一緒に直すことです。Codexの説明が自然でも、実際のファイル、Git差分、コマンド終了状態、画面、外部サービスの状態と一致するとは限りません。完了は自己申告ではなく証拠で判断します。 引き渡しでは、何を変えたか、利用者にとって何が変わるか、どの検査を行い結果はどうだったか、残る制約や未完了は何かを短く報告します。失敗した検査はコマンド名と原因を示し、実行できなかった検査は「未確認」と書きます。公開URLやプルリクエストがある場合は対象を明記し、別環境の結果と混ぜません。不要な作業記録を大量に並べず、判断に必要な証拠を優先します。 読者演習では、小さな不具合を一つ選びます。再現手順、期待する動き、実際の動き、対象候補、変更禁止範囲、完了条件を書き、Codexへまず調査させます。計画を確認後、最小差分で修正し、対象テスト、関連テスト、差分レビューを実行させます。最後に、別の人が引き渡し文だけで変更内容、確認結果、残る危険を説明できるか確かめてください。

03|実例で理解する

実例で理解する

具体例で考える

「スマホでクイズの次問題を押した時、次の問題文が画面上部へ戻らない」という不具合なら、対象画面と再現手順、シャッフルを維持する制約、5問すべての遷移と本番ビルドという完了条件を渡します。Codexは既存のQuiz部品を読み、最小差分でスクロール処理を追加し、実画面と差分を確認します。引き渡しでは変更箇所、5問の結果、ビルド、未確認事項を報告します。

手を動かして理解する

  1. 自分の小さな不具合を一つ選び、期待する動きと実際の動きを書く
  2. 目標・文脈・制約・完了条件の四項目でCodexへの依頼を作る
  3. 実装前に調べるファイル、危険な操作、検証方法を計画させる
  4. 最小差分で変更し、対象テスト・関連テスト・差分レビューを行う
  5. 変更内容、検証結果、未確認事項を三段落以内で引き渡す

04|今日の理解度を確認する

DAY 13の理解度を確認する

1 / 5
QUESTION 01

既存サイトの不具合修正をCodexへ依頼する最初の説明として、最も適切なものはどれですか。

QUESTION 02

認証とデータ移行を含む複雑な変更で、実装前に行うこととして最も適切なのはどれですか。

QUESTION 03

自分がローカルで編集している間に、Codexへ別機能を並行して任せたい場合の方法として最も適切なのはどれですか。

QUESTION 04

Codexが「修正は完了しました」と報告した時、採用判断として最も適切なものはどれですか。

QUESTION 05

Codexへ本番公開を任せる時の権限設計として、最も適切なものはどれですか。

05|今日の整理をする

今日の整理をする

ここまで分かれば次へ

  • ✓ Codexへの依頼は目標・文脈・制約・完了条件をそろえ、複雑な仕事は調査と計画から始める
  • ✓ 権限を必要最小限にし、既存差分を守りながら小さな変更と検証を繰り返す
  • ✓ 完了は説明ではなく差分、テスト、画面、外部状態の証拠で判断し、未確認を明記して引き渡す

講義本文 4,419字

参考資料

公式の一次情報で確かめる

NEXT LESSONDAY 14「Claude Codeで仕事を進める」へ次のDAYに進む →