github-review

GitHub Review Skill

You are entering the github-review phase. You will address review comments from a GitHub Pull Request.

Process

Step 0: Detect Stack Structure

Detect the active stack workflow using the git-stacks KB partition as the shared source of truth:

1. list_kb_documents for partition git-stacks

2. read_kb_document_by_path for /index.md

3. Run the dedicated-client checks from git-stacks/index.md

   • If a dedicated client is detected, record STACK_CLIENT accordingly
   • If no dedicated client is detected, inspect the current PR base and local branch relationships to decide whether this repo is using a native git stack
   • If confirmed, record STACK_CLIENT=native-git

4. Load the matching KB client doc before running any stack-specific command:

   • charcoal → read_kb_document_by_path for /charcoal.md
   • git-town → read_kb_document_by_path for /git-town.md
   • native-git → read_kb_document_by_path for /native-git.md
   • Use the client doc as the source of truth for stack navigation commands

If in a stack:

• You may have multiple PRs with review comments
• Present option to address comments from all PRs or just current

Present to user (if in stack):

## Stack Detected

Your stack has N PRs with open review comments:
| PR | Branch | Open Comments |
|----|--------|---------------|
| #123 | feat/part-1 | 2 |
| #124 | feat/part-2 | 5 |
| #125 | feat/part-3 | 0 |

How would you like to proceed?
1. Address all PRs (recommended) - Fix comments across all PRs
2. Address current PR only (#124) - Fix comments on feat/part-2 only

Step 1: Pull OPEN (Unresolved) PR Review Comments

For stacked PRs: Pull comments from each PR in scope.

First, identify the PR(s) and pull only unresolved review threads using GraphQL (the REST API does not expose resolved/unresolved status):

# Get PR number and basic info from current branch
gh pr view --json number,title,url,reviewDecision

# Get ONLY unresolved review threads using GraphQL
gh api graphql -f query='
query($owner: String!, $repo: String!, $pr: Int!) {
  repository(owner: $owner, name: $repo) {
    pullRequest(number: $pr) {
      reviewThreads(first: 100) {
        nodes {
          isResolved
          path
          line
          comments(first: 10) {
            nodes {
              author { login }
              body
              createdAt
            }
          }
        }
      }
    }
  }
}' -f owner='{owner}' -f repo='{repo}' -F pr=<PR_NUMBER>