/github-code-review

name: github-code-review
description: Comprehensive GitHub code review with AI-powered swarm coordination

GitHub Code Review Skill

> **AI-Powered Code Review**: Deploy specialized review agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis.

🎯 Quick Start

Simple Review

# Initialize review swarm for PR
gh pr view 123 --json files,diff | npx ruv-swarm github review-init --pr 123

# Post review status
gh pr comment 123 --body "🔍 Multi-agent code review initiated"

Complete Review Workflow

# Get PR context with gh CLI
PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
PR_DIFF=$(gh pr diff 123)

# Initialize comprehensive review
npx ruv-swarm github review-init \
  --pr 123 \
  --pr-data "$PR_DATA" \
  --diff "$PR_DIFF" \
  --agents "security,performance,style,architecture,accessibility" \
  --depth comprehensive

---

📚 Table of Contents

<details> <summary><strong>Core Features</strong></summary>

• [Multi-Agent Review System](#multi-agent-review-system)
• [Specialized Review Agents](#specialized-review-agents)
• [PR-Based Swarm Management](#pr-based-swarm-management)
• [Automated Workflows](#automated-workflows)
• [Quality Gates & Checks](#quality-gates--checks)

</details>

<details> <summary><strong>Review Agents</strong></summary>

• [Security Review Agent](#security-review-agent)
• [Performance Review Agent](#performance-review-agent)
• [Architecture Review Agent](#architecture-review-agent)
• [Style & Convention Agent](#style--convention-agent)
• [Accessibility Agent](#accessibility-agent)

</details>

<details> <summary><strong>Advanced Features</strong></summary>

• [Context-Aware Reviews](#context-aware-reviews)
• [Learning from History](#learning-from-history)
• [Cross-PR Analysis](#cross-pr-analysis)
• [Custom Review Agents](#custom-review-agents)

</details>

<details> <summary><strong>Integration & Automation</strong></summary>

• [CI/CD Integration](#cicd-integration)
• [Webhook Handlers](#webhook-handlers)
• [PR Comment Commands](#pr-comment-commands)
• [Automated Fixes](#automated-fixes)

</details>

---

🚀 Core Features

Multi-Agent Review System

Deploy specialized AI agents for comprehensive code review:

# Initialize review swarm with GitHub CLI integration
PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
PR_DIFF=$(gh pr diff 123)

# Start multi-agent review
npx ruv-swarm github review-init \
  --pr 123 \
  --pr-data "$PR_DATA" \
  --diff "$PR_DIFF" \
  --agents "security,performance,style,architecture,accessibility" \
  --depth comprehensive

# Post initial review status
gh pr comment 123 --body "🔍 Multi-agent code review initiated"

**Benefits:**

• ✅ Parallel review by specialized agents
• ✅ Comprehensive coverage across multiple domains
• ✅ Faster review cycles with coordinated analysis
• ✅ Consistent quality standards enforcement

---

🤖 Specialized Review Agents

Security Review Agent

**Focus:** Identify security vulnerabilities and suggest fixes

# Get changed files from PR
CHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')

# Run security-focused review
SECURITY_RESULTS=$(npx ruv-swarm github review-security \
  --pr 123 \
  --files "$CHANGED_FILES" \
  --check "owasp,cve,secrets,permissions" \
  --suggest-fixes)

# Post findings based on severity
if echo "$SECURITY_RESULTS" | grep -q "critical"; then
  # Request changes for critical issues
  gh pr review 123 --request-changes --body "$SECURITY_RESULTS"
  gh pr edit 123 --add-label "security-review-required"
else
  # Post as comment for non-critical issues
  gh pr comment 123 --body "$SECURITY_RESULTS"
fi

<details> <summary><strong>Security Checks Performed</strong></summary>

{
  "checks": [
    "SQL injection vulnerabilities",
    "XSS attack vectors",
    "Authentication bypasses",
    "Authorization flaws",
    "Cryptographic weaknesses",
    "Dependency vulnerabilities",
    "Secret exposure",
    "CORS misconfigurations"
  ],
  "actions": [
    "Block PR on critical issues",
    "Suggest secure alternatives",
    "Add security test cases",
    "Update security documentation"
  ]
}

</details>

<details> <summary><strong>Comment Template: Security Issue</strong></summary>

🔒 **Security Issue: [Type]**

**Severity**: 🔴 Critical / 🟡 High / 🟢 Low

**Description**:
[Clear explanation of the security issue]

**Impact**:
[Potential consequences if not addressed]

**Suggested Fix**:
```language
[Code example of the fix]

**References**:

• [OWASP Guide](link)
• [Security Best Practices](link)

</details>

---

### Performance Review Agent

**Focus:** Analyze performance impact and optimization opportunities

```bash
# Run performance analysis
npx ruv-swarm github review-performance \
  --pr 123 \
  --profile "cpu,memory,io" \
  --benchmark-against main \
  --suggest-optimizations

<details> <summary><strong>Performance Metrics Analyzed</strong></summary>

{
  "metrics": [
    "Algorithm complexity (Big O analysis)",
    "Database query efficiency",
    "Memory allocation patterns",
    "Cache utilization",
    "Network request optimization",
    "Bundle size impact",
    "Render performance"
  ],
  "benchmarks": [
    "Compare with baseline",
    "Load test simulations",
    "Memory leak detection",
    "Bottleneck identification"
  ]
}

</details>

---

Architecture Review Agent

**Focus:** Evaluate design patterns and architectural decisions

# Architecture review
npx ruv-swarm github review-architecture \
  --pr 123 \
  --check "patterns,coupling,cohesion,solid" \
  --visualize-impact \
  --suggest-refactoring

<details> <summary><strong>Architecture Analysis</strong></summary>

{
  "patterns": [
    "Design pattern adherence",
    "SOLID principles",
    "DRY violations",
    "Separation of concerns",
    "Dependency injecti