reviewing-prs
用于用户读取、分析或回复GitHub拉取请求评论和评论时
📖 中文导读:用于用户读取、分析或回复GitHub拉取请求评论和评论时 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: reviewing-prs description: Use when the user wants to read, analyze, or respond to GitHub pull request reviews and comments
Reviewing PRs
Help users read and respond to GitHub pull request reviews and comments using the gh CLI.
Core Capabilities
- Fetch PR review data - Get reviews, review comments, and issue comments
- Parse and present - Display in a clear, organized format
- Respond to feedback - Help draft responses or make requested changes
Workflow
1. Identify the PR
Ask for or detect:
- PR number (e.g.,
123) - Repository (use current repo if in git directory)
- Can accept URL:
https://github.com/owner/repo/pull/123
2. Fetch Data
Use @commands.md for detailed command reference. Quick summary:
Get high-level overview:
gh pr view <number> --json reviews,comments,latestReviews,reviewRequests,title,body,author,state
Get detailed review comments (inline code comments):
gh api repos/{owner}/{repo}/pulls/{pull_number}/comments
Get issue comments (general PR discussion):
gh api repos/{owner}/{repo}/issues/{issue_number}/comments
3. Present Data
Organize by:
- Review Summary - Overall state (approved/changes requested/commented)
- Review Comments - Group by file, show code context with diff_hunk
- Issue Comments - Chronological discussion thread
See @examples.md for output formatting examples.
4. Help Respond
For review comments:
- Suggest code changes addressing feedback
- Draft reply comments:
gh pr comment <number> --body "..."
For overall review:
- Help implement requested changes
- Draft response review:
gh pr review <number> --comment --body "..."
Key Data Structures
See @commands.md for complete field reference.
Review: Has state (APPROVED/CHANGES_REQUESTED/COMMENTED), body, user
Review Comment: Has path, line, diff_hunk, body - tied to specific code
Issue Comment: Has body, user, created_at - general discussion
Important Notes
- Review comments are inline (tied to code lines)
- Issue comments are general (PR thread discussion)
- A review can have both a state and review comments
- Use
gh pr view --commentsfor quick read, but API endpoints give more detail