最初のセッションを開始する前に、リポジトリをインデックス化し、セットアップしていることを確認してください。これらは、Devin があなたのコードベースを理解し、扱えるようにするための基盤となる手順です。 すでにタスク範囲が完全に定義されたプランがある場合を除き、まずは Ask モードで Devin と一緒にプランを作成し、その後 Agent モードに切り替えて実行することをおすすめします。
- コードの動作について質問する
- アーキテクチャや依存関係を把握する
- 実装前にタスクを計画し、スコープを定義する
- Agent セッション向けの、十分なコンテキストを含むプロンプトを生成する
Ask モードはメインページまたは DeepWiki ページから起動できます。
メインページから Ask モードを使う場合は、Ask モードに切り替えて、質問したいリポジトリを選択します。
DeepWiki ページから Ask モードを使う場合は、ページ下部のチャット入力欄に質問内容を入力し、Ask をクリックします。これにより、Devin が参照する情報の範囲がそのリポジトリに自動的に限定されます。
詳しくは Ask Devin ガイド を参照してください。
Devin と一緒に問題を理解してプランを作成できたら、Agent モードに進む準備が整っています。
エージェントモードは、Devin が完全に自律的に動作し、コードの記述、コマンドの実行、Web の閲覧、複雑なタスクのエンドツーエンドでの完了まで行えるモードです。次のようなことを行いたいときにエージェントモードを使用します:
- 機能を実装したりバグを修正するとき
- Pull Request を作成するとき
- テストを実行して問題をデバッグするとき
- コード変更を伴う複数ステップのタスクを実行するとき
Agent モードは、メインページまたは Ask Devin セッションから起動できます。
タスクのスコープが明確でない場合は、次の進め方をおすすめします。
- まずは Ask モード でタスクの計画を立てる
- Ask セッションの内容を基にスコープされた計画を作成するために、Devin プロンプトを作成する
- Send to Devin をクリックして Agent モードに移行し、タスクを実行する
このフローは次のとおりです。
メインページから Agent モードを使う場合は、トグルで Agent モードに切り替え、作業対象とするリポジトリを選択します。
Agent セッションを開始する際には、いくつかのオプションを設定します。具体的には、Repository の選択と Agent の選択です。
Devin に作業させたいリポジトリを選択します。リポジトリセレクターをクリックすると、Devin のマシンに追加された すべてのリポジトリが表示されます。
リポジトリを選択すると、Devin は次のことができるようになります：
- コードベースにアクセスして変更を加えられる
- 正しいブランチを開始点として使用できる
- 適切なリポジトリに対してプルリクエストを作成できる
セッションでDevinが使用するエージェント構成を選択できます。エージェントによって機能が異なったり、特定の種類のタスク向けに最適化されていたりします。
現在、多くのタスクに適したデフォルトのエージェントと、データ分析タスク向けに最適化されたデータアナリストエージェントのDanaが利用できます。
どのエージェントを使うか迷う場合は、ほとんどのタスクで問題なく使えるデフォルトのエージェントを選択してください。
@ メンションを使用すると、ファイル、リポジトリ、その他のリソースに関する特定のコンテキストを Devin に付与できます。チャット入力欄で @ を入力すると、使用可能なメンションの一覧がドロップダウンで表示されます：
- @Repos - 特定のリポジトリを参照する
- @Files - コードベース内の特定のファイルを参照する
- @Macros - Knowledge エントリ用のマクロを参照する
- @Playbooks - チームまたはコミュニティのプレイブックを参照する。これは、Devin の振る舞いをガイドするために使用できる詳細なプロンプトテンプレートです。
- @Secrets - Devin のセッションマネージャから特定のシークレット（例：APIキー、認証情報など）を参照する
@メンションを使用することで、Devin はあなたが扱っている対象をより正確に理解し、プロンプトのあいまいさを減らすことができます。
まずは、成功条件が明確で、かつ Devin に必要なコンテキストを十分に渡せるタスク から始めてください。チームメイトに仕事を引き継ぐときと同じ要領です。慣れてきたら、徐々により複雑なタスクにも挑戦してみましょう。ユーザーは、ちょっとしたバグ修正から、特定箇所のリファクタリング、大規模なマイグレーション、ゼロからの機能開発まで、さまざまな作業で Devin を活用しています。
目安として、自分でやって3時間以内に終わるタスクであれば、Devin が対応できる可能性が高いです。より大きなプロジェクトは、目的を絞ったセッションに分割し、バッチセッションを使って並行して実行してください。
クイック PR を作成する（このプロンプトは Playbook での使用を推奨します）
