デベロッパーフロー

デベロッパーフローは、イシューとマージリクエスト全体で、より効率的に作業するのに役立ちます。デベロッパーフローは次の目的で使用できます:

• イシューからドラフトマージリクエストを作成する。
• レビューフィードバックに基づき、既存のマージリクエストに対してイテレーションを行う。
• 実装方法を調査し、調査結果をディスカッションに投稿する。
• 大規模なマージリクエストを、焦点を絞った小さなマージリクエストに分割する。
• マージコンフリクトを解決する。

前提条件

• GitLab Duo Agent Platformの前提条件を満たしていること。
• トップレベルグループで、基本フローを許可とデベロッパーを有効にしていること。
• プロジェクトのデベロッパー、メンテナー、またはオーナーロールを持っている。
• サービスアカウントを許可するようにプッシュルールを設定していること。
• プロジェクトで独自のRunnerを設定しているか、GitLabホストRunnerを有効にしていること。

プロジェクトをセットアップする

デベロッパーフローがより良い結果を出せるようにするため、プロジェクトで次のオプション設定を行うことをおすすめします:

• AGENTS.mdファイルを追加する: テストコマンド、Lintルール、コミット形式、コードパターンなど、プロジェクトの規約を文書化する。デベロッパーフローは、リポジトリで作業する際に、このファイルをコンテキストとして使用します。詳細については、AGENTS.mdカスタマイズファイルを参照してください。
• 実行環境を設定する: プロジェクトで特定のツール（Go、Python、Node.jsなど）が必要な場合は、agent-config.ymlファイルでエージェント環境を設定します。環境が適切に設定されていると、デベロッパーフローはコミットする前にテストを実行し、自身の変更を検証できます。詳細については、フロー実行を設定するを参照してください。

フローを使用する

前提条件:

• デベロッパーフローのトリガーで、イベントタイプメンションと割り当てが設定されていること。

ディスカッションでDuo Developerにメンションする

コメントをデベロッパーフローの実行可能なタスクにするには、コメントで@duo-developer-<namespace>をメンションします。<namespace>は、GitLabのネームスペースパス（gitlab-orgなど）に置き換えます。

イシューまたはマージリクエストの内容と提供したコンテキストの量に応じて、フローは次のタスクを実行できます:

• コードの変更
• マージリクエストとイシューの作成
• 実装アプローチの調査とそれに応じたレポートまたは更新の報告

例:

@duo-developer-<namespace> research approaches for implementing pagination
on the /users endpoint, then create a draft MR with the most
promising approach.

デベロッパーフローは、自身のセッションへのリンクを返信します。

または、進捗状況を監視するには、左側のサイドバーでAI > セッションを選択します。

イシューからマージリクエストを生成する

イシューからマージリクエストを作成するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 左側のサイドバーで、計画 > 作業アイテムを選択し、次にタイプ = イシューでフィルタリングします。
3. マージリクエストを作成するイシューを選択します。
4. イシューからマージリクエストを作成するには、次のいずれかを行います:
   • Duo Developerサービスアカウントをイシューに割り当てます:
     1. 右側のサイドバーの担当者セクションで、編集を選択します。
     2. duo developerと入力し、検索結果から選択します。
   • イシューヘッダーの下にある作業アイテムを実装を選択します。
5. 進捗状況を監視するには、左側のサイドバーでAI > セッションを選択します。
6. セッションが完了したら、イシューのアクティビティセクションにあるリンクからマージリクエストをレビューします。

Agentic Chatでフローを使用する

デベロッパーフローをGitLab Duo Agentic Chatの会話で使用して、次のようなさまざまなタスクを完了できます:

• コーディング目標を達成します。この目標に関連付けられたイシューは必要ありません。
• イシューをマージリクエストを開いて解決する。

Agentic Chatの会話でフローを使用するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

2. GitLab Duoサイドバーで、新規または既存のAgentic Chatの会話を開き、

3. Agentic Chatにデベロッパーフローを使用してタスクを達成するように依頼します。

   フローの進行状況はチャット会話に表示されます。詳細については、以下を実行できます:

   • 会話でエージェントセッションを表示を選択する。
   • 左側のサイドバーで、AI > セッションを選択します。

