SuperAPI AI Directory

respond-to-code-review

Testing & quality

View repository

Updated 10-15 21:37

About this skill

Respond to code review

Work from the actual review comments and current code. Verify claims before changing code or replying.

Scope

  • If the user asks only to check or summarize comments, collect and assess them, then report findings. Do not edit code or post replies.
  • If the user asks to address or respond to comments, apply verified fixes, run relevant checks, and reply as authorized.
  • Identify the pull request or merge request from the link, number, current branch, or repository context. Ask only if more than one target remains plausible.
  • Use the team's existing authenticated tools. If GitHub CLI is missing and would help, read the optional one-time setup guide; offer it to the user rather than assuming they want it installed.

Workflow

Required on every use: Identify the review platform and read its procedure before collecting feedback: GitHub, GitLab, or Bitbucket. Read the matching reference even if you have used this skill before; it contains the platform's collection, reply, and resolution steps. Skip the other platforms' references; read a one-time setup guide only when setup is needed.

  1. Collect all feedback. Read review summaries, inline comments and replies, unresolved threads, and CI status. Check for newer comments after the last push. Human and bot reviewers vary by repository; never assume Copilot, Codex, Claude, or any other bot is configured.
  2. Verify each finding. Inspect the relevant code and reproduce the behavior or run a focused check where possible. For claims about a library or API, consult current documentation. Mark each finding as valid, already addressed, unclear, or unsupported; explain the evidence for anything not changed.
  3. Make focused fixes when requested. Follow the repository's branch, commit, and test rules. Keep independent fixes reviewable. Do not change unrelated behavior to satisfy a comment, and do not claim a fix until its relevant check passes.
  4. Respond to the review. Post one consolidated reply covering every finding, with fixes, evidence, and reasons for items not changed. This is the default even when findings came from several reviewers. Reply in individual threads only when the user asks, or the platform or repository requires thread-specific replies or resolution. Avoid duplicate replies.
  5. Check readiness. Confirm the latest checks and review status. Merge only when the user has authorized merging, including authorization already given in the conversation. Addressing comments alone does not authorize a merge.

If a finding remains unclear after checking code and documentation, or reviewers contradict each other or a user decision, explain the conflict and ask for the missing decision. Never apply an unverified suggestion merely to close a thread.

Waiting for reviews

Wait only for reviewers that were requested or are expected from the repository's known configuration. A reaction, reviewing comment, or changed review-request state indicates activity; allow more time and check again. An explicit decline ends that wait. With no activity, check up to three times about 3–4 minutes apart, then report that no review has appeared yet and stop polling. Use a timer or background monitor when available instead of blocking the task. Never claim a bot review passed merely because no comment appeared. If the user wants to enable optional reviewers, see review bot setup; setup is separate from responding to existing feedback.

Reply format

For each finding, give its location or reviewer reference and one of:

  • Fixed: the change, evidence from a test or check, and commit if available.
  • Already addressed: where the existing code or earlier commit handles it.
  • Not changed: the specific reason and supporting code or documentation.
  • Needs decision: the unresolved question and its effect on the PR or MR.

Keep the reply short enough to scan. Resolve threads only after their findings are addressed and the team's workflow permits it.