| name | post-review-comments |
| description | Post line-level review comments and an overall review comment on a PR in English with a natural, concise writing style |
target_pr = the user's request
If target_pr is not provided, use the PR of the current branch.
Step 1: Understand the PR
Read the PR diff and description to understand:
- What changed and why
- The scope and impact of the changes
Step 2: Prepare Line-Level Comments
Identify specific lines in the diff that deserve feedback — bugs, potential issues, style concerns, suggestions for improvement, or questions about intent.
For each comment, note:
- The file path
- The line number (in the new version of the file)
- Your comment text
Step 3: Prepare an Overall Review Comment
Write a brief overall assessment of the PR. This is a summary-level comment, not a repeat of line-level feedback.
Step 4: Post the Review
Use a single gh api call to submit both line-level comments and the overall comment together as one review:
gh api repos/{owner}/{repo}/pulls/{pr_number}/reviews \
--method POST \
-f event="COMMENT" \
-f body="<overall comment>" \
-f 'comments[]={...}' ...
Each line comment requires: path, line (line number in the diff's new file), and body.
If you have no line-level comments, fall back to:
gh pr review <pr_number> --comment --body "<overall comment>"
Writing Style
Write in English only.
Style guidelines — write like a human teammate, not a bot:
- Use plain paragraphs. Avoid headings (
##), horizontal rules (---), and excessive bullet lists.
- Keep it conversational and direct. Say what matters, skip the filler.
- Do not use phrases like "Great work!" or "LGTM!" unless you genuinely mean it and have nothing else to add.
- Be honest. If something looks off, say so clearly but respectfully.
- Short is fine. A two-sentence comment is better than a five-paragraph essay with no substance.
Step 5: Report
Output the PR number, a count of line-level comments posted, and a brief summary of the overall comment.
