失敗中の CI ビルドを自動修正

手動でのセットアップが面倒ですか？このページのリンクを Devin のセッションに貼り付けて、すべてのセットアップを依頼してください。

Store your Devin API key in GitHub

The workflow calls Devin’s v3 API to create sessions programmatically. Create a service user and store its token as a GitHub Actions secret:

Go to app.devin.ai > Settings > Service Users and create a service user with ManageOrgSessions permission
Copy the API token shown after creation — it’s only displayed once
In your GitHub repo, navigate to Settings > Secrets and variables > Actions
Add two secrets: DEVIN_API_KEY (the token) and DEVIN_ORG_ID (your organization ID — get it by calling GET https://api.devin.ai/v3/enterprise/organizations with your token)

Devin がリポジトリをクローン、ビルド、プッシュできるように、リポジトリがすでに Devin の Machine でセットアップ済みであることを確認してください。

ワークフローファイルを追加する

Create .github/workflows/devin-ci-fix.yml. This workflow fires whenever your existing CI workflow completes with a failure, extracts the failing job names, and calls the Devin API to start a fix session:

name: Auto-fix CI with Devin

on:
  workflow_run:
    workflows: ["CI"]
    types: [completed]

jobs:
  trigger-devin-fix:
    if: >
      github.event.workflow_run.conclusion == 'failure' &&
      github.event.workflow_run.pull_requests[0]
    runs-on: ubuntu-latest
    steps:
      - name: Get failure details
        id: failure
        uses: actions/github-script@v7
        with:
          script: |
            const run = context.payload.workflow_run;
            const pr = run.pull_requests[0];
            const jobs = await github.rest.actions.listJobsForWorkflowRun({
              owner: context.repo.owner,
              repo: context.repo.repo,
              run_id: run.id
            });
            const failed = jobs.data.jobs
              .filter(j => j.conclusion === 'failure')
              .map(j => j.name);
            core.setOutput('pr_number', pr.number);
            core.setOutput('branch', pr.head.ref);
            core.setOutput('failed_jobs', failed.join(', '));
            core.setOutput('run_url', run.html_url);

      - name: Trigger Devin session
        run: |
          curl -s -X POST "https://api.devin.ai/v3/organizations/${{ secrets.DEVIN_ORG_ID }}/sessions" \
            -H "Authorization: Bearer ${{ secrets.DEVIN_API_KEY }}" \
            -H "Content-Type: application/json" \
            -d "{
              \"prompt\": \"CI failed on PR #${{ steps.failure.outputs.pr_number }} in ${{ github.repository }}. Failed jobs: ${{ steps.failure.outputs.failed_jobs }}. Run: ${{ steps.failure.outputs.run_url }}. Branch: ${{ steps.failure.outputs.branch }}. Read the CI logs, identify the root cause, and push a fix to the branch.\"
            }"

Replace "CI" in the workflows array with the exact name: from your existing CI workflow file (e.g., "Tests", "Build & Test").Use the tags field in the request body (e.g., "tags": ["ci-fix", "pr-312"]) to track which CI failures have already triggered sessions and avoid duplicates.

What happens when CI fails

PR の CI 実行が失敗すると、Action が失敗の詳細を抽出し、セッションプロンプトとして Devin に渡します。以下は、典型的な自動修正のフローです。

CI ログを読み取る — Devin が実行 URL を開き、失敗したジョブのエラー出力、スタックトレース、テスト結果を解析します
エラーをコードまでたどる — PR ブランチ上の関連するファイルと行 (例: UserList.tsx:34) を特定し、その周辺コードと直近の差分を読み取ります
修正をプッシュする — 狙いを絞った変更を PR ブランチに直接コミットし、これにより CI が自動的に再トリガーされます
PR にコメントする — root cause と変更内容を説明する要約を投稿します

Devin による PR コメントの例:

CI failure in test-unit — fixed

Root cause: `UserList.tsx:34` calls `.map()` on `props.users`, which is
undefined when the API returns an empty response body instead of `[]`.

Fix: Added a fallback — `const users = props.users ?? [];`
Added a test case for the empty-response scenario.
All 312 tests passing.

対象を適切な失敗に絞る

すべての CI の失敗が自動修正の恩恵を受けられるわけではありません。インフラのタイムアウトや Docker ビルドの問題は、コード変更では解決できません。関連するジョブの失敗のときにだけ Devin がトリガーされるよう、条件を追加してください。

      - name: Trigger Devin session
        if: >
          contains(steps.failure.outputs.failed_jobs, 'test') ||
          contains(steps.failure.outputs.failed_jobs, 'lint') ||
          contains(steps.failure.outputs.failed_jobs, 'typecheck')
        run: |
          curl -s -X POST "https://api.devin.ai/v3/organizations/${{ secrets.DEVIN_ORG_ID }}/sessions" \
          ...

修正はレビューしやすい状態に保つ

Devin は修正コミットをプッシュしますが、PR をマージする前には引き続き人間によるレビューが必要です。自動修正はコードレビューの代替ではなく、開発者にとってのたたき台として扱ってください。Devin が失敗を解決できない場合は、PR 上にコメントして判明した内容を説明し、エンジニアがそこから引き継げるようにします。

Documentation Index

修正はレビューしやすい状態に保つ