GitHub PR Review Operation Skill

GitHub PR Review Operation

Use git-workflow to resolve the PR and inspect its current diff and relevant code.

Workflow and Authority

For a review request, return evidence-backed findings in the conversation. Publish comments or replies when the user requests that operation.
For an authorized comment, prepare its exact text, path, side, and line. Recheck the head SHA if it may have changed during review.
Verify the returned comment URL and target. Inspect existing comments before retrying an ambiguous failure to avoid duplicate posts.

Completion: findings are reported, or each authorized comment is verified on the intended PR. State any missing evidence or failed publication.

Inline Comment First

PR 上で code-specific な指摘や補足を残したい場合は、まずこの手順を見る。

目的

インラインコメントは、PR本文ではなく diff 上の正確な位置にレビュー意図を残すために使う。実装上の懸念、設計判断への確認、特定行への補足はここで扱う。

最短手順

対象 PR を特定する。
gh pr diff を行番号付きで見て、コメント対象の path と line を決める。
RIGHT / LEFT を判定する。
head commit SHA を取得する。
gh api repos/OWNER/REPO/pulls/NUMBER/comments --method POST ... で投稿する。

行番号の見つけ方

まず diff を行番号付きで表示する。

gh pr diff NUMBER --repo OWNER/REPO | awk '
/^@@/ {
  old_line = $2
  sub(/^-/, "", old_line)
  sub(/,.*/, "", old_line)
  new_line = $3
  sub(/^\+/, "", new_line)
  sub(/,.*/, "", new_line)
  print $0
  next
}
/^diff --git/ { old_line = new_line = 0; print; next }
/^(---|\+\+\+)/ { print; next }
/^-/ { printf "L%-4d     | %s\n", old_line++, $0; next }
/^\+/ { printf "     R%-4d| %s\n", new_line++, $0; next }
/^ / { printf "L%-4d R%-4d| %s\n", old_line++, new_line++, $0; next }
{ print }
'

L数字: base 側の削除行。インラインコメントでは side=LEFT
R数字: head 側の追加行。インラインコメントでは side=RIGHT

単一行コメント

まず head commit SHA を取る。

gh api repos/OWNER/REPO/pulls/NUMBER --jq '.head.sha'

その後、対象行にコメントする。

gh api repos/OWNER/REPO/pulls/NUMBER/comments \
  --method POST \
  -F body=@/absolute/path/to/comment.md \
  -f commit_id="COMMIT_SHA" \
  -f path="src/example.py" \
  -F line=15 \
  -f side=RIGHT

複数行コメント

gh api repos/OWNER/REPO/pulls/NUMBER/comments \
  --method POST \
  -F body=@/absolute/path/to/comment.md \
  -f commit_id="COMMIT_SHA" \
  -f path="src/example.py" \
  -F line=15 \
  -f side=RIGHT \
  -F start_line=10 \
  -f start_side=RIGHT

注意点

-F (大文字): 数値パラメータ（line, start_line）に使用。-f だと文字列になりエラーになる
side: RIGHT（追加行）または LEFT（削除行）
diff で見えている行番号と path が一致していないと投稿に失敗する

前提条件

gh インストール済み
gh auth login で認証済み

PR URLのパース

PR URL https://github.com/OWNER/REPO/pull/NUMBER から以下を抽出して使用：

OWNER: リポジトリオーナー
REPO: リポジトリ名
NUMBER: PR番号

特に PR が指示されなかった場合や、この PR などの指示語が与えられた場合

gh pr view --json url --jq .url 2>/dev/null || echo "No PR found for current branch" を実行して、現在のブランチに関連するPR URLを取得し、パースして使用する。

操作一覧

1. PR情報取得

gh pr view NUMBER --repo OWNER/REPO --json title,body,author,state,baseRefName,headRefName,url

2. 差分取得（行番号付き）

スクリプトは上記「行番号の見つけ方」参照。出力例：

@@ -46,15 +46,25 @@ jobs:
L46   R46  |            prompt: |
L49       | -            （削除行）
     R49  | +            （追加行）
L50   R50  |              # レビューガイドライン

L数字: LEFT(base)側の行番号 → インラインコメントでside=LEFTに使用
R数字: RIGHT(head)側の行番号 → インラインコメントでside=RIGHTに使用

3. コメント取得

Issue Comments（PR全体へのコメント）:

gh api --paginate repos/OWNER/REPO/issues/NUMBER/comments --jq '.[] | {id, user: .user.login, created_at, body}'

Review Comments（コード行へのコメント）:

gh api --paginate repos/OWNER/REPO/pulls/NUMBER/comments --jq '.[] | {id, user: .user.login, path, line, created_at, body, in_reply_to_id}'

4. PRにコメント

gh pr comment NUMBER --repo OWNER/REPO --body-file /absolute/path/to/comment.md

5. インラインコメント（コード行指定）

上記「Inline Comment First」セクション参照。

6. コメントへ返信

gh api repos/OWNER/REPO/pulls/NUMBER/comments/COMMENT_ID/replies \
  --method POST \
  -F body=@/absolute/path/to/reply.md

COMMENT_IDはコメント取得で得たidを使用。

Agent Skills: GitHub PR Review Operation

Install this agent skill to your local

Skill Files