git-resolve-for-origin-develop

origin/develop への rebase とコンフリクト解消

目的

対象ブランチを最新の origin/develop へ rebase し、コンフリクトを安全に解消して、検証が通る状態までローカルで仕上げる。

呼び出し形式

/git-resolve-for-origin-develop [<Issue URL または Issue 番号>]

• 引数は省略可能
• 引数は「どのブランチを rebase するか」を決めるためだけに使う
• 引数があっても、Issue 本文の内容をコードへ実装することはしない

対象ブランチの決定

次の A → B → X → C の順にフォールバックする。 先の手段で対象が一意に決まった時点で、以降の手段は試さない。 決定後は、必ず対象ブランチと決定根拠（A/B/X/C）を宣言してから作業を始める。

A. Issue に紐づく PR の head ブランチ

引数で Issue が指定された場合に試す。

1. Issue を確認する

   gh issue view <issue-url-or-number> --json number,title,url,state
   

2. Issue に紐づく PR を取得する

   gh api graphql -f query='
   query($owner:String!,$repo:String!,$number:Int!){
     repository(owner:$owner,name:$repo){
       issue(number:$number){
         timelineItems(itemTypes:[CROSS_REFERENCED_EVENT,CONNECTED_EVENT],first:100){
           nodes{
             __typename
             ... on CrossReferencedEvent{ source{ ... on PullRequest{ number headRefName state isDraft url } } }
             ... on ConnectedEvent{ subject{ ... on PullRequest{ number headRefName state isDraft url } } }
           }
         }
       }
     }
   }' -F owner=<owner> -F repo=<repo> -F number=<issue-number>
   

   取得できない場合の補助として次も使う

   gh pr list --state open --search "<issue-number>" --json number,title,headRefName,url
   

3. open な PR が 1 件に絞れたら、その headRefName を対象ブランチにする

4. open な PR が複数ある場合は A を成立させず C へ進む

5. 対象ブランチが現在のブランチと異なる場合も、A で一意に決まったなら切り替えて進める。ただし作業ツリーがクリーンでないときは切り替えず C へ進む

B. 現在のブランチ

A が成立しなかった場合に試す。

1. git branch --show-current で現在のブランチを取得する

2. 現在のブランチが develop / main / master の場合は B を成立させず X へ進む

3. detached HEAD の場合は B を成立させず C へ進む

4. 現在のブランチに紐づく open PR があるか確認する

   gh pr view --json number,title,headRefName,baseRefName,url
   

5. PR があり、その head が現在のブランチなら、現在のブランチを対象にする

6. PR がない場合、そのブランチが作業ブランチだと判断できるなら現在のブランチを対象にしてよい。判断できないときは X へ進む

X. 推論

A も B も成立しなかった場合に、根拠を挙げて推論する。

• ブランチ名に Issue 番号が含まれる（例: feature/3207-xxx、fix/issue-3207）
• ブランチの独自コミットのメッセージに Issue 番号や Issue タイトルと一致する記述がある