ベストプラクティス

明確なコンテキストを提供する

デベロッパーフローは、ユーザーが伝える情報、またはイシュー、マージリクエスト、チャット会話、ディスカッションスレッドのコンテキストで利用可能な情報のみを認識します。人間の共同作業者が効率的に作業できるようにするための手法は、ここでも同じように当てはまります:

• 関連ファイルやディスカッションへのリンクを含め、問題の説明を明確に記述する。
• 何をもって「完了」とするかを定義する受け入れ条件を含める。
• 正確なファイルパスがわかっている場合は指定する。
• 一貫性を保つため、既存パターンのコード例を含める。

ディスカッションでDuo Developerにメンションする際は明示的に指示する

ディスカッションでDuo Developerにメンションする際は、何を実行してほしいのかを正確に伝えます。例:

• 「/api/usersエンドポイントのページネーションを実装するドラフトマージリクエストを作成してください。」
• 「このマージリクエストのレビューフィードバックに対応してください。」
• 「ログの生成に関する変更を別のマージリクエストに分割してください。」
• 「このサービスをgRPCに移行する方法を調査し、調査結果をここに投稿してください。」
• 「このマージリクエストにはマージコンフリクトがあります。解決してください。」

明確な指示がない場合、フローは独自の方法を選択するため、期待した結果が得られない可能性があります。

タスクの焦点を絞る

複雑なタスクは、より小さく、スコープが絞られた、アクション指向のリクエストに分割してください。大規模で自由度の高いタスクは、イテレーションの上限に達しやすくなります。

例

マージリクエストを生成するためのイシュー

この例は、デベロッパーフローがマージリクエストを生成するために使用できる、適切に作成されたイシューを示しています。

## Description
The users endpoint currently returns all users at once,
which will cause performance issues as the user base grows.
Implement cursor-based pagination for the `/api/users` endpoint
to handle large datasets efficiently.

## Implementation plan
Add pagination to GET /users API endpoint.
Include pagination metadata in /users API response (per_page, page).
Add query parameters for per page size limit (default 5, max 20).

#### Files to modify
- `src/api/users.py` - Add pagination parameters and logic.
- `src/models/user.py` - Add pagination query method.
- `tests/api/test_users_api.py` - Add pagination tests.

## Acceptance criteria
- Accepts page and per_page query parameters (default: page=5, per_page=10).
- Limits per_page to a maximum of 20 users.
- Maintains existing response format for user objects in data array.

マージリクエストのレビューフィードバックに対してイテレーションを行う

マージリクエストをレビューした後、デベロッパーフローにメンションしてフィードバックに対応させることができます。たとえば、特定の行に対するレビューコメントで、次のように記述します:

@duo-developer-<namespace> move this validation logic into the `BaseService` class
in `app/services/base_service.rb` instead of duplicating it here.

また、レビュー全体を送信した後、デベロッパーフローにメンションして、すべての未解決スレッドに対応させることもできます:

@duo-developer-<namespace> please address the review feedback on this MR.

マージリクエストを分割する

マージリクエストが大きくなりすぎた場合は、その一部を別のマージリクエストとして抽出するようにデベロッパーフローに依頼できます:

@duo-developer-<namespace> the logging changes in this MR are out of scope.
Split them into a separate MR.

実装方法を調査する

変更を加える前に、問題を調査して報告するようにデベロッパーフローに依頼できます:

@duo-developer-<namespace> research whether the `PUT /api/users` endpoint also needs
rate limiting like we added to the `POST /api/users` endpoint.
Post your findings here.

Agentic Chatでデベロッパーフローを使用する

デベロッパーフローをAgentic Chatの会話で使用して、さまざまなタスクを完了できます:

• コーディング目標を達成するには、以下を入力します:
  • Use the developer flow to resolve this code review feedback.
  • Use the developer flow to update this dependency.
• イシューをマージリクエストを開いて解決するには、以下を入力します:
  • Resolve this issue.
  • Open a merge request to resolve this issue.