✍️ 필사 모드: Issueからデプロイまで — AIがレビューしCI/CDが検証・デプロイする自動化パイプラインを作る (2025)

 ┌────────────────────────────────────────────────────────────────┐
 │                                                                │
 │  [S1] Issue ──ai-readyラベル──▶ AIエージェント ──▶ Draft PR    │
 │         ▲                                         │            │
 │         │                                         ▼            │
 │         │                              [S2] AIコードレビュー   │
 │         │                                  (生成≠レビュー)     │
 │         │                                         │            │
 │         │                                         ▼            │
 │         │                              [S3] CI検証ゲート       │
 │         │                          lint·type·test·build·E2E    │
 │         │                                         │            │
 │         │                          ┌── 失敗 ──────┤            │
 │         │                          ▼              ▼ 通過       │
 │         │                   AI自己修正      [S4] Human Gate    │
 │         │                   (ログを読み再push)  マージ決定      │
 │         │                                         │            │
 │         │                                         ▼            │
 │         │                              [S5] CD: Preview        │
 │         │                              → Canary → Production    │
 │         │                                         │            │
 │         │                                         ▼            │
 │         │                              [S6] 自動検証           │
 │         │                          smoke·E2E·SLOゲート         │
 │         │                                         │            │
 │         │                          ┌── 失敗 ──────┤            │
 │         │                          ▼              ▼ 通過       │
 │         └──── 自動Issue生成 ◀─ [S7] モニタリング & フィードバック │
 │              (自動rollback + 事象化)  デプロイ後観測、rollbackトリガー │
 │                                                                │
 └────────────────────────────────────────────────────────────────┘

# 同じissueにPRがすでにあれば新規に作らない
- name: Check existing PR
  id: check
  run: |
    EXISTING=$(gh pr list --search "in:title #${{ github.event.issue.number }}" --json number --jq 'length')
    echo "exists=$EXISTING" >> "$GITHUB_OUTPUT"

- name: Run agent
  if: steps.check.outputs.exists == '0'
  uses: anthropics/claude-code-action@v1
  # ...

生成エージェント (Claude/Copilot) ──▶ PR
                                     │
レビューエージェント (別モデル/ツール) ──▶ レビューコメント
                                     │
人間 ────────────────────────────▶ 最終決定

name: AI Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review]

jobs:
  ai-review:
    # draftでないときだけ — 作業中のPRはレビューしない
    if: github.event.pull_request.draft == false
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            このPRをレビューせよ。次に集中:
            - 正確性: ロジックのバグ、エッジケース、漏れたエラー処理
            - セキュリティ: 入力検証、シークレット、権限
            - テスト: 変更に対するカバレッジが十分か
            - コンベンション: CLAUDE.md に従っているか

            問題は該当する行にインラインコメントで残せ。
            最後にサマリーとともに APPROVE または REQUEST_CHANGES を明示せよ。
            些細なスタイルは nit: で表示し、人間が無視できるようにせよ。

速い ──────────────────────────────────▶ 遅い
lint → typecheck → unit test → build → integration → E2E
  │        │           │          │         │          │
 秒単位   秒単位     秒〜分       分        分         分〜十分

PR push ──▶ CI実行 ──▶ 失敗
                        │
                        ▼
            エージェントがCIログを読む
                        │
                        ▼
            原因把握 → 修正コミットをpush
                        │
                        ▼
                   CI再実行 ──▶ 通過

# CI失敗時にエージェントへログを渡し修正を試みる — ただしラベルで回数制限
- name: Self-heal on CI failure
  if: failure() && !contains(github.event.pull_request.labels.*.name, 'ai-heal-exhausted')
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: |
      CIが失敗した。下のログを読み、原因を直してコミットせよ。
      推測せず、ログが指し示すものだけを直せ。

Settings → Branches → main 保護ルール:
  ✅ Require status checks: ci/lint, ci/test, ci/build, ai-review
  ✅ Require branches to be up to date before merging
  ✅ Require a pull request before merging
  ✅ Require approvals: 1+ (S4 人間ゲート)
  ✅ Dismiss stale approvals when new commits pushed
  ✅ Do not allow bypassing the above

# 依存PRでCI通過 + AIレビューAPPROVEなら自動マージ有効化
- name: Enable auto-merge for safe deps
  if: |
    contains(github.event.pull_request.labels.*.name, 'dependencies') &&
    github.event.pull_request.user.login == 'dependabot[bot]'
  run: gh pr merge --auto --squash "${{ github.event.pull_request.number }}"

main マージ
   │
   ▼
Canaryデプロイ (トラフィック5%)
   │
   ▼  [S6 自動検証]
smoke test + SLO観測 (5〜15分)
   │
   ├── 失敗 ──▶ 自動rollback (Canary除去)
   │
   ▼ 通過
Production昇格 (トラフィック100%)

name: Deploy
on:
  pull_request:
    types: [closed]
    branches: [main]

