Git Flow AI PR 리뷰 자동화 추가

[gaeng2y]

📝 Summary

Git Flow 브랜치 패턴에 맞는 PR이 생성되거나 Draft에서 Ready for review로 전환될 때 OpenAI 기반 AI 리뷰를 남기는 GitHub Actions workflow를 추가합니다.

🎯 Type of Change

• ✨ New feature (새로운 기능 추가)
• 🐛 Bug fix (버그 수정)
• 🔧 Configuration (설정 변경)
• ♻️ Refactoring (코드 리팩토링)
• 📝 Documentation (문서 수정)
• 🎨 UI/UX (디자인 변경)
• ⚡ Performance (성능 개선)
• 🛡️ Security (보안 강화)
• 🧪 Test (테스트 추가/수정)
• 🔨 Build (빌드 시스템 수정)

🔗 Related Issues

• Closes 리뷰 봇 추가 #225

📋 Changes Made

Added

• Git Flow 대상 PR에만 실행되는 AI PR Review GitHub Actions workflow 추가
• PR diff를 OpenAI Responses API로 리뷰하고 GITHUB_TOKEN으로 PR review comment를 남기는 자동화 추가
• OPENAI_API_KEY 미설정 시 workflow를 실패시키지 않고 skip하는 guard 추가

Changed

• Docs/delivery-workflow.md에 AI 리뷰 자동화의 대상 브랜치, secret, model variable 운영 기준 추가

Fixed

• 없음

Removed

• 없음

🔍 Technical Details

• 실행 조건은 opened, ready_for_review 이벤트로 제한했습니다.
• develop 대상 PR은 feature/*, bugfix/*, release/* head만 리뷰합니다.
• main 대상 PR은 develop, release/*, hotfix/* head만 리뷰합니다.
• synchronize 이벤트에서는 재리뷰하지 않아 push마다 OpenAI API 비용이 반복 발생하지 않게 했습니다.
• 모델은 repository variable OPENAI_REVIEW_MODEL로 교체할 수 있고 기본값은 gpt-4.1-mini입니다.

📸 Screenshots / Videos

Before

• UI 변경 없음

After

• UI 변경 없음

✅ Testing

Test Plan

• git diff --check
• workflow YAML parse
• github-script JavaScript syntax check
• make lint
• make arch-check
• 앱 빌드 성공
• Debug 모드 정상 작동 (CI 설정 변경으로 별도 실행하지 않음)
• Release 모드 정상 작동 (CI 설정 변경으로 별도 실행하지 않음)
• 기존 기능 영향 없음
• Widget Extension 정상 작동 (해당 없음)

Test Environment

• iOS Version: N/A
• Device: generic/platform=iOS
• Xcode Version: Xcode 26.5 (Build version 17F42)
• macOS Version: 26.5 (25F71)

Test Results

• git diff --check 통과
• ruby -e ... YAML.load_file(...) 통과
• node --check 통과
• make lint 통과: 0 violations
• make arch-check 통과: Architecture checks passed
• xcodebuild build -workspace Mulimi.xcworkspace -scheme Mulimi -destination generic/platform=iOS CODE_SIGNING_ALLOWED=NO CODE_SIGNING_REQUIRED=NO 통과: BUILD SUCCEEDED

🚨 Breaking Changes

• Yes (아래에 설명)
• No

📌 Additional Notes

• Repository secret OPENAI_API_KEY가 있어야 AI 리뷰가 실행됩니다.
• Repository variable OPENAI_REVIEW_MODEL은 선택 사항입니다.
• fork PR에는 secrets가 기본 전달되지 않으므로 AI 리뷰가 skip될 수 있습니다.

👀 Review Checklist

• 코드가 프로젝트의 코딩 컨벤션을 따르고 있나요?
• 새로운 의존성이 필요한가요? (actions/github-script@v7 사용)
• 문서 업데이트가 필요한가요?
• 데이터베이스 마이그레이션이 필요한가요?
• 환경 설정 변경이 필요한가요? (OPENAI_API_KEY secret 필요)

---

🤖 PR 템플릿 v1.0