lmiranda
e5ca804692
- Rename marketplace to lm-claude-plugins - Move MCP servers to root with symlinks - Add 6 PR tools to Gitea MCP (list_pull_requests, get_pull_request, get_pr_diff, get_pr_comments, create_pr_review, add_pr_comment) - Add clarity-assist plugin (prompt optimization with ND accommodations) - Add git-flow plugin (workflow automation) - Add pr-review plugin (multi-agent review with confidence scoring) - Centralize configuration docs - Update all documentation for v3.0.0 BREAKING CHANGE: MCP server paths changed, marketplace renamed Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
127 lines
2.9 KiB
Markdown
127 lines
2.9 KiB
Markdown
# pr-review
|
|
|
|
Multi-agent pull request review with confidence scoring and actionable feedback.
|
|
|
|
## Overview
|
|
|
|
pr-review conducts comprehensive code reviews using specialized agents for security, performance, maintainability, and test coverage. Each finding includes a confidence score to reduce noise and focus on real issues.
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/pr-review <pr#>` | Full multi-agent review |
|
|
| `/pr-summary <pr#>` | Quick summary without full review |
|
|
| `/pr-findings <pr#>` | Filter findings by category/confidence |
|
|
|
|
## Review Agents
|
|
|
|
| Agent | Focus |
|
|
|-------|-------|
|
|
| **Security Reviewer** | Injections, auth, data exposure, crypto |
|
|
| **Performance Analyst** | N+1 queries, complexity, memory, caching |
|
|
| **Maintainability Auditor** | Complexity, duplication, naming, coupling |
|
|
| **Test Validator** | Coverage, test quality, flaky tests |
|
|
|
|
## Confidence Scoring
|
|
|
|
Findings are scored 0.0 - 1.0:
|
|
|
|
| Range | Label | Action |
|
|
|-------|-------|--------|
|
|
| 0.9 - 1.0 | HIGH | Must address |
|
|
| 0.7 - 0.89 | MEDIUM | Should address |
|
|
| 0.5 - 0.69 | LOW | Consider addressing |
|
|
| < 0.5 | (suppressed) | Not reported |
|
|
|
|
## Installation
|
|
|
|
Add to your project's `.claude/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"plugins": ["pr-review"]
|
|
}
|
|
```
|
|
|
|
Requires Gitea MCP server configuration.
|
|
|
|
## Configuration
|
|
|
|
```bash
|
|
# Minimum confidence to report (default: 0.5)
|
|
PR_REVIEW_CONFIDENCE_THRESHOLD=0.5
|
|
|
|
# Auto-submit review to Gitea (default: false)
|
|
PR_REVIEW_AUTO_SUBMIT=false
|
|
```
|
|
|
|
## Usage Examples
|
|
|
|
### Full Review
|
|
|
|
```
|
|
/pr-review 123
|
|
|
|
═══════════════════════════════════════════════════
|
|
PR Review Report: #123
|
|
═══════════════════════════════════════════════════
|
|
|
|
Summary:
|
|
Files changed: 12
|
|
Lines: +234 / -45
|
|
|
|
Findings: 8 total
|
|
🔴 Critical: 1
|
|
🟠 Major: 2
|
|
🟡 Minor: 3
|
|
💡 Suggestions: 2
|
|
|
|
[Detailed findings...]
|
|
|
|
VERDICT: REQUEST_CHANGES
|
|
═══════════════════════════════════════════════════
|
|
```
|
|
|
|
### Filter Findings
|
|
|
|
```
|
|
/pr-findings 123 --category security
|
|
|
|
# Shows only security-related findings
|
|
```
|
|
|
|
### Quick Summary
|
|
|
|
```
|
|
/pr-summary 123
|
|
|
|
# Shows change overview without full analysis
|
|
```
|
|
|
|
## Output
|
|
|
|
Review reports include:
|
|
- Summary statistics
|
|
- Findings grouped by severity
|
|
- Code snippets with context
|
|
- Suggested fixes
|
|
- Overall verdict (APPROVE/COMMENT/REQUEST_CHANGES)
|
|
|
|
## Verdict Logic
|
|
|
|
| Condition | Verdict |
|
|
|-----------|---------|
|
|
| Any critical finding | REQUEST_CHANGES |
|
|
| 2+ major findings | REQUEST_CHANGES |
|
|
| Only minor/suggestions | COMMENT |
|
|
| No significant findings | APPROVE |
|
|
|
|
## Integration
|
|
|
|
For CLAUDE.md integration instructions, see `claude-md-integration.md`.
|
|
|
|
## License
|
|
|
|
MIT
|