powered by TechFeed
表示モード
Deep Dive

GitLabがコードレビューとパイプライン修正をエージェントに委譲する仕組みを解説 — ローカルAIとクラウド側処理を分担するGitLab Duo Agent Platform連携の全容

11月18日、GitLabが「Agentic engineering with GitLab and your local agent: A walkthrough」と題した記事を公開した。Claude CodeなどのローカルエージェントとGitLab Duo Agent Platformを連携させ、コードレビューやパイプライン修正などの開発ワークフローを自動化する具体的な手順を紹介している。

11月18日、GitLabが「Agentic engineering with GitLab and your local agent: A walkthrough」と題した記事を公開した。Claude CodeなどのローカルエージェントとGitLab Duo Agent Platformを連携させ、コードレビューやパイプライン修正などの開発ワークフローを自動化する具体的な手順を紹介している。


GitLab Duo Agent Platformとは

GitLab Duo Agent Platformは、GitLabが提供するAIエージェント基盤で、MRレビュー・CI/CDパイプライン修復・セキュリティ脆弱性トリアージといった繰り返し作業をGitLab側のCIジョブとして実行できる。ローカルのAIツール(Claude Code、Cursor、Codexなど)はコーディング・指示出しを担い、リポジトリ全体のスキャンや長時間処理はGitLab側に委譲する役割分担が特徴だ。

GitHub Copilot Workspaceなどの競合サービスと比べた場合、GitLab Duo Agent Platformはローカルエージェントとクラウド側エージェントを明確に分離した二層構成を採用している点が特徴的だ。ローカルマシンを占有せずに重い処理を流せるため、開発者は手元の作業を継続しながらバックグラウンドでMR生成・レビュー・パイプライン修復を進められる。※編集部の考察


何を実現するのか

ローカルの開発環境をGitLab Duo Agent Platformに接続し、以下の作業をエージェントに委譲できる。

  • イシューを拾ってマージリクエスト(MR)を作成
  • MRの自動コードレビューと指摘への対応
  • マージコンフリクトの解消
  • 失敗したパイプラインの自動修復
  • セキュリティ脆弱性のトリアージと修正(GitLab Ultimate限定)

記事ではClaude Codeを中心に解説しているが、Duo CLIなど他のハーネスでも同じ流れが適用できる。


Part 1:セットアップはスキル1本で完結する

記事が最初に紹介するのがGitLab Duo setupスキルだ。これをClaude Codeにインストールし、/gitlab-duo-setupを実行するだけで、グループ全体の設定が自動化される。

git clone https://gitlab.com/gitlab-da/projects/agentic-eng-config.git
cp -R agentic-eng-config/skills/gitlab-duo-setup ~/.claude/skills/
cp -R agentic-eng-config/skills/gitlab-mr-followup ~/.claude/skills/

スキルが実行すること:

  1. GitLab Duo Agent Platformとフロー実行をグループ単位で有効化し、Code Reviewフロー、Duo Developerフロー、Fix CI/CD Pipelineフローを追加
  2. グループ全体に自動コードレビューを有効化
  3. CI/CDを持つ全プロジェクトに「パイプライン失敗時に自動修復を起動する」オートメーションを作成
  4. GitLab MCPサーバーをClaude Codeに追加し、ブラウザ認証を案内

変更内容はすべて実行前に一覧で提示され、個別に除外できる。二重実行しても安全(既存設定はスキップ)という設計も実用的だ。


gitlab-duo-setupスキルは実行前に変更計画を一覧で提示する


Part 2:4つのワークフロー

Use Case 1:イシューをDeveloperフローに渡す

Claude Codeに対して次のように入力する。

What issues are assigned to me in <group/project>? Summarize each in a line.

GitLab MCPサーバー経由で自分のアサインイシューを取得し、一覧を返す。イシューを選んだら:

Can you pick up Issue 1 and assign it to the Developer flow in GitLab?

処理はGitLab側のCIジョブとして走るため、ローカルマシンを占有しない。 生成されたMRは自分のアカウントに帰属し、通常のMRと同じレビューキューに入る。


Use Case 2:自動コードレビューとフィードバック対応

記事で最も具体的に解説されているのがこのユースケースだ。コードレビューという繰り返し頻度が高くかつ属人性の出やすい工程をエージェントに委譲できる点で、日常の開発フローへの組み込みやすさが際立っている。

MRをready状態にすると、GitLab Duo Code Reviewフローが自動的にレビュアーとして追加され、2段階でレビューを実施する。まず関連ファイル・テスト・依存関係を収集するプレスキャン、次にインラインコメント付きのレビュー本体だ。ベータ機能として、指摘なしの場合は自動承認、指摘ありは変更要求も設定できる。

レビューへの対応もClaude Code経由で行える:

Does MR 1 have feedback for me to review?

MCPサーバー経由でDuoのレビュースレッドを読み込み、要約する。さらに:

(Claudeへ)同意できる指摘を修正してスレッドをresolveしてほしい

Claudeがローカルで修正を加えてpushし、各スレッドにコメントを残す。Start a new review on pushを有効にしておくと、pushのたびに追加レビューが走り、修正が正しいか確認される。

レビュー設定の細かいチューニングには2つのファイルが使える:

  • mr-review-instructions.yaml:フォーカスエリア、コーディング規約、パス別ルール
  • .gitlab/duo/mr-review-automated-rules.yaml:依存パッケージの自動更新PRなど、レビュー対象から除外するMRの条件


GitLab Duo Code Reviewは自動でインラインフィードバックを残す。対応はGitLab UIからでもローカルからでも可能


Use Case 3:失敗したパイプラインを自動修復

セットアップスキルが各プロジェクトに作成するオートメーションが、パイプライン失敗を検知してFix CI/CD Pipelineフローを自動起動する。フローはエラーログを解析し、修正コミットを含むMRを生成してレビューキューに投入する。気づいたときには修正済みのMRが届いているという運用が想定されており、開発者がパイプライン失敗に気を取られる時間を削減できる。なお、自動修復の精度はパイプライン失敗の種類(テスト失敗・lint違反・設定ミスなど)によって異なる点は留意が必要だ。


Use Case 4:セキュリティ脆弱性の自動修正(Ultimate限定)

GitLab Ultimateのライセンスがある場合、セキュリティスキャンの結果を元に脆弱性のトリアージと修正を自動化するフローも利用できる。検出された脆弱性を重要度・対応可否に応じて仕分けし、修正可能なものはMRとして提出する流れだ。セットアップスキルの最後に「セキュリティのトリアージも有効にするか」を確認するステップがあり、グループ単位で有効化できる。


事前に必要なもの

  • GitLab.comのトップレベルグループ(Premium以上でクレジット付与あり)
  • パイプライン・オープンイシュー・MRが存在するプロジェクト
  • トップレベルグループのOwnerロール(Maintainerのみであればプロジェクト単位での設定に限定)
  • Claude CodeのインストールとGitLab CLI(glab)でのログイン済み環境

詳細はAgentic engineering with GitLab and your local agent: A walkthroughを参照していただきたい。