ai-review

name	ai-review
switches	["`analyse` - fetch the PR review and recommend fix/skip decisions; default when no `N=fix` or `N=skip` argument is present.","`execute` - apply the requested fix/skip decisions and route results back to the right PR location.","`N=fix` / `N=skip` - per-issue execute decisions, for example `1=fix 2=skip`; presence auto-selects execute mode.","`--source=copilot` - force GitHub Copilot agent review parsing and thread reply/resolve behavior.","`--source=other` - force non-Copilot review routing through PR description AI review notes."]
description	Analyze and execute AI PR review feedback with fix/skip decisions. Use when a user asks to parse an AI review, apply selected fixes, and finalize review processing for GitHub or Azure DevOps pull requests. Detects the review source — for a GitHub Copilot agent review it replies to and resolves each linked review thread; otherwise it appends AI review notes to the PR description **and (MANDATORY) writes every skipped finding into the PR description's "Skip Areas / Known Issues" bullets** so the next review round does not re-raise them.
allowed-tools	["Bash(.agents/skills/ai-review/scripts/copilot-review.sh:*)","Bash(${CLAUDE_PLUGIN_ROOT}/.agents/skills/ai-review/scripts/copilot-review.sh:*)","Bash(gh api:*)","Bash(gh pr:*)","Bash(git add:*)","Bash(git commit:*)","Bash(git push:*)"]
models	{"claude":"sonnet","copilot":"auto","codex":"gpt-5.4"}

AI PR Review Analyzer & Executor

Analyze AI PR review feedback and execute fix/skip decisions.

Script location. Every .agents/skills/ai-review/... path in this document assumes the skill is installed in the repository (copy-install or this repo itself). When this skill runs from the Claude Code plugin (smooth-ai-review), the repository has no .agents/skills/ai-review tree — substitute ${CLAUDE_PLUGIN_ROOT}/.agents/skills/ai-review for .agents/skills/ai-review in every script invocation (e.g. "${CLAUDE_PLUGIN_ROOT}/.agents/skills/ai-review/scripts/copilot-review.sh" detect <pr>).

Invocation

The skill is invoked as /ai-review <args>.

Mode selection:

1. Explicit keyword as the first argument: analyse or execute.
2. Auto-detect when no keyword is given:
   • If any argument matches \d+=(fix|skip) → execute mode.
   • Otherwise → analyse mode.

Examples:

/ai-review 48                              # auto → analyse
/ai-review analyse 48                      # explicit analyse
/ai-review 48 1=fix 2=skip                 # auto → execute
/ai-review execute 48 1=fix 2=skip         # explicit execute

Review source selection (GitHub):

The skill must determine whether the review being processed is a GitHub Copilot agent review or a review from another source (e.g. an OpenCode CLI agent, Gemini, or a generic AI reviewer). The source decides where execute results land — see Execute → Result routing.

1. Explicit switch: --source=copilot or --source=other.
2. Auto-detect when no switch is given (the default): run the helper and use its verdict —

   .agents/skills/ai-review/scripts/copilot-review.sh detect <pr>   # prints COPILOT or OTHER
   

   It scans the PR's reviews and inline review comments for the Copilot reviewer bot (login Copilot / copilot-pull-request-reviewer[bot]). COPILOT → Copilot flow; → other.