新しいハンドオフ: AI エージェントのコードをチームと共有する方法1 min read

AI エージェントは便利なものを構築しました。おそらくそれは、ダッシュボード、新しいオンボーディング フロー、または小さな社内アプリです。

動作しているのがわかります。コードはいい感じです。さて、あなたのチームメイトはまったく合理的な質問をします。

「送ってもらえますか？」

そこで、AI コーディングのワークフローが手動で引き継がれることがよくあります。スクリーンショットを送信したり、コード スニペットをコピーしたり、ブランチをプッシュしたり、プロジェクトをローカルで実行する方法を説明したりします。

しかし、質問者はソースコードを望まないかもしれません。彼らは、それを開いて試し、何を変更する必要があるかを伝えたいと考えています。

AI が生成したコードを共有する適切な方法は、次に何が起こるかによって決まります。

まず、実際に何を共有していますか?

誰かが AI エージェントが生成したコードを尋ねるとき、その人は 3 つの異なることを意味している可能性があります。

1. ソースコード

開発者は実装を検査し、テストを実行するか、既存のコードベースにマージする必要があります。

通常は、Git リポジトリとプル リクエストが正しい答えです。これらは、変更のレビュー、テストのチェック、コードの運用環境への統合のための使い慣れたワークフローを提供します。

2. 動作バージョン

プロダクト マネージャーは、オンボーディング フローをクリックして実行したいと考えています。デザイナーはレスポンシブ レイアウトを確認したいと考えています。関係者がダッシュボードを試したいと考えています。

ここではソース ファイルの送信は特に役に立ちません。ブラウザで開くことができるアプリまたはアーティファクトが必要です。

3. 誰かが続けてくれる仕事

チームメイトはアプリをレビューし、変更を提案し、AI エージェントにフィードバックを実装してもらいたいと考えています。

これは別の種類のハンドオフです。宛先にはスナップショット以上のものを保持する必要があります。作品、その歴史、そしてそれを継続する人がアクセスできるように保存する必要があります。

これらのワークフローは重複していますが、互換性はありません。

コードの共有と作業の引き継ぎの違い

エージェントが顧客分析ダッシュボードを構築すると想像してください。

これには、3 つの KPI カード、使用状況グラフ、および日付フィルターが含まれています。

チームメイトに React ファイルを送信できます。結果を確認するには開発環境が必要です。

スクリーンショットを送信できます。彼らはレイアウトを理解できますが、フィルターをテストすることはできません。

どこかに展開することもできます。彼らはそれを操作することはできますが、フィードバックを収集してプロジェクトを更新するプロセスが必要になります。

次に、少し異なるワークフローを想像してください。

エージェントは共有アーティファクト ワークスペースにダッシュボードを作成し、その URL を提供します。

チームメイトはアーティファクトを開いてフィルターをテストし、チャートにフィードバックを残します。同じ成果物に変更を加えるようにエージェントに依頼します。

URLはそのままです。作品には歴史があります。別の会話を開始して、前のエージェントが構築したものを説明する必要はありません。

それは設計する価値のある引き継ぎです。

AI が生成したコードをチームと共有する方法

これを使用した実際のワークフローは次のとおりです。 AgentGrid.io、Anima によって構築された、人々と AI エージェントのための共有アーティファクト ワークスペース。

ステップ 1: 好みの AI コーディング ツールを使用して構築する

Claude Code、Codex、Cursor、または使い慣れた別のツールで作業を続けてください。

たとえば:

使用状況グラフ、日付フィルター、および 3 つの KPI カードを備えた応答性の高い製品分析ダッシュボードを構築します。 React を使用します。

コードの生成に使用するツールを変更する必要はありません。

ステップ 2: チームがアクセスできる場所に結果を置く

エージェントを AgentGrid に接続し、次のように尋ねます。

このダッシュボードをアプリとして AgentGrid に配置します。アーティファクトのリンクを教えてください。非公開にしておいてください。

AgentGrid は、アプリを独自の URL とバージョン履歴を持つアーティファクトとして保存します。

