$ARGUMENTS = <issue_number> [--skip-pr]

┌─────────────────────────────────────────────────────────────┐
│ Phase 0: Issue検証・タイプ判定                               │
│    ├─ gh issue view {number} で情報取得                     │
│    ├─ チェックリスト抽出                                     │
│    └─ 開発タイプ判定（ラベル/キーワード）                    │
│                                                             │
│ Phase 0.5: 外部API調査（条件付き） ← NEW                     │
│    ├─ Issue内容から外部ライブラリ使用を検出                 │
│    ├─ 検出時: Task(api-usage-researcher) で調査実行         │
│    ├─ 未検出時: スキップして Phase 1 へ                     │
│    └─ 調査結果(api_research)を後続Phaseに受け渡し           │
│                                                             │
│ タイプ別ワークフロー実行                                     │
│    │                                                        │
│    ├─ Python: Phase 1-5                                     │
│    │  ├─ Task(test-writer) でテスト作成（Red）              │
│    │  │     └─ api_research 結果を参照                      │
│    │  ├─ Task(pydantic-model-designer) でモデル設計         │
│    │  │     └─ api_research 結果を参照                      │
│    │  ├─ Task(feature-implementer) で実装                   │
│    │  │     └─ api_research 結果を参照                      │
│    │  ├─ Task(code-simplifier) でコード整理                 │
│    │  └─ Task(quality-checker) で品質保証                   │
│    │                                                        │
│    └─ Agent/Command/Skill:                                  │
│       └─ Task(xxx-creator/expert) に全委譲                  │
│                                                             │
│ 🚨 Phase 6: コミット前検証（必須）                           │
│    ├─ make check-all を実行                                 │
│    ├─ 失敗時: エラー詳細を出力して処理中断                  │
│    └─ 成功時: コミット作成へ進む                            │
│                                                             │
│ コミット作成（Phase 6 成功時のみ）                          │
│    └─ git commit -m "feat: ... Fixes #{number}"             │
│                                                             │
│ PR作成（--skip-pr でない場合のみ）                          │
│    └─ gh pr create ...                                      │
│                                                             │
│ Phase 6.5: PR設計レビュー（PR作成時のみ、--skip-pr 時は省略）│
│    ├─ Task(pr-design) でSOLID原則・DRY・抽象化を検証        │
│    ├─ 重大な問題あり: 警告を出力（CI前に修正推奨）          │
│    └─ 問題なし: Phase 7 へ進む                              │
│                                                             │
│ 🚨 Phase 7: CIチェック検証（PR作成時のみ、--skip-pr 時は省略）│
│    ├─ gh pr checks --watch --fail-fast で完了待ち           │
│    ├─ 全パス: 作業完了                                      │
│    └─ 失敗: エラー修正→再プッシュ→再検証（最大3回）        │
│                                                             │
│ サマリー出力（親に返却される情報）                           │
└─────────────────────────────────────────────────────────────┘

判定順序:
  1. ラベルによる判定（優先）:
     - "agent" | "エージェント" → agent
     - "command" | "コマンド" → command
     - "skill" | "スキル" → skill
     - 上記以外 → python

  2. キーワード判定（ラベルなし時）:
     - ".claude/agents/" パスへの言及 → agent
     - ".claude/commands/" パスへの言及 → command
     - ".claude/skills/" パスへの言及 → skill
     - 上記以外 → python

高信頼度キーワード:
  - yfinance, yf.Ticker, yf.download
  - requests, httpx, aiohttp
  - pandas, pd.DataFrame
  - numpy, np.array
  - pydantic, BaseModel
  - curl_cffi
  - fredapi, fred
  - sec-api, edgar
  - openai, anthropic

中信頼度パターン:
  - import文への言及
  - pip install / uv add への言及
  - 外部API・認証・rate limiting への言及

subagent_type: api-usage-researcher
prompt: |
  Issue #{issue_number} の外部API調査を実行してください。

  ## Issue情報
  - タイトル: {issue_title}
  - 本文: {issue_body}
  - ラベル: {issue_labels}
  - 受け入れ条件: {acceptance_criteria}

