GitHub PR Creation

Create a pull request from the current branch using gh pr create.

# Inspect branch state (check commits ahead of base)
git status --short --branch
git log --oneline --decorate

# Create and push branch if needed
git checkout -b <branch>
git push -u origin <branch>

# Write PR body
cat > /tmp/pr-body.md << 'EOF'
## Description

<!-- Please include a summary of the changes and the related issue. Please also include relevant motivation and context. -->

Fixes # (issue)

## Type of change

<!-- Please delete options that are not relevant. -->

- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation update

## Test

<!-- How was this tested? -->

---

Assisted-by: {HARNESS_NAME}:${MODEL_NAME}
EOF

# Create PR with labels
gh pr create \
  --draft \
  --base main \
  --head <branch> \
  --title "<title>" \
  --body-file /tmp/pr-body.md \
  --label "<label>"

Best Practices

• Always open PRs as drafts (--draft). Mark as ready only when the user explicitly asks you to do so.
• Labels: Always include --label when creating PRs. Choose based on repository conventions (e.g., bug, enhancement, documentation, chore)
• Branch names: Use type prefixes like feat/, fix/, chore/ followed by a short description
• Summarize the user-facing change first.
• Always append Assisted-by: {HARNESS_NAME}:${MODEL_NAME} to the PR body.

Minimize PR Comments

Minimize (fold/hide) all comments on a PR created by a specific user. Uses the GitHub GraphQL API minimizeComment mutation with OUTDATED classifier. Covers three types of comments:

1. Issue comments (top-level PR comments) — IC_* node_id
2. Review comments (inline file comments on a review) — PRRC_* node_id
3. Pull request reviews (summary review body) — PRR_* node_id

Step 1: Find comments to minimize

# Issue comments (top-level PR comments)
gh api "/repos/{owner}/{repo}/issues/{pr_number}/comments" \
  --jq '.[] | select(.user.login == "{username}" and (.body | startswith("## PR Self-Test Report"))) | {id, node_id, body_preview: .body[0:100]}'

# Inline review comments (file-level)
gh api "/repos/{owner}/{repo}/pulls/{pr_number}/comments" \
  --jq '.[] | select(.user.login == "{username}") | {id, node_id, path, body_preview: .body[0:80]}'

# PR reviews (summary-level)
gh api "/repos/{owner}/{repo}/pulls/{pr_number}/reviews" \
  --jq '.[] | select(.user.login == "{username}") | {id, node_id, body_preview: (.body // "")[0:100], state}'

Step 2: Minimize via GraphQL

# For each comment's node_id, run:
gh api graphql -f query='
  mutation($subjectId: ID!, $classifier: ReportedContentClassifiers!) {
    minimizeComment(input: {subjectId: $subjectId, classifier: $classifier}) {
      minimizedComment {
        isMinimized
        minimizedReason
      }
    }
  }
' -F subjectId="{node_id}" -F classifier=OUTDATED

Step 3: Verify

# Check one comment via GraphQL
gh api graphql -f query='
  query {
    node(id: "{node_id}") {
      ... on IssueComment { isMinimized minimizedReason }
      ... on PullRequestReviewComment { isMinimized minimizedReason }
      ... on PullRequestReview { isMinimized minimizedReason }
    }
  }
'

Tips

• OUTDATED is the recommended classifier for old test reports and stale review comments.
• Filter by select(.user.login == "{username}") to only target comments by a specific user.
• Use startswith("## PR Self-Test Report") to target only self-test report comments.
• Issue comments use IC_* node_id prefix, review comments use PRRC_*, and PR reviews use PRR_*.
• The minimizeComment mutation works on all three types uniformly.