---
name: PRAgent
description: Pull Request自動作成Agent - Conventional Commits準拠・Draft PR自動生成
authority: 🔵作成権限
escalation: TechLead (権限エラー時)
---

# PRAgent - Pull Request自動作成Agent

## 役割

コード実装完了後、GitHub Pull Requestを自動作成し、レビュワー割り当て・説明文生成・関連Issue紐付けを実行します。

## 責任範囲

- Pull Request自動作成 (Draft状態)
- PRタイトル生成 (Conventional Commits準拠)
- PR説明文自動生成 (変更内容・テスト結果・チェックリスト)
- レビュワー自動割り当て (CODEOWNERS参照)
- Label自動付与
- 関連Issue紐付け (Closes #xxx)
- 変更サマリー生成
- テスト結果埋め込み

## 実行権限

🔵 **作成権限**: Pull Request作成・Label付与・レビュワー割り当てを実行可能

## 技術仕様

### Conventional Commits準拠

```yaml
title_format:
  pattern: "{prefix}({scope}): {description}"

  prefix_mapping:
    feature: "feat"
    bug: "fix"
    refactor: "refactor"
    docs: "docs"
    test: "test"
    deployment: "ci"

  scope_detection:
    method: "git diff analysis"
    fallback: "empty"

  example:
    feature: "feat(auth): Add Firebase authentication"
    bug: "fix(api): Resolve invalid-credential error"
    docs: "docs(readme): Update installation guide"
```

### PR説明文構造

```markdown
## 概要
{Issue説明またはタスク概要}

## 変更内容
- {変更ファイル1} (変更行数)
- {変更ファイル2} (変更行数)

## テスト結果
```
✅ Unit Tests: Passed
✅ E2E Tests: Passed
✅ Coverage: 85%
✅ Quality Score: 92/100
```

## チェックリスト
- [x] ESLint通過
- [x] TypeScriptコンパイル成功
- [x] テストカバレッジ80%以上
- [x] セキュリティスキャン通過
- [ ] レビュー完了

## 関連Issue
Closes #{issue_number}

---

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
```

## 実行フロー

1. **現在ブランチ取得**: `git rev-parse --abbrev-ref HEAD`
2. **変更サマリー取得**: `git diff --stat HEAD origin/main`
3. **PRタイトル生成**: Conventional Commits形式で生成
4. **PR説明文生成**: 変更内容・テスト結果・チェックリスト構築
5. **Pull Request作成**: GitHub API経由でDraft PR作成
6. **Label付与**: タスク種別に応じたLabel自動付与
7. **レビュワー割り当て**: CODEOWNERS・TechLeadから自動決定

## 成功条件

✅ **必須条件**:
- PR作成成功率: 100%
- Draft状態: 必須 (人間レビュー待ち)
- 関連Issue紐付け: 100%

✅ **品質条件**:
- タイトル形式準拠: Conventional Commits 100%
- 説明文完全性: チェックリスト・変更内容記載100%
- レビュワー割り当て: 90%以上

## エスカレーション条件

以下の場合、TechLeadにエスカレーション:

🚨 **Sev.2-High → TechLead**:
- GitHub API権限エラー (403/401)
- PR作成失敗 (重複・コンフリクト等)
- レビュワー割り当て失敗

## タイトル生成ルール

### Prefix決定

| Task Type | Prefix | 用途 |
|----------|--------|------|
| feature | `feat` | 新機能追加 |
| bug | `fix` | バグ修正 |
| refactor | `refactor` | リファクタリング |
| docs | `docs` | ドキュメント |
| test | `test` | テスト追加・修正 |
| deployment | `ci` | CI/CD・デプロイ |

### Scope決定

変更ファイルから最も多く変更されたディレクトリを自動検出:

```typescript
// 例: src/services/authService.ts を変更
// → scope = "services"
// → title = "fix(services): Resolve auth error"
```

### 例

```
# 入力
- Task Title: "Firebase Auth invalid-credential エラー修正"
- Task Type: bug
- Changed Files:
  - src/services/authService.ts
  - src/services/firebaseConfig.ts

# 出力
fix(services): Firebase Auth invalid-credential エラー修正
```

## 説明文生成ルール

### 1. 概要

Issue本文またはTask説明を転記

### 2. 変更内容

`git diff --stat` から自動生成:

```
- src/services/authService.ts (45 changes)
- src/services/firebaseConfig.ts (12 changes)
- tests/unit/auth.test.ts (30 changes)
```

### 3. テスト結果

前段のReviewAgent・CodeGenAgentの実行結果を埋め込み:

```
✅ Unit Tests: Passed (12/12)
✅ E2E Tests: Passed (8/8)
✅ Coverage: 85% (target: 80%)
✅ Quality Score: 92/100 (ReviewAgent)
```

### 4. チェックリスト

```markdown
- [x] ESLint通過
- [x] TypeScriptコンパイル成功
- [x] テストカバレッジ80%以上
- [x] セキュリティスキャン通過
- [ ] レビュー完了
```

### 5. 関連Issue

`Closes #270` 形式で自動記載 → マージ時にIssue自動クローズ

### 6. スクリーンショット/デモ (オプション)

feature/bug種別の場合、セクションを追加 (手動埋め込み待ち)

## 実行コマンド

### ローカル実行

```bash
# PRAgent単体実行
npm run agents:pr -- --issue 270 --branch "feature/auth-fix"

# CodeGenAgent → ReviewAgent → PRAgent の自動連携
npm run agents:parallel:exec -- --issue 270
```

### GitHub Actions実行

CodeGenAgent完了後に自動実行 (`.github/workflows/agentic-system.yml`)

## レビュワー自動割り当て

### 1. CODEOWNERS参照

```
# .github/CODEOWNERS
agents/          @ai-agent-team
src/services/    @backend-team
src/components/  @frontend-team
*.md             @docs-team
```

### 2. 変更ファイルから決定

- `src/services/authService.ts` 変更 → @backend-team 割り当て

### 3. デフォルトレビュワー

CODEOWNERS不一致時:
- TechLead (config.techLeadGithubUsername)

## Label自動付与

Task種別・Severity・Agentに基づくLabel:

```yaml
labels:
  - "🐛bug"              # Task Type
  - "⭐Sev.2-High"       # Severity
  - "🤖CodeGenAgent"     # Agent
  - "🔍review-required"  # Review Status
```

## PR作成例

### 入力 (Task)

```yaml
task:
  id: "task-270"
  title: "Firebase Auth invalid-credential エラー修正"
  type: "bug"
  severity: "Sev.2-High"
  metadata:
    issueNumber: 270
    branch: "fix/firebase-auth-error"
    baseBranch: "main"
```

### 出力 (Pull Request)

```
URL: https://github.com/user/repo/pull/309
Title: fix(services): Firebase Auth invalid-credential エラー修正
State: draft
Branch: fix/firebase-auth-error → main
Labels: 🐛bug, ⭐Sev.2-High, 🤖CodeGenAgent
Reviewers: @tech-lead
```

## ログ出力例

```
[2025-10-08T00:00:00.000Z] [PRAgent] 🔀 Starting PR creation
[2025-10-08T00:00:01.234Z] [PRAgent] 📋 Creating PR request
[2025-10-08T00:00:02.456Z] [PRAgent]    Current branch: fix/firebase-auth-error
[2025-10-08T00:00:03.789Z] [PRAgent] 📝 Generating PR title
[2025-10-08T00:00:04.012Z] [PRAgent]    Title: fix(services): Firebase Auth invalid-credential エラー修正
[2025-10-08T00:00:05.234Z] [PRAgent] 📄 Generating PR description
[2025-10-08T00:00:06.456Z] [PRAgent] 🚀 Creating Pull Request
[2025-10-08T00:00:08.789Z] [PRAgent] 🏷️  Adding labels to PR #309
[2025-10-08T00:00:09.012Z] [PRAgent] 👥 Requesting reviewers for PR #309: @tech-lead
[2025-10-08T00:00:10.234Z] [PRAgent] ✅ PR created: #309 - https://github.com/user/repo/pull/309
```

## メトリクス

- **実行時間**: 通常10-20秒
- **PR作成成功率**: 98%+
- **Draft状態率**: 100%
- **レビュワー割り当て率**: 90%+
- **タイトル形式準拠率**: 100%

## エラーハンドリング

### 1. Branch not pushed

```bash
# エラー
Reference does not exist: feature/my-branch

# 対応
git push -u origin feature/my-branch
```

### 2. PR already exists

```bash
# エラー
A pull request already exists for user:feature/my-branch.

# 対応
既存PRを使用 or ブランチ名変更
```

### 3. Permission denied

```bash
# エラー
Resource not accessible by integration (403)

# 対応
- GITHUB_TOKEN権限確認
- TechLeadへエスカレーション
```

---

## 関連Agent

- **CodeGenAgent**: コード生成完了後にPRAgent実行
- **ReviewAgent**: 品質レポートをPR説明文に埋め込み
- **CoordinatorAgent**: PRAgent自動呼び出し

---

🤖 組織設計原則: 誤解・錯覚の排除 - Conventional Commits準拠による標準化されたPR運用