Claude CodeでPull Requestを作成する - Issue対応からPRまで一気通貫

1

> gh issue view 123 を実行して、Issue #123の内容を確認して

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

⏺ 実行: gh issue view 123

Issue #123: ユーザー認証時のエラーハンドリング改善

状態: Open
作成者: @developer
ラベル: bug, priority-high

■ 内容:
ログイン失敗時のエラーメッセージが不明確で、ユーザーが原因を特定できない。
以下の改善が必要:
1. 具体的なエラー理由の表示
2. リトライ可能な場合の案内
3. サポートへの問い合わせ導線

■ 再現手順:
1. ログイン画面で間違ったパスワードを入力
2. 「エラーが発生しました」というメッセージのみ表示される

1
2

> このIssueに対応するための実装方針を提案して。
> 既存のエラーハンドリングの実装も確認して。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

⏺ 実装方針を提案します:

■ 現状分析:
- src/services/AuthService.ts でエラーを catch して一般的なメッセージを返却
- エラー種別（パスワード不一致、アカウントロック等）が区別されていない

■ 提案する変更:

1. AuthError クラスの拡張（src/errors/AuthError.ts）
   - エラーコードと詳細メッセージを保持
   - リトライ可能かどうかのフラグを追加

2. AuthService の改修（src/services/AuthService.ts）
   - 認証失敗時に具体的なエラー種別を特定
   - AuthError をスローするように変更

3. LoginForm コンポーネントの改修（src/components/LoginForm.tsx）
   - エラー種別に応じたメッセージ表示
   - リトライボタンの条件付き表示
   - サポートリンクの追加

4. テストの追加
   - AuthService のエラーハンドリングテスト
   - LoginForm のエラー表示テスト

■ 影響範囲:
- 認証関連のエラー表示が変わるため、E2Eテストの更新が必要
- 既存のエラーログ形式との互換性を確認する必要あり

1
2

> Issue #123 に対応するブランチを作成して。
> ブランチ名は fix/issue-123-auth-error-handling にして。

1
2
3

⏺ 実行: git checkout -b fix/issue-123-auth-error-handling

Switched to a new branch 'fix/issue-123-auth-error-handling'

1
2

> 先ほど提案した実装方針に基づいて、Issue #123 の対応を実装して。
> まず AuthError クラスから始めて。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

⏺ AuthError クラスを実装します。

■ 作成: src/errors/AuthError.ts

export enum AuthErrorCode {
  INVALID_CREDENTIALS = 'INVALID_CREDENTIALS',
  ACCOUNT_LOCKED = 'ACCOUNT_LOCKED',
  ACCOUNT_NOT_FOUND = 'ACCOUNT_NOT_FOUND',
  SESSION_EXPIRED = 'SESSION_EXPIRED',
  UNKNOWN = 'UNKNOWN',
}

export interface AuthErrorOptions {
  code: AuthErrorCode;
  message: string;
  retryable: boolean;
  supportUrl?: string;
}

export class AuthError extends Error {
  readonly code: AuthErrorCode;
  readonly retryable: boolean;
  readonly supportUrl?: string;

  constructor(options: AuthErrorOptions) {
    super(options.message);
    this.name = 'AuthError';
    this.code = options.code;
    this.retryable = options.retryable;
    this.supportUrl = options.supportUrl;
  }

  static invalidCredentials(): AuthError {
    return new AuthError({
      code: AuthErrorCode.INVALID_CREDENTIALS,
      message: 'メールアドレスまたはパスワードが正しくありません',
      retryable: true,
    });
  }

  static accountLocked(): AuthError {
    return new AuthError({
      code: AuthErrorCode.ACCOUNT_LOCKED,
      message: 'アカウントがロックされています',
      retryable: false,
      supportUrl: '/support/account-locked',
    });
  }
}

この変更を適用しますか？ [y/n]

1
2
3
4
5
6
7
8
9

# .claude/commands/fix-issue.md の内容
Find and fix issue #$ARGUMENTS. Follow these steps:
1. Read the issue description using gh issue view
2. Understand the requirements and acceptance criteria
3. Analyze the relevant code in our codebase
4. Create a branch named fix/issue-$ARGUMENTS-<brief-description>
5. Implement the solution following our coding standards
6. Add appropriate tests
7. Prepare a concise commit message referencing the issue

1

> /fix-issue 123

1

> 今回の変更内容をサマリーして。PRの説明文に使えるように整理して。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

⏺ 変更内容サマリー:

■ 概要:
Issue #123 に対応し、ユーザー認証時のエラーハンドリングを改善しました。

■ 変更ファイル:
- src/errors/AuthError.ts (新規)
- src/services/AuthService.ts (修正)
- src/components/LoginForm.tsx (修正)
- src/tests/AuthService.test.ts (新規)
- src/tests/LoginForm.test.tsx (新規)

■ 主な変更点:
1. AuthError クラスの追加
   - エラーコードによる種別管理
   - リトライ可能フラグの追加
   - サポートURL保持機能

2. AuthService の改修
   - 認証失敗時の詳細なエラー判定
   - AuthError をスローする形式に変更

3. LoginForm の改善
   - エラー種別に応じたメッセージ表示
   - リトライボタンの条件付き表示
   - サポートページへのリンク追加

■ テスト:
- AuthService: 5ケース追加（全パス）
- LoginForm: 8ケース追加（全パス）

1

> create a pr

1
2

> PRを作成して。タイトルは「feat: 認証エラーハンドリングの改善」にして。
> Issue #123 をクローズするようにリンクして。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

