メインコンテンツへスキップ
タスクが明確であれば、エージェントの回り道が減り、作業を止めてあなたに確認する回数も少なくなります。以下のヒントは、ほとんどのセッションに当てはまります。

目標、範囲、完了の条件を示す

何を達成するか、どこを変更するか、何をもって完了とするかをエージェントに伝えます。次の 2 つを比べてみてください。
  • 「ログインページを直してください。」
  • 「Safari でログインページの入力欄がずれている問題を修正してください。変更はログインページのスタイルだけにして、他のページには手を加えないでください。完了したら既存のテストを実行し、Safari を対象とするテストを追加してください。」
2 つ目は、目標、範囲、結果の検証方法を示しています。エージェントは推測する必要がなく、どの時点で作業を止めてあなたに戻せばよいかがわかります。

関連するファイルとリンクを提供する

  • 最初に適切なプロジェクトを選択 して、エージェントが正しいコードと環境で作業できるようにします。
  • 関連するファイル、フォルダー、エラーメッセージ、ドキュメントのリンクをタスクに明記します。
  • UI の問題では、スクリーンショットを添付するか、入力欄の Take a screenshot を使います。ログやデザインファイルなどは添付ファイルとして送信します。セッションを開始する を参照してください。
  • エージェントが必要とするシークレットは、あらかじめプロジェクトのシークレットと環境変数に保存しておくと、エージェントが作業を止めて確認する必要がなくなります。プロジェクトと環境構築 を参照してください。

大きなタスクを分割する

1 つのセッションは、通常 1 つのことに集中させると最も効果的です。大きな依頼は複数のセッションに分けます。たとえば、まずエージェントに選択肢を調査させ、その結果をもとに実装を始めます。
  • タスクの各部分が独立している場合は、どの部分を並行して進められるかを伝えます。複雑なタスクでは、エージェントが サブエージェント を起動して同時に作業させ、すべて完了した後に結果を自動的にまとめます。
  • 別のアプローチを試すには、返信から新しいセッションを Fork します。元のセッションには影響しません。
  • エージェントの方向がずれた場合は、完了を待つ必要はありません。Steer を使ってすぐに修正するか、以前のメッセージを編集して再実行します。エージェントとの共同作業 を参照してください。

適切な権限を選ぶ

新しいセッションのデフォルトは Full access で、エージェントは手順ごとにあなたに確認しません。クラウドサーバー上でエージェントに自力で完了してほしいタスクに適しています。クラウドサーバー上のセッションが、あなたのコンピューターに触れることはありません。 次の場合は、Ask for approval または Approve for me に切り替えてください。
  • セッションが自分のコンピューター上で実行され、重要なファイルやシステム設定に関わる場合。
  • エージェントに自由に使わせたくないシークレットがプロジェクトにある場合。Full access では、エージェントはプロジェクト内のすべてのシークレットを読み取れます。
  • タスクが外部のサービスや Web サイトに接続し、エージェントが操作する前に確認したい場合。

繰り返しの作業にはスケジュールタスクを使う

「平日の毎朝 9 時に依存関係の更新を確認する」のように定期的に行う必要がある作業は、セッションでエージェントに普段の言葉で伝えます。エージェントがスケジュールタスクの下書きを作成し、Create をクリックした後にのみ有効になります。「30 分後にもう一度デプロイを確認する」のように現在のセッションに関連するフォローアップは、エージェントにセッションタイマーの設定を依頼します。スケジュールタスクはクラウドサーバー上で実行され、コンピューターの電源が切れていても実行され続けます。スケジュールタスク を参照してください。

エージェントに PR を作成させる

変更が完了したら、セッションでエージェントにコミット、プッシュ、または PR の作成を依頼します。例:「テストが通ったら、修正内容がわかるタイトルで PR を作成してください。」デフォルトの動作は、プロジェクト設定の Ship behavior に従います。PR の作成、ブランチのプッシュ、または自分で書いたプロンプトに従ったコミットのいずれかです。リンクされたリモートリポジトリがないアップロード済みのプロジェクトでは、変更はパッチとして納品されます。変更の確認と結果の納品については 結果の確認と納品 を参照してください。