初めてコーディング エージェントが実際にバグを修正するとき、その反応はほとんど常に同じで、熱意と疑惑が入り混じったものになります。いいですね、確かに。しかし、その後、差分を見て自分に問いかけます。「分かったが、彼はいったい何を触ったのだろうか? 彼を信頼してもいいだろうか? 明日も同じように触るのだろうか?」

そこからが面白い部分の始まりだと思います。エージェントが関数を作成するときではなく、リポジトリの読み取り、パッチの作成、テストの実行、PR のオープン、レビュー コメントの後に戻ってくるなどの作業全体を引き受けるのに十分な能力を身につけたときです。 Codex は、バックグラウンド作業、個別のワークツリー、統合ブラウザ、自動化、プラグイン、メモリ、より明示的な権限制御など、まさにその方向に向かって進んでいます。

重要なのは、誰もコードを読まなくなる未来を想像しないことです。それは恐ろしい未来になるだろうし、かなりナイーブなものになるだろう。重要なのは、エージェントにすべてを任せるのではなく、多くのことができるエージェントとどのように連携するかを考えることです。

習慣の変化

従来のオートコンプリートでは、常にハンドルを握っていました。 AIがセリフを提案して、あなたが決めました。しかし、エージェントとの関係は変わります。あなたが彼に目標を与えると、彼は自分で複数のステップを経ていきます。

これは強力ですが、問題を転換します。問題はもはや「モデルはプログラムできるか?」というだけではありません。質問は次のようになります。

• 私は彼に十分な範囲を与えただろうか？
• 結果を確認する方法を知っていますか？
• 隔離された環境で作業しているのでしょうか?
• 最終審査はやはり人道的で慎重なものなのでしょうか？

健全なワークフローは、魔法の杖よりも次のようになります。

「エージェントがすべてを構築する」よりもロマンチックではありませんが、はるかにうまく機能します。また、人間との付き合いが上手なチームの仕事のやり方でもあります。つまり、明確なタスク、素早いフィードバック、明確な説明責任です。

良いプロンプトはほぼ良いチケットです

最も危険なプロンプトは、「請求書ページを修正してください」、「アーキテクチャを改善してください」、「認証モジュールをクリーンアップしてください」という、あいまいだが確信に満ちたプロンプトです。これらは生産的であるように聞こえ、巨大な差分を生成するリクエストです。しかしその後、あなたは考古学をやっていることに気づきます。

役に立つプロンプトはもっと退屈です。たとえば、テーブルが app/(dashboard)/invoices/page.tsx にあり、クエリが src/server/invoices.ts にあり、同様のパターンが app/(dashboard)/reports にすでに存在することを認識して、請求書ページの CSV エクスポートを実装します。

次に、明確な制約を追加します。データベース スキーマを変更しないこと、小さなユーティリティで十分な場合は依存関係を追加しないこと、既存の UI スタイルを維持することです。そして、npm test -- invoices と npm run build の検証で終了します。

この種のブリーフは、「AI に対してより適切に説明する」ためのものではありません。これは何よりも、何を委任しているのかを明確にするために役立ちます。具体的に書き留めることができない場合は、そのタスクがエージェントにとってまだ準備ができていない可能性があります。

私が喜んで任せる3つの仕事

1 つ目は繰り返しですが検証可能な作業です。テストの追加、新しい内部 API への呼び出しの移行、インポートの更新、非推奨のコンポーネントの置き換え、TypeScript エラーの修正です。ここでは、エージェントは時間を節約でき、リスクは制御可能です。

2 つ目は探索的な作業です。「この合計が計算される場所を見つけてください」、「このテストが脆弱である理由を説明してください」、「バグを再現して、どのファイルが影響を受けていると思われるかを教えてください」。パッチがすぐに生成されない場合でも、有用な偵察を行うことができます。

3 つ目は定期的なメンテナンス作業です。小規模な依存関係の更新、古い機能フラグのクリーンアップ、ブロックされた PR の概要、忘れられた TODO のチェックです。華やかさはありませんが、まさに積み重なりがちな仕事です。

私が人間らしく続ける3つの仕事

製品の決定は依然として人間によるものです。変更によってユーザーの支払い方法、データの削除方法、価格の確認方法、または権限の理解方法が変わる場合は、責任者が必要です。

