post-review

レビュードラフトの投稿（個別インラインコメント）

/review-pr が作成したドラフトを、GitHub へ個別インラインコメントとして投稿します。

最重要ルール

同一会話内で /review-pr を実行して作成されたドラフトのみを投稿対象とする。

• ドラフトが存在しない場合は「投稿対象のドラフトがありません。先に /review-pr <PR-URL> を実行してください」と報告して終了する
• この Skill 内で新たにレビュー内容を考え出して投稿してはならない。投稿するのは、利用者が目にしたドラフトと、利用者が指示した修正のみ
• 利用者が採否を指示していない指摘は、ドラフトに載っていたものをそのまま投稿する（勝手に追加・削除しない）

引数

$ARGUMENTS から以下を解析（すべて省略可）:

1. 判定: approve / comment / request-changes
   • 省略時はドラフトの event（/review-pr の判定案）を使う
2. 投稿する指摘番号: 1,3-4 のような指定
   • 省略時はドラフトの全件
   • 会話中の「1 は無視、2 だけ」「4 件独立コメントにして」「軽微なのでまとめて 1 コメントに」のような自然言語の指示も、同じ意味に解釈して反映する

手順

1. ドラフトの読み込み

scratchpad の review-draft-{owner}-{repo}-{number}.json を Read する。会話中に対象 PR が複数ある場合は、直近に /review-pr を実行したものを対象とし、投稿前の確認でその PR 番号を明示する。

2. 採否の反映

利用者の指示に従って comments 配列を組み替える:

• 除外: 指定された番号の要素を削除する
• まとめる: 「1 コメントにまとめて」と指示された場合は、comments を空にして内容を body に統合する
• 分ける: 「個別コメントにして」と指示された場合は、body にまとめていた内容を該当行ごとの comments 要素へ分解する
• 本文の修正: 利用者が表現や結論を変更した場合はそれを反映する

event を決定する:

指示	event
approve / LGTM / 承認	APPROVE
change request / 要修正	REQUEST_CHANGES
それ以外・指定なし	COMMENT

**event は必ず設定する。**省略すると PENDING レビューになり、PR ごとに 1 件しか持てない状態のまま GitHub 上に未送信のレビューが残る。

3. 投稿前のセルフチェック

投稿コマンドを実行する前に、以下をすべて確認する:

1. HEAD SHA が最新か

   gh pr view {number} --repo {owner}/{repo} --json headRefOid --jq '.headRefOid'
   

   ドラフトの commit_id と異なる場合は、レビュー中に push されている。差分を取り直して行番号がずれていないか確認し、commit_id を最新に更新する。ずれが大きい場合は投稿せず、再レビューが必要な旨を報告する。

2. 各コメントの行が差分に含まれるか

   gh pr diff {number} --repo {owner}/{repo} の hunk ヘッダから、path / line / side の組が差分範囲内にあることを確認する。範囲外の行は 422 で投稿全体が失敗する。

3. path がリポジトリルートからの相対パスか（先頭に ./ や絶対パスを含めない）

4. 自分自身の PR でないか

   gh pr view {number} --repo {owner}/{repo} --json author --jq '.author.login'
   gh api user --jq '.login'
   

   自分の PR は APPROVE / REQUEST_CHANGES を投稿できない。一致する場合は COMMENT に切り替え、その旨を報告に含める。