Phase 1 (test-writer):
  追加情報: |
    ## 外部API調査結果
    ```json
    {api_research}
    ```
    - 検出されたライブラリのAPIを使用するテストを作成してください
    - best_practices に従ってください

Phase 2 (pydantic-model-designer):
  追加情報: |
    ## 外部API調査結果
    ```json
    {api_research}
    ```
    - return_type を参考にモデルを設計してください

Phase 3 (feature-implementer):
  追加情報: |
    ## 外部API調査結果
    ```json
    {api_research}
    ```
    - apis_to_use の usage_pattern に従って実装してください
    - project_patterns の既存実装を参考にしてください
    - 追加のContext7調査は不要です（調査済み）

api_research:
  investigation_needed: false
  detection_confidence: none

後続Phase:
  - api_research の参照をスキップ
  - 通常のワークフローを実行

# 1. make check-all を実行
make check-all

# 2. 終了コードを確認
# - 0: 成功 → コミット作成へ進む
# - 非0: 失敗 → エラー詳細を出力して処理中断

subagent_type: "pr-design"
description: "PR design review"
prompt: |
  PR #{pr_number} のコード設計品質を検証してください。

  ## 検証対象PR
  - PR番号: {pr_number}
  - Issue: #{issue_number}

  ## 検証観点
  - SOLID原則（単一責任・開放閉鎖・リスコフ置換・IF分離・依存性逆転）
  - DRY原則（重複コード検出）
  - 抽象化レベルの一貫性

design_review:
  score: 85  # 0-100
  solid_compliance:
    single_responsibility: "PASS"
    open_closed: "WARN"  # ← 警告あり
    ...
  issues:
    - severity: "HIGH"
      category: "solid"
      description: "if文の連鎖が検出されました"
      recommendation: "Strategy パターンへの置き換えを検討してください"

# CIチェックの完了を待つ（最大10分）
gh pr checks <pr-number> --watch --fail-fast

gh pr checks <pr-number> --json name,state,bucket,description

git commit -m "$(cat <<'EOF'
feat(<scope>): <変更内容の要約>

<詳細説明>

Fixes #<issue_number>

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
EOF
)"

status: success
issue:
  number: 123
  title: "ユーザー認証機能の追加"
  type: python
implementation:
  files_created:
    - src/finance/auth/authenticator.py
    - tests/finance/unit/auth/test_authenticator.py
  files_modified:
    - src/finance/__init__.py
pre_commit_validation:  # Phase 6 の結果
  status: passed
  format: PASS
  lint: PASS
  typecheck: PASS
  test: PASS (15 tests)
commit:
  hash: "abc1234"
  message: "feat(auth): ユーザー認証機能を追加"
pr:
  number: 456  # --skip-pr の場合は null
  url: "https://github.com/YH-05/finance/pull/456"
design_review:  # Phase 6.5 の結果（PR作成時のみ、--skip-pr の場合は null）
  score: 85
  solid_compliance:
    single_responsibility: "PASS"
    open_closed: "PASS"
    liskov_substitution: "PASS"
    interface_segregation: "PASS"
    dependency_inversion: "PASS"
  issues_found: 0
ci_checks:  # Phase 7 の結果（PR作成時のみ、--skip-pr の場合は null）
  status: passed
  checks:
    - name: "check-all"
      state: "pass"
  fix_attempts: 0  # CI修正の試行回数

status: failed
issue:
  number: 123
  title: "ユーザー認証機能の追加"
  type: python
error:
  phase: 6
  message: "コミット前検証（make check-all）が失敗しました"
  details: |
    format: PASS
    lint: FAIL - src/finance/auth/authenticator.py:15: F401 unused import
    typecheck: PASS
    test: FAIL - test_正常系_認証成功 で AssertionError
pre_commit_validation:
  status: failed
  format: PASS
  lint: FAIL
  typecheck: PASS
  test: FAIL
partial_commit:
  hash: null  # コミットは作成されていない

status: failed
issue:
  number: 123
  title: "ユーザー認証機能の追加"
  type: python
error:
  phase: 3
  message: "feature-implementer がテストを通せませんでした"
  details: "test_正常系_認証成功 で AssertionError"
partial_commit:
  hash: null  # コミット前に失敗した場合