Notre avis

Effectue une revue de code exhaustive alimentée par OpenAI Codex, en intégrant le contexte de tickets GitHub, Linear et Sentry.

Points forts

Intégration native avec les systèmes de suivi de tickets (GitHub, Linear, Sentry) pour un contexte riche.
Options flexibles : révision des changements non commités, d'une branche, ou d'un commit spécifique.
Possibilité d'inclure un fichier de plan pour orienter l'analyse.
Sortie interactive directe dans le terminal.

Limites

Nécessite l'installation et l'authentification du CLI Codex.
Dépend de la disponibilité des API externes (Linear, Sentry) pour un contexte complet.
Le script 'review.py' doit être présent dans le projet ou accessible.

Quand l'utiliser

Utilisez cette compétence avant de créer une pull request pour obtenir une revue AI contextuelle et approfondie de vos changements.

Quand l'éviter

Évitez de l'utiliser pour des revues de code sans lien avec des tickets ou lorsqu'un simple diff sans contexte suffit.

name: review description: | Exhaustive code review using OpenAI Codex. Use when user says "review", "/review", "review my changes", or wants AI-powered code analysis. Gathers context from GitHub/Linear/Sentry issues. allowed-tools: Bash, Read, Glob, Grep

Review

Exhaustive AI-powered code review via OpenAI Codex.

When to Use

User says "review", "/review", "review my changes"
Before creating PR
After completing feature work

Workflow

1. Gather Issue References

Scan conversation for:

GitHub: #123, org/repo#123, GitHub URLs
Linear: PROJ-123, Linear URLs
Sentry: sentry:ID, Sentry URLs

2. Read Plan File (if exists)

Check for active plan in conversation or ~/.claude/plans/

3. Read Referenced Files

If user mentions @file.ts or specific files, include content.

4. Run Review

# Default: reviews uncommitted changes if any exist
./scripts/review.py codex \
  --issues "#123,PROJ-456" \
  --plan ./plan.md \
  --files "src/api.ts"

# If no uncommitted changes, prompts for branch/commit to compare

Command

./scripts/review.py codex [OPTIONS]

Options

| Option | Description | |--------|-------------| | --base, -b BRANCH | Compare against branch | | --uncommitted, -u | Review staged/unstaged/untracked changes (default if changes exist) | | --commit, -c SHA | Review specific commit | | --issues, -i REFS | Issue refs: #123, PROJ-456, sentry:ID, or URLs | | --plan, -p PATH | Plan file for context | | --files, -f PATHS | Additional files (comma-separated) | | --title, -t TEXT | Commit/PR title for summary | | --model, -m MODEL | Codex model (default: gpt-5.1-codex-max) |

Context Command

Gather context without running review:

./scripts/review.py context [OPTIONS]

| Option | Description | |--------|-------------| | --issues, -i REFS | Issue refs (comma-separated) | | --plan, -p PATH | Plan file path | | --files, -f PATHS | Additional files (comma-separated) | | --output, -o FORMAT | json or markdown (default: markdown) |

Requirements

codex CLI installed and authenticated
LINEAR_API_KEY - (optional) Linear API key for Linear issues
SENTRY_AUTH_TOKEN - (optional) Sentry auth token
SENTRY_ORG - (optional) Sentry org slug

Output

The script displays gathered context to stderr, then launches codex review interactively. Codex outputs its review directly to the terminal.

Examples

# Default: review uncommitted changes (or prompt if none)
./scripts/review.py codex

# Explicitly review uncommitted changes
./scripts/review.py codex --uncommitted

# Review changes against specific branch
./scripts/review.py codex --base main

# Review with GitHub issue context
./scripts/review.py codex --issues "#123"

# Review with plan file
./scripts/review.py codex --plan ./plan.md

# Gather context as JSON (without running review)
./scripts/review.py context --issues "#123" --output json

Révision de code exhaustive

Recommandé pour