AgentSkillsCN

gh-get-review-comments

通过 GitHub API 获取拉取请求的所有评审评论。适用于需要查看 PR 上已收到哪些反馈时使用。

SKILL.md
--- frontmatter
name: gh-get-review-comments
description: "Retrieve all review comments from a pull request using the GitHub API. Use when you need to see what feedback has been provided on a PR."
category: github

Get PR Review Comments

Retrieve and analyze all review comments from a pull request.

When to Use

  • •Checking for unresolved review feedback
  • •Analyzing reviewer feedback before fixing
  • •Verifying all comments have been addressed
  • •Getting comment IDs for replies

Quick Reference

bash
# Get all review comments
gh api repos/OWNER/REPO/pulls/PR/comments

# Get comments with formatting
gh api repos/OWNER/REPO/pulls/PR/comments \
  --jq '.[] | {id: .id, path: .path, body: .body}'

# Filter by reviewer
gh api repos/OWNER/REPO/pulls/PR/comments \
  --jq '.[] | select(.user.login == "username")'

# Get only unresolved comments
gh api repos/OWNER/REPO/pulls/PR/comments \
  --jq '.[] | select(.in_reply_to_id == null)'

Workflow

  1. •Fetch comments: Use API to list all comments
  2. •Parse output: Extract IDs and feedback
  3. •Analyze feedback: Understand what needs fixing
  4. •Plan fixes: Decide how to address each comment
  5. •Apply fixes: Make the requested changes

Output Format

Comments include:

  • •id - Comment ID (use for replies)
  • •path - File where comment was made
  • •line - Line number of comment
  • •body - Comment text
  • •user - Reviewer username
  • •in_reply_to_id - Parent comment ID (null if top-level)

Error Handling

ProblemSolution
PR not foundVerify PR number
Auth failureCheck gh auth status
No commentsAPI returns empty array (not an error)
Permission deniedCheck authentication scopes

Filtering Examples

Comments on specific file:

bash
gh api repos/OWNER/REPO/pulls/PR/comments \
  --jq '.[] | select(.path == "scylla/file.mojo")'

Comments by specific reviewer:

bash
gh api repos/OWNER/REPO/pulls/PR/comments \
  --jq '.[] | select(.user.login == "reviewer")'

Only top-level comments (not replies):

bash
gh api repos/OWNER/REPO/pulls/PR/comments \
  --jq '.[] | select(.in_reply_to_id == null)'

References