gh-pr-review

qtnx 的头像作者 qtnx

此技能提供使用 gh-pr-review GitHub CLI 扩展从终端查看和管理内联 PR 审查评论的指导。在处理拉取请求审查、查看内联代码审查线程、回复评论、启动/提交审查、解决线程或需要为 PR 审查工作流提供结构化 JSON 输出时使用此技能。在请求"显示 PR 审查评论"、"回复此线程"、"启动审查"、"解决线程"、"查看未解决的评论"或任何 PR 代码审查任务时触发。

📖 中文导读:此技能提供使用 gh-pr-review GitHub CLI 扩展从终端查看和管理内联 PR 审查评论的指导。在处理拉取请求审查、查看内联代码审查线程、回复评论、启动/提交审查、解决线程或需要为 PR 审查工作流提供结构化 JSON 输出时使用此技能。在请求"显示 PR 审查评论"、"回复此线程"、"启动审查"、"解决线程"、"查看未解决的评论"或任何 PR 代码审查任务时触发。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: gh-pr-review description: This skill provides guidance for using the gh-pr-review GitHub CLI extension to view and manage inline PR review comments from the terminal. Use this skill when working with pull request reviews, viewing inline code review threads, replying to comments, starting/submitting reviews, resolving threads, or when needing structured JSON output for PR review workflows. Triggers on requests like "show PR review comments", "reply to this thread", "start a review", "resolve threads", "view unresolved comments", or any PR code review task.

GitHub PR Review CLI Extension

Overview

The gh-pr-review extension brings inline PR review comments to the terminal. GitHub's built-in gh tool does not show inline comments or review threads - this extension fills that gap.

Prerequisites

Ensure the extension is installed:

gh extension install agynio/gh-pr-review
# Update existing installation
gh extension upgrade agynio/gh-pr-review

Core Capabilities

1. View Review Threads

To view all reviews and inline comments for a PR:

gh pr-review review view -R owner/repo --pr <number>

Common filters:

  • --reviewer <login> - Filter by reviewer
  • --states APPROVED,CHANGES_REQUESTED,COMMENTED,DISMISSED - Filter by state
  • --unresolved - Show only unresolved threads
  • --not_outdated - Exclude outdated threads
  • --tail <n> - Keep only last n replies per thread
  • --include-comment-node-id - Include GraphQL comment IDs

Example - View unresolved threads from a specific reviewer:

gh pr-review review view -R owner/repo --pr 42 --reviewer alice --unresolved

2. Start a Pending Review

To start a new pending review and get the review ID:

gh pr-review review --start -R owner/repo <pr-number>

Output includes "id": "PRR_..." - save this for adding comments.

3. Add Inline Comments

To add comments to a pending review (requires PRR_... review ID):

gh pr-review review --add-comment \
  --review-id PRR_kwDOAAABbcdEFG12 \
  --path path/to/file.go \
  --line 42 \
  --body "Your comment here" \
  -R owner/repo <pr-number>

4. Reply to Thread

To reply to an existing review thread:

gh pr-review comments reply \
  --thread-id PRRT_kwDOAAABbcdEFG12 \
  --body "Your reply" \
  -R owner/repo <pr-number>

To reply from a pending review, add --review-id:

gh pr-review comments reply \
  --thread-id PRRT_kwDOAAABbcdEFG12 \
  --review-id PRR_kwDOAAABbcdEFG12 \
  --body "Reply from pending review" \
  -R owner/repo <pr-number>

5. Submit Review

To finalize and submit a pending review:

gh pr-review review --submit \
  --review-id PRR_kwDOAAABbcdEFG12 \
  --event APPROVE|COMMENT|REQUEST_CHANGES \
  --body "Review summary" \
  -R owner/repo <pr-number>

6. Manage Threads

List threads:

gh pr-review threads list -R owner/repo <pr-number>
gh pr-review threads list --unresolved --mine -R owner/repo <pr-number>

Resolve/unresolve threads:

gh pr-review threads resolve --thread-id PRRT_... -R owner/repo <pr-number>
gh pr-review threads unresolve --thread-id PRRT_... -R owner/repo <pr-number>

Workflow: Complete Review Cycle

  1. Start review: gh pr-review review --start ... -> save PRR_... ID
  2. Add comments: gh pr-review review --add-comment --review-id PRR_... ...
  3. View current state: gh pr-review review view ...
  4. Submit review: gh pr-review review --submit --review-id PRR_... --event REQUEST_CHANGES ...
  5. After fixes, resolve threads: gh pr-review threads resolve --thread-id PRRT_... ...

ID Types

ID Prefix Type Usage
PRR_... Review ID For --review-id in add-comment, submit, reply
PRRT_... Thread ID For --thread-id in reply, resolve, unresolve
PRRC_... Comment ID Returned with --include-comment-node-id

JSON Output Structure

All commands output structured JSON. For detailed schemas, see references/schemas.md.

Resources

references/

  • commands.md - Complete command reference with all flags and examples
  • schemas.md - JSON output schemas for each command
  • agents.md - Agent-focused workflows and best practices