プルリクエスト ワークフロー

プロジェクト標準に従ったプルリクエスト作成の完全なワークフローです。

プロセス

1. ステージされた変更を確認 - git diff --cached --name-only で確認

2. ブランチのセットアップ

   • main/master にいる場合は、先に機能ブランチを作成: feature/brief-description または fix/brief-description
   • 必要に応じて github-dev:commit-creator サブエージェントを使用してステージされた変更を処理

3. ドキュメント確認

   • 変更内容に基づいて README.md またはドキュメントを更新(ターゲットブランチとの比較)
   • 設定/API の変更の場合は、mcp__tavily__tavily_search を使用して情報を確認し、ソースを含める

4. すべてのコミットを分析

   • git diff <base-branch>...HEAD を使用して完全な変更セットを確認
   • PR メッセージは最新のコミットだけでなく、すべてのコミットを説明する必要があります
   • レビュアーの視点から何が変更されたかに焦点を当てる

5. PR を作成

   • /pr-creator エージェントまたは gh pr create をパラメータ付きで使用:
     • -t (タイトル): 大文字で始める、動詞を使う、"fix:" または "feat:" プレフィックスは不要
     • -b (本文): 簡潔なサマリー + インラインマークダウンリンク付きの箇条書き
     • -a @me (自分を割り当て)
     • -r <reviewer>: gh pr list --repo <owner>/<repo> --author @me --limit 5 で検索

6. PR 本文ガイドライン

   • サマリー: 変更を説明する数語または 1 文
   • 変更内容: インラインリンク [src/auth.py:42](src/auth.py#L42) 付きの箇条書き
   • 例: 重要な変更の場合は、変更前後のコード例を含める
   • テスト計画なし: PR にテスト手順を記載しない

例

インラインソースリンク付き:

Update Claude Haiku to version 4.5

- Model ID: claude-3-haiku-20240307 → claude-haiku-4-5-20251001 ([source](https://docs.anthropic.com/en/docs/about-claude/models/overview))
- Pricing: $0.80/$4.00 → $1.00/$5.00 per MTok ([source](https://docs.anthropic.com/en/docs/about-claude/pricing))
- Max output: 4,096 → 64,000 tokens ([source](https://docs.anthropic.com/en/docs/about-claude/models/overview))

コード変更付き:

Refactor authentication to use async context manager

- Replace synchronous auth flow with async/await pattern in [src/auth.py:15-42](src/auth.py#L15-L42)
- Add context manager support for automatic cleanup

Before:
\`\`\`python
def authenticate(token):
    session = create_session(token)
    return session
\`\`\`

After:
\`\`\`python
async def authenticate(token):
    async with create_session(token) as session:
        return session
\`\`\`