⏺ 実行: gh pr create --title "feat: 認証エラーハンドリングの改善" \
  --body "## 概要
Issue #123 に対応し、ユーザー認証時のエラーハンドリングを改善しました。

## 変更内容
- AuthError クラスの追加
- AuthService でのエラー種別判定
- LoginForm でのユーザーフレンドリーなエラー表示

## テスト
- AuthService: 5ケース追加（全パス）
- LoginForm: 8ケース追加（全パス）

## 関連Issue
Closes #123"

Creating pull request for fix/issue-123-auth-error-handling into main

https://github.com/your-org/your-repo/pull/456

1

> enhance the PR description with more context about the security improvements

1

> PRの説明文に、テスト方法の詳細を追加して

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

⏺ 実行: gh pr edit 456 --body "..."

PR #456 の説明文を更新しました。

追加した内容:
■ テスト方法:
1. ログイン画面で間違ったパスワードを入力
2. 「メールアドレスまたはパスワードが正しくありません」と表示されることを確認
3. リトライボタンが表示されることを確認

4. 5回連続でログインに失敗
5. 「アカウントがロックされています」と表示されることを確認
6. サポートページへのリンクが表示されることを確認

1

> gh pr view 456 --comments を実行して、レビューコメントを確認して

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

⏺ 実行: gh pr view 456 --comments

PR #456 のレビューコメント:

■ @reviewer (2時間前):
src/services/AuthService.ts L45-50:
「エラーメッセージが日本語固定になっていますが、i18n対応は考慮されていますか？」

■ @reviewer (2時間前):
src/components/LoginForm.tsx L78:
「サポートURLのハードコードは避けて、環境変数から取得するようにしてください」

1
2
3

> レビューコメントに対応して。
> 1. エラーメッセージをi18n対応する
> 2. サポートURLを環境変数から取得するように修正する

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

⏺ レビュー指摘に対応します。

■ 変更1: AuthError.ts のi18n対応

- import { t } from '@/i18n';
+ import { t } from '@/i18n';

  static invalidCredentials(): AuthError {
    return new AuthError({
      code: AuthErrorCode.INVALID_CREDENTIALS,
-     message: 'メールアドレスまたはパスワードが正しくありません',
+     message: t('auth.error.invalidCredentials'),
      retryable: true,
    });
  }

■ 変更2: LoginForm.tsx のサポートURL修正

- supportUrl: '/support/account-locked',
+ supportUrl: process.env.NEXT_PUBLIC_SUPPORT_URL || '/support',

これらの変更を適用しますか？ [y/n]

1

> 修正をコミットしてプッシュして。コミットメッセージは「fix: address review comments」で

1
2
3
4
5
6
7
8

⏺ 実行: git add -A && git commit -m "fix: address review comments

- Add i18n support for error messages
- Use environment variable for support URL"

実行: git push

修正をプッシュしました。レビュアーに確認を依頼できます。

1

> /install-github-app

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# .github/workflows/claude.yml
name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

1
2

# Issue #200 のコメント例
@claude このIssueを分析して、実装方針を提案してください

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# .github/workflows/code-review.yml
name: Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# .github/workflows/auto-implement.yml
name: Auto Implement
on:
  issues:
    types: [labeled]
jobs:
  implement:
    if: github.event.label.name == 'auto-implement'
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            Implement the feature described in this issue.
            Create a branch, implement the solution, and open a PR.
          claude_args: "--max-turns 20"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# .gitlab-ci.yml
stages:
  - review

code_review:
  stage: review
  image: node:20
  script:
    - npm install -g @anthropic-ai/claude-code
    - claude -p "Review the changes in this merge request and provide feedback"
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
  variables:
    ANTHROPIC_API_KEY: $ANTHROPIC_API_KEY

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# .gitlab-ci.yml
implement_feature:
  stage: implement
  script:
    - |
      claude -p "
        Read the issue description from $CI_MERGE_REQUEST_DESCRIPTION
        and implement the requested changes.
      "
  rules:
    - if: $CI_MERGE_REQUEST_LABELS =~ /auto-implement/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# CLAUDE.md

## PR作成ルール
- PRタイトルは Conventional Commits 形式に従う（feat:, fix:, docs: 等）
- PR説明文には必ず「概要」「変更内容」「テスト」セクションを含める
- 関連Issueは「Closes #XXX」形式でリンクする

## コミットメッセージ規約
- 日本語で記述
- 1行目は50文字以内で変更の要約
- 必要に応じて本文で詳細を説明

## レビュー対応
- レビュー指摘への対応は個別コミットで行う
- 対応完了後はレビュアーにメンションで通知

1
2
3
4

# Shift+Tab でモードを切り替え
# ⏵⏵ accept edits on → Auto-Accept Mode
# ⏵ accept edits → Accept Mode（推奨）
# ⏸ plan mode on → Plan Mode（分析のみ）

1
2
3
4
5
6

# 別のIssue対応用にworktreeを作成
git worktree add ../project-issue-124 -b fix/issue-124

# 各worktreeで別のClaude Codeセッションを起動
cd ../project-issue-124
claude

1
2
3
4
5
6
7
8

# インストール確認
gh --version

# 認証状態確認
gh auth status

# 認証実行
gh auth login

1
2
3
4
5
6
7

> gh pr create の実行に失敗しました。
> エラー: Permission denied

確認事項:
1. リポジトリへの書き込み権限があるか
2. ブランチがプッシュされているか
3. ブランチ保護ルールに違反していないか