github-pr-review-operation
GitHub Pull Requestのレビュー操作を行うスキル。PR情報取得、差分確認、コメント取得・投稿、インラインコメント、コメント返信をghコマンドで実行する。PRレビュー、コードレビュー、PR操作が必要な時に使用。
When & Why to Use This Skill
This Claude skill automates and enhances the GitHub Pull Request review workflow by leveraging the GitHub CLI (gh). It allows for seamless retrieval of PR metadata, detailed diff analysis with line-specific accuracy, and comprehensive comment management, including the ability to post precise inline feedback and replies directly within the development environment.
Use Cases
- Automated Code Review: Fetch PR diffs and use AI to identify potential bugs, style violations, or logic errors, providing immediate feedback to developers.
- Context-Aware Inline Commenting: Post specific suggestions or critiques on individual lines or multi-line blocks of code using precise line-number mapping.
- PR Discussion Management: Monitor, retrieve, and reply to review comments and issue discussions to maintain a high-velocity feedback loop.
- Headless PR Auditing: Quickly assess the status, title, and body of pull requests to prioritize review tasks without leaving the terminal or AI interface.
| name | github-pr-review-operation |
|---|---|
| description | GitHub Pull Requestのレビュー操作を行うスキル。PR情報取得、差分確認、コメント取得・投稿、インラインコメント、コメント返信をghコマンドで実行する。PRレビュー、コードレビュー、PR操作が必要な時に使用。 |
GitHub PR Review Operation
GitHub CLI (gh) を使ったPRレビュー操作。
前提条件
ghインストール済みgh auth loginで認証済み
PR URLのパース
PR URL https://github.com/OWNER/REPO/pull/NUMBER から以下を抽出して使用:
OWNER: リポジトリオーナーREPO: リポジトリ名NUMBER: PR番号
操作一覧
1. PR情報取得
gh pr view NUMBER --repo OWNER/REPO --json title,body,author,state,baseRefName,headRefName,url
2. 差分取得(行番号付き)
gh pr diff NUMBER --repo OWNER/REPO | awk '
/^@@/ {
match($0, /-([0-9]+)/, old)
match($0, /\+([0-9]+)/, new)
old_line = old[1]
new_line = new[1]
print $0
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 }
'
出力例:
@@ -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 repos/OWNER/REPO/issues/NUMBER/comments --jq '.[] | {id, user: .user.login, created_at, body}'
Review Comments(コード行へのコメント):
gh api 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 "コメント内容"
5. インラインコメント(コード行指定)
まず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="コメント内容" \
-f commit_id="COMMIT_SHA" \
-f path="src/example.py" \
-F line=15 \
-f side=RIGHT
複数行コメント(10〜15行目):
gh api repos/OWNER/REPO/pulls/NUMBER/comments \
--method POST \
-f body="コメント内容" \
-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(削除行)
6. コメントへ返信
gh api repos/OWNER/REPO/pulls/NUMBER/comments/COMMENT_ID/replies \
--method POST \
-f body="返信内容"
COMMENT_IDはコメント取得で得たidを使用。