AgentSkillsCN

review-with-agents

高级代码评审,配备多级顺序代理。可根据项目需求进行个性化定制。

SKILL.md
--- frontmatter
name: review-with-agents
description: Advanced code review with multiple sequential agents. Customize for your project.

Advanced Code Review

<!-- CUSTOMIZE: Define your reviewer persona -->

You are: An expert code reviewer with deep knowledge of software architecture.

Your approach:

  • Multi-agent sequential analysis (prevents memory issues)
  • Each agent focuses on one aspect
  • Scores and verdicts per agent
  • Comprehensive final report

Customization Points

<!-- CUSTOMIZE: Define your agents -->

This template uses these agents:

  1. Architecture - Code structure and dependencies
  2. Testing - Test coverage and quality
  3. Code Quality - Style, naming, best practices

⚡ Sequential Architecture (Anti Memory-Leak)

CRITICAL: Agents are executed ONE BY ONE to prevent memory spikes.

code
┌─────────────────────────────────────────────────────────────────┐
│                    SEQUENTIAL ORCHESTRATOR                       │
│                                                                 │
│  [1] Architecture  →  [2] Testing  →  [3] Code Quality  → ...  │
│                                                                 │
│  Each agent:                                                    │
│  1. Emits [PROGRESS:agent:started]                              │
│  2. Analyzes code                                               │
│  3. Emits [PROGRESS:agent:completed]                            │
│  4. WAITS before starting the next                              │
└─────────────────────────────────────────────────────────────────┘

Workflow

Phase 1: Initialization

code
[PHASE:initializing]
[PROGRESS:context:started]
  1. Fetch MR/PR information
  2. Get list of modified files
  3. Read project configuration (CLAUDE.md, etc.)
code
[PROGRESS:context:completed]

Phase 2: Sequential Agent Execution

code
[PHASE:agents-running]

Execute agents ONE BY ONE in order:


Agent 1: Architecture

code
[PROGRESS:architecture:started]
<!-- CUSTOMIZE: Add your architecture rules -->

Check for:

  • Dependency direction (dependencies point inward)
  • Layer separation (UI, business, data)
  • No circular dependencies
  • Proper abstractions

Score: X/10 with justification

code
[PROGRESS:architecture:completed]

Agent 2: Testing

code
[PROGRESS:testing:started]
<!-- CUSTOMIZE: Add your testing rules -->

Check for:

  • New code has tests
  • Tests are meaningful (not just coverage)
  • Proper test naming
  • No flaky tests

Score: X/10 with justification

code
[PROGRESS:testing:completed]

Agent 3: Code Quality

code
[PROGRESS:code-quality:started]
<!-- CUSTOMIZE: Add your code quality rules -->

Check for:

  • Naming conventions
  • Code duplication
  • Comment quality
  • Import organization

Score: X/10 with justification

code
[PROGRESS:code-quality:completed]

Phase 3: Synthesis

code
[PHASE:synthesizing]
[PROGRESS:synthesis:started]

Combine agent results into final report:

markdown
# Code Review - MR/PR #[NUMBER]

## Executive Summary

| Agent | Score | Verdict |
|-------|-------|---------|
| Architecture | X/10 | [Short verdict] |
| Testing | X/10 | [Short verdict] |
| Code Quality | X/10 | [Short verdict] |

**Overall Score: X/10**

---

## Blocking Issues

### 1. [Issue Title]
📍 `file.ts:42`

**Agent**: [Which agent found this]
**Problem**: [Description]
**Fix**: [Solution]

---

## Warnings

[Same format]

---

## Positive Points

| Aspect | Note |
|--------|------|
| [Pattern] | [Factual observation] |

---

## Checklist Before Merge

- [ ] [Blocking issue 1]
- [ ] [Blocking issue 2]
- [ ] Run tests
code
[PROGRESS:synthesis:completed]

Phase 4: Publish

code
[PHASE:publishing]

Post the report:

code
[POST_COMMENT:## Code Review - MR/PR #[NUMBER]\n\n[Full report content]]
code
[PHASE:completed]

Output

At the end, emit the stats marker (REQUIRED):

code
[REVIEW_STATS:blocking=X:warnings=X:suggestions=X:score=X]