jobs:
  deploy-canary:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    environment: canary          # 保護ルール: なし (自動)
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh canary

  promote-production:
    needs: [deploy-canary, verify-canary]
    runs-on: ubuntu-latest
    environment: production      # 保護ルール: required reviewers = 人間ゲート
    steps:
      - run: ./scripts/deploy.sh production

  verify-canary:
    needs: deploy-canary
    runs-on: ubuntu-latest
    outputs:
      verdict: ${{ steps.gate.outputs.verdict }}
    steps:
      - name: Smoke test
        run: ./scripts/smoke-test.sh https://canary.example.com

      - name: Observe SLO for 10 minutes
        id: gate
        run: |
          sleep 600
          ERROR_RATE=$(curl -s "$METRICS_API/error-rate?env=canary&window=10m")
          P99=$(curl -s "$METRICS_API/latency-p99?env=canary&window=10m")
          # エラー率1%超過またはp99 500ms超過ならfail
          if (( $(echo "$ERROR_RATE > 0.01" | bc -l) )); then
            echo "verdict=rollback" >> "$GITHUB_OUTPUT"; exit 1
          fi
          echo "verdict=promote" >> "$GITHUB_OUTPUT"

  rollback-canary:
    needs: verify-canary
    if: failure()
    runs-on: ubuntu-latest
    steps:
      - run: ./scripts/rollback.sh canary

name: Monitor & Auto-Rollback
on:
  schedule:
    - cron: '*/5 * * * *'      # 5分ごとにSLOチェック
  workflow_run:
    workflows: ["Deploy"]
    types: [completed]

jobs:
  slo-check:
    runs-on: ubuntu-latest
    steps:
      - name: Check production SLO
        id: slo
        run: |
          BURN=$(curl -s "$METRICS_API/error-budget-burn?env=prod&window=1h")
          echo "burn=$BURN" >> "$GITHUB_OUTPUT"

      - name: Rollback + file issue if breaching
        if: ${{ steps.slo.outputs.burn > 2.0 }}
        run: |
          ./scripts/rollback.sh production
          gh issue create \
            --title "Auto-rollback: error budget burn rate ${{ steps.slo.outputs.burn }}" \
            --label "ai-ready,incident,priority-high" \
            --body "プロダクションSLO違反で自動rollbackした。
            最後のデプロイ: ${{ github.sha }}
            burn rate: ${{ steps.slo.outputs.burn }}
            エージェントはrollbackされたコミットのdiffを分析し原因を診断し、
            修正PRを提出せよ。"

   Issue ──▶ PR ──▶ レビュー ──▶ CI ──▶ マージ ──▶ デプロイ ──▶ 検証 ──▶ モニター
     ▲                                                            │
     └──────────────── 事象が新しいIssueへ ◀───────────────────────┘

issue.labeled('ai-ready')  ──▶ ai-resolve.yml ──▶ (PR生成)
                                                       │
pull_request.opened ◀──────────────────────────────────┘
   ├──▶ ai-review.yml   (AIレビュー → チェック報告)
   └──▶ ci.yml          (検証 → チェック報告)
                                                       │
   [ブランチ保護: すべてのチェック + 人間承認待ち]      │
                                                       ▼
pull_request.closed(merged) ──▶ deploy.yml ──▶ (Canary → 検証 → Production)
                                                       │
workflow_run('Deploy' completed) ──▶ monitor.yml       │
schedule('*/5')                  ──▶ monitor.yml ◀─────┘
   └──▶ SLO違反時: rollback + issue.create('ai-ready')
                                          │
                                          └──▶ (再びai-resolve.yml — ループ完成)

name: AI Resolve
on:
  issues:
    types: [labeled]

jobs:
  resolve:
    if: github.event.label.name == 'ai-ready'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Skip if PR already exists
        id: dedup
        run: |
          N=$(gh pr list --search "#${{ github.event.issue.number }} in:body" --json number --jq 'length')
          echo "exists=$N" >> "$GITHUB_OUTPUT"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Run agent
        if: steps.dedup.outputs.exists == '0'
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            Issue #${{ github.event.issue.number }}: ${{ github.event.issue.title }}

            ${{ github.event.issue.body }}

            このissueを実装せよ。ブランチを作り、変更し、テストを通し、
            "Closes #${{ github.event.issue.number }}" を含む Draft PR を開け。
            CLAUDE.md コンベンションに従い、PR本文に何を・なぜしたかを要約せよ。

name: CI
on:
  pull_request:
    types: [opened, synchronize, ready_for_review]

concurrency:
  group: ci-${{ github.event.pull_request.number }}
  cancel-in-progress: true     # 新しいpush時に以前の実行をキャンセル — コスト削減

jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: pnpm
      - run: pnpm install --frozen-lockfile
      - run: pnpm lint        # 速いものから先に
      - run: pnpm typecheck
      - run: pnpm test
      - run: pnpm build

name: Deploy
on:
  pull_request:
    types: [closed]
    branches: [main]

jobs:
  canary:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    environment: canary
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh canary

  verify:
    needs: canary
    runs-on: ubuntu-latest
    steps:
      - run: ./scripts/smoke-test.sh https://canary.example.com
      - run: ./scripts/observe-slo.sh canary 600   # 10分観測

  production:
    needs: verify
    runs-on: ubuntu-latest
    environment: production       # required reviewers = Human Gate
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh production

  rollback:
    needs: [canary, verify]
    if: failure()
    runs-on: ubuntu-latest
    steps:
      - run: ./scripts/rollback.sh canary