guide: Command for Claude Code

Detect the current branch's pull request and resolve its unresolved review comments. This command auto-detects the PR from the current Git branch, fetches unresolved review threads via GraphQL, classifies each comment, implements valid changes, replies with explanations, pushes, and resolves addressed threads.

For commit conventions, refer to the Git Flow rule. For lint verification, refer to the CI/CD rule.

Pre-flight

Step 1 -- Verify GitHub CLI authentication

gh auth status

If this fails, report the error and stop. The gh CLI must be installed and authenticated.

Step 2 -- Detect repository context

gh repo view --json nameWithOwner -q '.nameWithOwner'

Split the result into {owner} and {repo}.

Step 3 -- Auto-detect PR from current branch

gh pr view --json number,headRefName -q '.number'

This returns the PR number associated with the current branch. If it fails (no PR exists for the current branch), report: "No pull request found for the current branch. Switch to a branch with an open PR or create one first." and stop.

Store the returned number as {PR_NUMBER}. Then ensure the local branch is up to date:

git pull --rebase

Procedure

Step 4 -- Fetch unresolved review threads

Use the GitHub GraphQL API:

gh api graphql -f query='
  query($owner: String!, $repo: String!, $pr: Int!) {
    repository(owner: $owner, name: $repo) {
      pullRequest(number: $pr) {
        reviewThreads(first: 100) {
          nodes {
            id
            isResolved
            comments(first: 10) {
              nodes {
                databaseId
                body
                path
                line
                startLine
                author { login }
              }
            }
          }
        }
      }
    }
  }
' -f owner="{owner}" -f repo="{repo}" -F pr={PR_NUMBER}

Filter to threads where isResolved is false. If no unresolved threads exist, report "No unresolved review threads found on PR #{PR_NUMBER}." and stop.