grill — плагин для Claude Code: ревью кода шестью агентами
Плагин grill запускает шесть специализированных агентов (архитектура, ошибки, безопасность, тесты, граничные случаи, разведка) параллельно, сводит находки в отчёт с метками серьёзности, ссылками на строки и планом исправления.
ISC ★ 10 обновлён 2026-10-01
/plugin marketplace add anthropics/claude-plugins-community
/plugin install grill@claude-communityЧто делает grill
Каждый агент отвечает за свою зону: recon строит карту кодовой базы, architecture разбирает структуру, error-handling проверяет обработку ошибок и наблюдаемость, security ищет уязвимости, testing оценивает покрытие и CI/CD, edge-cases гонит граничные условия и гонки. Выбираешь один из пяти стилей ревью (от быстрого Architecture Review до Paranoid Mode) и восемь дополнительных тестов давления — на масштабирование, скрытые издержки, нарушения принципов, метрики успеха. Отчёт группирует находки по серьёзности ([CRITICAL], [HIGH], [MEDIUM], [LOW]), каждая с путём к файлу, номерами строк и оценкой трудозатрат. План исправления фазирует работу, строит граф зависимостей и суммирует усилия.
Все агенты делят общее ядро grill-core, которое задаёт формат находок, стандарты доказательств и правило недоверия к вводу. Если проблем нет, агент вернёт [GOOD] — накрутка ради количества запрещена. Работает и в Claude Code (агенты параллельно), и в OpenAI Codex CLI (скиллы последовательно), одна кодовая база на двух платформах.
Какие задачи решает
- проверить архитектуру проекта на слабые места и скрытые издержки
- найти уязвимости, гонки данных и граничные случаи до продакшена
- получить план исправления с оценкой трудозатрат и графом зависимостей
- провести ревью в пяти стилях — от быстрого обзора до параноидального режима
- запустить восемь тестов давления на масштаб, метрики и принципы
Примеры запросов агенту
- Запусти
/grill:roastв корне проекта, чтобы шесть агентов параллельно проверили архитектуру, ошибки, безопасность и граничные случаи. - Проверь только каталог
src/командой/grill:roast src/— остальное не трогай. - Выбери стиль Paranoid Mode и добавь тест давления на скрытые издержки, чтобы агент
edge-casesтоже запустился.
Как установить grill
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install grill@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о grill
Как установить grill в Claude Code?
Добавь маркетплейс командой /plugin marketplace add anthropics/claude-plugins-community, затем установи плагин /plugin install grill@claude-community. Вариант через маркетплейс xiaolai даёт последнюю версию на сутки раньше.
Что делает grill?
Запускает шесть агентов параллельно (разведка, архитектура, ошибки, безопасность, тесты, граничные случаи), каждый анализирует свою зону. Сводит находки в отчёт с метками серьёзности, путями к файлам, строками, оценкой трудозатрат и планом исправления по фазам.
Чем стили ревью отличаются друг от друга?
Architecture Review даёт быстрый обзор структуры, Hard-Nosed Critique жёстко разбирает решения, Multi-Perspective Panel сводит взгляды всех агентов, ADR Style оформляет находки как архитектурные решения, Paranoid Mode добавляет агента edge-cases для гонок и граничных условий. Все стили работают с теми же агентами — меняется формат синтеза.
Исходный текст
SKILL.md · ISC
# grill
[](https://github.com/xiaolai/grill-for-claude/blob/main/nlpm-badge.json)
Deep codebase interrogation — multi-angle architecture review that forces rigorous, actionable analysis. **Works in both Claude Code and OpenAI Codex CLI.**
## What it does
Grill launches 5-6 specialized analysis units in parallel to interrogate your codebase from every angle: architecture, error handling, security, testing, and edge cases. You pick a review style, optionally add pressure tests, and get a comprehensive report with a prioritized fixing plan.
- **6 specialized analysis units**: recon, architecture, error-handling, security, testing, edge-cases (shipped as agents under Claude Code, as skills under Codex)
- **5 review styles**: Architecture Review, Hard-Nosed Critique, Multi-Perspective Panel, ADR Style, Paranoid Mode — plus a "Select All" option
- **8 add-on pressure tests**: scale stress, hidden costs, principle violations, strangler fig migration, success metrics, before/after diagrams, assumptions audit, compact & optimize
- **Evidence-based findings**: every finding requires file paths, line references, severity tags, and effort estimates
- **Fixing plan**: phased action plan (Critical > High > Medium > Low) with dependency graph and effort totals
Part of the [xiaolai plugin marketplace](https://github.com/xiaolai/claude-plugin-marketplace).
## Installation
### Claude Code
Two install paths — both reach the same code. Pick one:
**Via Anthropic's official community marketplace** (curated; updates lag the maintainer's marketplace by up to ~24h):
```
/plugin marketplace add anthropics/claude-plugins-community
/plugin install grill@claude-community
```
**Via the xiaolai marketplace** (latest version lands here first):
```
/plugin marketplace add xiaolai/claude-plugin-marketplace
/plugin install grill@xiaolai
```
> **Install fails with "Plugin not found in marketplace 'xiaolai'"?** Your local marketplace clone is stale. Run `claude plugin marketplace update xiaolai` and retry — `plugin install` does not auto-refresh. (The community marketplace doesn't have this caveat.)
| Scope | Command (xiaolai) | Effect |
|-------|--------------------|--------|
| **User** (default) | `/plugin install grill@xiaolai` | Available in all your projects |
| **Project** | `/plugin install grill@xiaolai --scope project` | Shared with team via `.claude/settings.json` |
| **Local** | `/plugin install grill@xiaolai --scope local` | Only you, only this repo |
The same `--scope` flags work with the `@claude-community` variant.
### OpenAI Codex CLI
Codex installs plugins from a marketplace via an **in-session TUI**, not a shell command. There is no `codex plugin install` verb.
**One-time setup** (shell):
```bash
codex plugin marketplace add xiaolai/claude-plugin-marketplace
```
**Per-plugin install** (inside a Codex session):
1. Start a session: `codex` (in your project directory)
2. Type `/plugins` — opens the plugin TUI
3. Find grill in the `xiaolai` marketplace, install/enable it
## Usage
### In Claude Code: slash command
```
/grill:roast
```
Optionally target a subdirectory: `/grill:roast src/`
### In OpenAI Codex CLI: skill invocation
Codex uses the `$skill-name` syntax, not slash commands. Type either:
```
$grill-roast
```
Or just describe the task in natural language ("do a multi-angle audit of this codebase") and Codex's auto-match will load the skill from its description.
> **Why the difference?** Claude Code maps a plugin's `commands/*.md` files to slash commands like `/grill:roast`. Codex deprecated custom prompts in favor of skills (description-matched on intent), so the same orchestration is shipped as a skill under Codex's layout.
## How it works
1. **Recon** — the recon unit surveys the codebase (structure, stack, size)
2. **Choose review style** — pick from 5 styles + optional add-on pressure tests
3. **Deep dive** — 4-5 analysis units run, each analyzing their specialty area (parallel under Claude Code, sequential under Codex)
4. **Synthesis** — findings are deduplicated, attributed, and formatted per the chosen style
5. **Report** — a markdown report with executive summary and phased fixing plan is saved to the target directory
## Analysis units
| Unit | Focus | Claude name | Codex name |
|------|-------|-------------|------------|
| Recon | Quick codebase survey (structure, stack, dependencies) | `recon` agent | `$grill-recon` skill |
| Architecture | Core architecture analysis | `architecture` agent | `$grill-architecture` skill |
| Error handling | Error handling & observability | `error-handling` agent | `$grill-error-handling` skill |
| Security | Security surface analysis | `security` agent | `$grill-security` skill |
| Testing | Testing & CI/CD analysis | `testing` agent | `$grill-testing` skill |
| Edge cases | Race conditions, boundary values, failure modes (Paranoid Mode) | `edge-cases` agent | `$grill-edge-cases` skill |
All units share the `grill-core` skill, which defines severity tags, finding format, evidence standards, and the untrusted-input rule.
## Severity tags
- `[CRITICAL]` — Security vulnerability, data loss risk, correctness bug
- `[HIGH]` — Significant reliability, maintainability, or performance impact
- `[MEDIUM]` — Noticeable quality issue, not urgent
- `[LOW]` — Minor improvement, address when touching the file
- `[GOOD]` — Positive finding worth calling out
## License
ISC
### Quick by default
The roast entry runs a bounded review in the current context by default, with at most three evidence-backed findings. Request a full panel or named style explicitly for the multi-agent workflow. A clean result is valid; finding counts are never a quality target.
© xiaolai · ISC · xiaolai/grill-for-claude