pr-workflow

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

プロジェクトの標準に従ってプルリクエストを作成するためのワークフロー全体です。

プロセス

1. git diff --cached --name-only でステージ済みの変更があることを確認します

2. ブランチの設定

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

3. ドキュメントの確認

   • 対象ブランチとの変更内容に基づいて、README.md または docs を更新します
   • 設定／API に変更がある場合は、mcp__tavily__tavily_search を使用して情報を確認し、出典を含めます

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

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

5. PR の作成

   • /pr-creator エージェント、または次のパラメーターを指定して gh pr create を使用します：
     • -t（タイトル）：大文字で始め、動詞を使い、「fix:」や「feat:」の接頭辞は付けません
     • -b（本文）：簡潔な概要と、インラインの Markdown リンクを含む箇条書き
     • -a @me（自分を割り当てる）
     • -r <reviewer>：ユーザーが明示的に依頼した場合、またはこの作成者による最近の PR にレビュアーがいる場合のみ追加します。 次のコマンドで確認します：gh pr list --repo <owner>/<repo> --author @me --limit 5 --json reviewRequests 最近の PR にレビュアーがいない場合は、-r を付けません。

6. PR 本文のガイドライン

   • セクションは 1 つにし、可能であれば見出しは付けません。非常に簡潔にまとめます
   • 箇条書きは少数にし、CLI／使用例のスニペットを 1 つ、または簡単な変更前／変更後のスニペットを含めます
   • テスト計画、変更ファイルの一覧、行番号へのリンクは含めません

例

CLI スニペット：

Add compare command for side-by-side model comparison

- Run multiple models on same images with `--models` and `--phrases` flags
- Horizontal panel concatenation with model name headers

`ultrannotate compare --source ./images --models sam3.pt,yoloe-26x-seg.pt --phrases "person,car"`

変更前／変更後：

Inline single-use variables in compare_models

- xyxy2xywhn handles empty arrays, guard unnecessary
- Use function reference for draw dispatch

Before: `boxes = result.get(...); ops.xyxy2xywhn(boxes, ...)`
After: `ops.xyxy2xywhn(result.get(...), ...)`