独立して接続できるコーディング エージェントを使用している場合は、次の手順に従ってください。 AgentGrid 接続手順。 Claude や ChatGPT などのブラウザベースのアシスタントは、サポートされている統合を使用します。

重要な部分は、エージェントがアクセス許可を持つワークスペースにアーティファクトを作成することです。

ステップ 3: チームメイトにアクセス権を与える

アーティファクトを開いて、そのリンクをコピーします。

送信する前に、チームメイトがワークスペースにアクセスできることを確認してください。プライベート アーティファクト URL によって作品が識別されます。それ自体が許可を与えるわけではありません。

内部コラボレーションの場合、通常はそれが望ましいことです。チームメイトは、公開せずに作業をレビューできます。

参照 アーティファクトの共有の仕組み。

ステップ 4: 実際の結果に関するフィードバックを収集する

チームメイトがダッシュボードを開いて、日付フィルターが期待どおりに動作していないことに気づきました。

どのコンポーネントが壊れているかを説明する個別の Slack メッセージを記述する代わりに、アーティファクトの関連部分にフィードバックを添付して残すことができます。

AgentGrid は、アプリ要素とドキュメントの一節に対するレビュー コメントをサポートします。権限のある担当者とエージェントは、これらのコメントを共同で処理できます。

これにより、議論がレビュー対象に近づくことができます。

ステップ 5: エージェントに作業を続行させます

これで、接続されているエージェントに次のように伝えることができます。

この AgentGrid アーティファクトを開き、日付フィルターを修正します。既存のレイアウトを保持し、同じ成果物を更新します。

実際のアーティファクトの URL を含めます。

エージェントは、必要なアクセス権と機能がある場合、アーティファクトを検査して更新できます。

変更は、変更を行ったエージェントに起因して、同じバージョン履歴に表示されます。チームメイトは同じ成果物に戻って結果を確認できます。

参照 AgentGrid のバージョン履歴。

Claude、ChatGPT、Cursor、Codex はどうでしょうか?

一部の AI ツールには、便利なネイティブ共有機能がすでに備わっています。

Claude は、エコシステム内でサポートされているアーティファクトを共有できます。 GitHub はコードをレビューするのに最適です。開発プラットフォームはプレビュー展開を提供できます。

何かを共有するためだけにこれらのワークフローを置き換える必要はありません。

AgentGrid は、次のステップに関連する場合に役立ちます。 同じ成果物に取り組んでいる人々とエージェント、特にさまざまな AI ツール間で。

たとえば、チームは Claude を使用してインターフェイスのドラフトを作成し、Codex を使用してその動作を調整し、人間のレビュー担当者がフィードバックを残すことができます。

共有成果物は、その作業の共通の宛先を提供します。

代わりにいつ公開すべきでしょうか?

作品がワークスペース外の人々 (公開デモを必要とするクライアントなど) を対象としている場合は、公開することをお勧めします。

AgentGrid は、サポートされているアプリと Markdown アーティファクトをパブリック URL に公開できます。

ただし、共有と公開は同じアクションではありません。

プライベート アーティファクト リンクには、承認されたワークスペース アクセスが必要です。公開されたデプロイメントはパブリックにアクセスできます。アーティファクトに対する後からの変更は、公開ページに表示される前に再度公開する必要があります。

それが意図している場合にのみ公開してください。

エージェントが終了したときに尋ねる方が良い質問です

すべてのコーディング セッションを「ファイルをエクスポート」して終了するのではなく、次のように尋ねます。

次にこれを必要とするのは誰ですか?そして、それをどうする必要があるのでしょうか?

開発者がコードをマージする必要がある場合は、プル リクエストを作成します。

誰かがアプリをテストする必要がある場合は、動作するプレビューを提供してください。

ユーザーとエージェントが一緒に作業を確認して継続する必要がある場合は、共有ホームを提供します。

AI コーディング セッションの出力がワークフローの最後である必要はありません。それは他のすべての人にとっての出発点になる可能性があります。

👉 AgentGrid を探索します。