2026/01/28

MRごとに PHPStan + AIコードレビューを走らせ、reviewdogでコメントするCI構成

岡本 渉 技術ブログ

• 静的解析（PHPStan）で確実に拾える問題は機械に任せる
• 仕様の穴や設計の癖など、人が気づきにくい点はAIレビューで補助する
• どちらもMR上にコメントとして残し、レビュアーの視認性を高める

という構成を採用しました。本記事ではこの設定を汎用化し、GitLab CIでの構成例としてまとめます。

全体像（処理フロー）

構成要素

GitLab CIのサンプル

stages:
  - test
  - review

phpstan:
  stage: test
  image: php:8.4-alpine
  rules:
    - if: $CI_MERGE_REQUEST_ID
  allow_failure: true
  before_script:
    - apk add --no-cache curl git php84 php84-cli php84-phar php84-openssl php84-curl php84-zip php84-mbstring php84-ctype
    - php -r "copy('https://getcomposer.org/installer','composer-setup.php');"
    - php composer-setup.php --install-dir=/usr/local/bin --filename=composer
    - rm -f composer-setup.php
    - curl -sfL https://raw.githubusercontent.com/reviewdog/reviewdog/master/install.sh | sh -s -- -b /usr/local/bin
  script:
    - cd app
    - composer install --no-interaction --no-progress
    - ./vendor/bin/phpstan analyse --error-format=raw --no-progress --memory-limit=512M > phpstan-report.txt || PHPSTAN_EXIT=$?
    - reviewdog -f=phpstan -name="phpstan" -reporter=gitlab-mr-discussion -fail-on-error=false < phpstan-report.txt
    - exit ${PHPSTAN_EXIT:-0}

ai_code_review:
  stage: review
  image: python:3.11-alpine
  rules:
    - if: $CI_MERGE_REQUEST_ID
  allow_failure: true
  before_script:
    - apk add --no-cache git curl
    - pip install --no-cache-dir requests
    - curl -sfL https://raw.githubusercontent.com/reviewdog/reviewdog/master/install.sh | sh -s -- -b /usr/local/bin
    - git fetch origin ${CI_MERGE_REQUEST_TARGET_BRANCH_NAME:-main} || true
  script:
    - python3 bin/ai-code-review.py --model ${AI_REVIEW_MODEL:-} --max-files ${AI_REVIEW_MAX_FILES:-10} > ai-review-report.txt || AI_REVIEW_EXIT=$?
    - if [ -s ai-review-report.txt ]; then reviewdog -f=rdjsonl -name="ai-code-review" -reporter=gitlab-mr-discussion -fail-on-error=false < ai-review-report.txt; fi
    - exit ${AI_REVIEW_EXIT:-0}