メインコンテンツへスキップ
見出し画像

Codexに渡す仕事は、どこで切ると流れが崩れにくいのか

    Codex を使い始めると、だんだん「何ができるか」より「どこまで渡すか」で迷うようになります。

    小さい修正ならいけそう。でも、少し広い仕事になると急に手触りが変わる。ここで起きているのは、能力の差というより、仕事の切り方の差だと思います。

    仕事を小さくするより、境界をはっきりさせる方が先です。

    OpenAI Developers の Codex use cases と AGENTS.md を並べると、この感覚はかなり整理しやすくなります。


    「広い仕事」より「終わりが見える仕事」を渡す

    Codex use cases に並んでいる仕事を見ると、どれも大きそうに見えるのに、実は終わり方が見えています。

    • pull request をレビューする

    • API integration を upgrade する

    • responsive front-end を build する

    • 大きいコードベースを理解する

    この一覧を見ると、広い仕事を渡してよさそうに見えます。でも、実際に書かれているのは「何をどこまでやるか」が見えている仕事です。

    画像
    出典: OpenAI Developers Codex use cases

    だから、渡し方のコツは「とにかく小さくする」ではなく、「終わりが見える単位にする」ことです。

    たとえば、

    • この PR の懸念点を3つ出して

    • このディレクトリの役割を整理して

    • この画面の崩れだけ直して

    • このテストだけ足して

    このくらいまで境界が見えていると、Codex もこちらも迷いにくくなります。


    仕事を切る時は、4つだけ決める

    Codex に渡す仕事を考える時、最初に全部説明しようとすると、逆に流れが崩れやすくなります。

    先に決めたいのはこの4つです。

    1. どこを見るのか

    2. 何を変えるのか

    3. 何は変えないのか

    4. 最後に何を返してほしいのか

    この4つが見えていると、かなり安定します。

    逆に、

    • 全体を見ていい感じにして

    • 必要なら何でも変えて

    • よしなに判断して

    みたいな渡し方だと、こちらの期待もぶれやすくなります。


    AGENTS.md は、毎回同じことを言わなくてよくする

    OpenAI Developers の AGENTS.md guide では、リポジトリ内に AGENTS.md を置いて、プロジェクトのルールやよくある流れを書いておく考え方が案内されています。

    ここがかなり大きいです。

    画像
    出典: OpenAI Developers AGENTS.md guide

    毎回プロンプトで

    • テストはこれを使う

    • 触っていいのはこの範囲

    • この書き方に合わせる

    • 最後にこの形で返して

    と書き直すのは重いです。AGENTS.md があると、この共通部分を repo 側に置いておけます。

    すると、その時のプロンプトでは「今回どこをやるか」に集中しやすくなります。


    崩れにくいのは「大きい仕事を小さく切る」より「小さい仕事をつなぐ」やり方

    ここも感覚が変わりやすいところです。

    最初は、大きい仕事をどう分割するかを考えがちです。でも、実際に流れが崩れにくいのは、最初から小さい仕事をいくつかつないでいくやり方です。

    たとえば、

    1. まず読む

    2. 次に懸念点を出す

    3. そのあと直す

    4. 最後にテストする

    この順で進めると、途中で止まりにくくなります。

    一方で、

    1. 全部まとめて直して

    2. ついでに設計も整理して

    3. 必要ならテストも足して

    だと、一回で広がりすぎます。

    だから仕事を切る時は、粒度より順番も大事です。読む -> 判断する -> 直す の順が見えていると、Codex に渡す仕事はかなり安定します。


    4話目で覚えておきたいのは、境界と順番

    Codex に渡す仕事を考える時、見るべきなのはこの2つです。

    • 境界が見えているか

    • 順番が見えているか

    この2つがあると、仕事は広くても崩れにくくなります。逆に、この2つがないまま「全部やって」に近づくほど、途中の確認ややり直しが増えやすくなります。

    4話目で押さえておきたいのは、Codex は何でもできるから広く渡す、ではないということです。むしろ、境界と順番が見える仕事ほど、Codex の良さが出やすい です。

    次の回では、その流れの中で実際に詰まりやすい場所を見ていきます。どこで期待しすぎるのか、どこで頼み方が雑になりやすいのかを、もう少し具体に整理します。


    参考にしたもの

    OpenAI Developers: Codex use cases

    OpenAI Developers: AGENTS.md guide


    あわせて読みたい

     
     
    AIと一緒にプロダクトを作り始めました。 何度も詰まりながら気づいたのは、「AIは使い方ではなく設計で決まる」ということ。 その試行錯誤と、ハーネスエンジニアリングという考え方を発信しています。

    あなたへのおすすめ