認証、ロール、トークン、機密データのログ記録、データベースの移行など、セキュリティ境界にも人間の注意が必要です。エージェントは実装を支援できますが、唯一の意思決定者である必要はありません。

最後に、私は建築的なセンスを必要とするものはすべて人間的なものにしておきます。エージェントはリファクタリングを提案できますが、抽象化が本当に必要なのか、それとも存在しない問題を磨き上げているだけなのかを理解するのは依然として仕事です。

レビューは任意ではありません

エージェントが優れている場合、CI の緑を信頼する誘惑に陥ります。それは理解できます。問題が始まるのもこの時期です。

私は常に少なくとも 5 つのことに注目しています。

1. パッチは要求されたタスクのみを解決しますか?
2. 彼は関係のないファイルに触れたのでしょうか?
3. テストの対象となるのは、斬新な行動ですか、それとも単なる幸運な偶然ですか?
4. コードはローカルのパターンに従っていますか?
5. エラーはプロジェクトの残りの部分と同様に処理されますか?

何かが間違っている場合、フィードバックは具体的である必要があります。 「直す」というのは怠惰です。より良い方法: このユーティリティは parseMoney を src/lib/money.ts に複製します。その関数を再利用し、EUR の場合のテストを追加し、課金モジュールのパブリック API は変更しないでください。

エージェントは、検証可能な小さなコメントに対してよりよく反応します。不思議なことに、人々も同様です。

努力する価値のあるガードレール

エージェントがファイルを読み取り、コードを記述し、コマンドを実行できる場合は、強力なプロセスとして扱う必要があります。被害妄想は必要ありませんが、衛生管理は必要です。

別のワークツリーまたはブランチを使用します。そのため、差分を比較し、失敗した実験を破棄し、エージェントの作業と自分が行っていた作業を混同することがなくなります。

権限を制限します。 rg、git diff、npm test、npm run build などのコマンドは非常に無料です。デプロイメント、データベースの移行、シークレットへのアクセス、および破壊的なコマンドは明示的に行う必要があります。

必要のないときはネットワーク アクセスを減らします。多くのタスクでは、公式ドキュメント、パッケージ レジストリ、および特定の内部サービスで十分です。表面積が小さくなると、驚きも少​​なくなります。

アクションを追跡します。パッチがレビューに到着すると、プロンプト、実行されたコマンド、合格したテスト、および変更されたファイルを再構築できるはずです。官僚主義を生み出すためではなく、何か問題が起こった場合に何が起こったのかを理解できるようにするためです。

チームとして始める簡単な方法

もし私が小さなチームにエージェントを導入するとしたら、大きな変革を起こさずに始めるでしょう。

範囲が明確な問題には agent-ready ラベルを作成します。コンテキスト、制約、検証コマンドを含むテンプレートを追加します。理想的には数百行以内の小規模な PR をお願いします。目に見える変更については、テストまたはスクリーンショットが必要になります。そして何よりも、私はマージの責任者を残しておきたいと考えています。

2 週間後、どのタスクが実際にスピードアップしたか、どのレビューが多かったのか、どのプロンプトがわかりにくかったのか、コードベースのどの部分が脆弱すぎて委任できなかったのかなどのデータを確認しました。

「今日からエージェントと一緒にすべてをやってみます」ほど派手なアプローチではありませんが、後悔することなく 3 週目を迎えることができる方法です。

最も人間的な部分

面白いのは、エージェントが自律的になるにつれて、適切なチケットを作成する、小さなカットを行う、テストを作成する、差分を読み取る、トレードオフを伝えるといった古典的なスキルが再び重要になることです。エージェントは、すでにうまく働く方法を知っている人々を加速させます。また、不適切に委任した人々の混乱も増幅します。

いいえ、私はマルチエージェントのワークフローがエンジニアリングをやめる近道だとは考えていません。私はこれらを、何を構築するかを決定し、それが動作することを確認し、システムを理解しやすくしておくなど、重要な部分により多くのエネルギーを移す方法だと考えています。

エージェントは優れた非同期同僚になる可能性があります。しかし、非同期の同僚が役に立つためには、コンテキスト、境界線、レビューが必要です。他のみんなと同じように。

役立つ情報源

• (ほぼ) すべてのコーデックス - OpenAI
• OpenAI で Codex を安全に実行する
• Codex の紹介 - OpenAI
• GitHub Copilot コーディング エージェントの新機能