К основному содержанию
скилл CX Codex

ns-reviewer — скилл для Claude Code: проверка кода по SOLID и безопасности

Скилл ns-reviewer проверяет качество кода перед PR: оценивает SOLID, чистоту кода, производительность, безопасность и тестируемость. Одобрит только при оценке 10, оценка 9 означает отклонение.

Apache-2.0 140 установок обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nextstage-brasil/skills --skill ns-reviewer -a claude-code
Открыть на GitHub

Что делает ns-reviewer

ns-reviewer работает как качественный шлюз: анализирует изменённые файлы по единым критериям проекта и выставляет итоговую оценку от 1 до 10. Одобрение возможно только при оценке 10 и отсутствии критических замечаний. Оценка 9 автоматически отклоняется — нужно поднять до 10.

Скилл проверяет SOLID-принципы (нарушения DRY, SSoT, OCP), безопасность экспортов и модульность кода. Если в файле расколото состояние на несколько мест, или один блок скопирован в функциях, или расширение требует редактирования трёх и более точек — оценка падает до 7. Не пишет отчёты: выдаёт только карту исправлений с конкретными находками или финальное резюме при одобрении.

Используй после изменений кода, перед PR, при закрытии задачи или в режиме просмотра PR и Issue. Зависит от ns-harness; не путай с ns-judge (проверка AC и требований) или ns-investigator (поиск корневых причин).

Какие задачи решает

  • оценить качество кода перед отправкой в PR
  • найти нарушения SOLID и дублирование логики
  • проверить правильность экспортов и модульности
  • выявить проблемы безопасности в изменённых файлах
  • получить конкретный список исправлений до одобрения

Примеры запросов агенту

  • Проверь качество этого кода перед PR
  • ns-reviewer: оцени эти изменения по SOLID и безопасности
  • Можно ли мёржить эти коммиты или нужны правки?

Как установить ns-reviewer

1Через Skills CLI (Vercel)

npx skills add nextstage-brasil/skills --skill ns-reviewer -a claude-code

2Вручную: положить файлы

~/.claude/skills/ns-reviewer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ns-reviewer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ns-reviewer

Как установить ns-reviewer в Claude Code?

Запусти npx skills add nextstage-brasil/skills --skill ns-reviewer -a claude-code, затем открой ~/.claude/skills/ns-reviewer/SKILL.md для деталей конфигурации.

Что делает ns-reviewer?

Проверяет качество кода в изменённых файлах: оценивает соответствие SOLID, чистоту, безопасность экспортов и модульность. Одобрит только при оценке 10 и нулевых критических замечаниях; оценка 9 означает отклонение.

Чем ns-reviewer отличается от ns-judge?

ns-reviewer проверяет только качество кода и выдаёт карту исправлений. ns-judge проверяет соответствие требованиям, AC и ui-contract — запускается после одобрения ns-reviewer.

Исходный текст

SKILL.md · Apache-2.0
---
name: ns-reviewer
description: "(NS) Code quality gate: SOLID, clean code, performance, security, testability. `Approved` only at score 10; score 9 = `Rejected`. Use after code changes, before PRs, at implementation closure, or code/PR/issue review — even without naming this skill. Delivery proof is ns-judge after Code Review: Approved. GitLab `ISSUE_URL`: Issue review mode. Do NOT parse requirements.md. Do NOT write code-review-report.md. Do NOT debug root-cause (ns-investigator)."
license: Apache-2.0
metadata:
  author: nextstage-brasil
  version: "2.4"
depends:
  - ns-harness
---

# Code Reviewer

Deep constructive review vs project rules. **Code only.** Delivery proof (`requirements.md` ACs, ledger, ui-contract, visual checklist) = `ns-judge` **after** `Code Review: Approved`. This skill **MUST NOT** dispatch `ns-judge`.

## Caller contract (workflow callers)

Invoker: `ns-coder`, `ns-autonomous`, `ns-execution-gitlab-issue` (direct or harness **`reviewer-agent`**):

- Caller **must** run this skill — **MUST** dispatch `reviewer-agent` when available (`../../ns-harness/references/subagent-dispatch.md`); else read this `SKILL.md` in-session. No Cursor Task personas (`senior-tech-lead-reviewer`, `bugbot`, `security-review`) or improvised review.
- Gate rules: `references/review-gate-workflow.md`.
- Every response to workflow caller **must** end exact line: `Code Review: {Approved|Rejected|Blocked}`. Overall score in **Executive Summary**.

## Session boot

See `../../ns-harness/references/session-boot.md`. **Complete Session boot (blocking)** before any other step — cold start this reviewer run; mid-session skip only if steps 1–6 done and files unchanged. Never tool-Read `AGENTS.md`.

## Workflow

1. **Session boot** — Cold start `reviewer-agent` / this skill: Session boot steps 1–6 in `session-boot.md`. Already booted same agent run (1–6 done), files unchanged: no re-read. Still judge diff vs `AGENTS.md` (in context) + project rules.
2. `git diff` (`git status` if needed).
3. Focus modified files + surrounding context.
4. Start immediately — no permission ask.

### Ad-hoc diff mode (from `ns-coder`)

Invoker passes working-tree diff only (no `ISSUE_URL`, no version-closure path):

1. Review `git diff` on working tree.
2. Apply **Score gate** + severity below.
3. Last line to parent: `Code Review: {Approved|Rejected|Blocked}`

### Version closure

1. Apply **Score gate** (SOLID, security, orphan export, actor/rules). End chat with `Code Review: {Approved|Rejected|Blocked}`.
2. **Do not** parse `requirements.md`. **Do not** walk `spec-coverage.md` / `ui-contract.md` / visual checklist — parent runs `ns-judge` after `Approved` (`../ns-judge/SKILL.md`).
3. **Do not** write `code-review-report.md` (or any persistent review report).
4. `Rejected` / `Blocked`: emit fix map per **Fix map rounds** (`references/review-fix-map.template.md`). No human prose, no positive findings, no history.
5. `Approved`: Executive Summary + score + verdict line only (no fix map). Parent may then invoke `ns-judge`.

### Issue review mode

Invoker passes `ISSUE_URL` (or `project_id` + `issue_iid`):

1. Delegate issue context to `ns-execution-gitlab-issue` context flow or `gitlab-issue-context-agent` — no `read_issue` if synthesis block provided.
2. Diff `origin/<target>...origin/<source>` from synthesis — never wrong branch.
3. **Code only.** Do not run Requirement proof / AC token scan — `ns-judge` **issue** mode after `Approved` (`--ac-file`). Producer-only unused **export** still uses orphan-export cap below.
4. **Verdict (exactly one):** `Approved` | `Rejected` | `Blocked` — **Score gate** below.
5. Post internal GitLab comment via `mcp-gitlab-usage` — first line: `Code Review | YYYY-MM-DD HH:MM (UTC) | Verdict: {Approved|Rejected|Blocked}`
6. Last line to parent: `Code Review: {Approved|Rejected|Blocked}`
7. `Rejected`/`Blocked`: GitLab comment = same fix-map facts (**Fix map rounds**).

### Fix map rounds

**Round 1 (exhaustive):** before write map, walk **every** touched file vs **Score caps** table. Emit **every** Critical **and** every Warning that would still cap score after other rows fixed — duplicate members already in a touched file each get a row (same smell class, multiple symbols). Template: `references/review-fix-map.template.md`. Omit P2 that does not block gate.

**Round 2+ (delta):** only when parent prompt says `delta` **and** names prior map IDs. Check those rows + hunks fixer changed. New Warning outside that set = round-1 miss — **do not** emit, **do not** reject for it. New Critical **inside** those hunks = only new row allowed. Else residual open IDs only.

## Score gate (all modes)

Every review **must** include overall score **1–10**. **`Approved`** = zero Criticals **and** score **= 10** only. Callers close on `Approved` — `references/review-gate-workflow.md`. Score **9** = **`Rejected`** (Lift toward 10).

| Score | Meaning | Verdict impact |
|-------|---------|----------------|
| **10** | Ship as-is | **`Approved`** (only eligible score) |
| **9** | Near-bar leftover (redundancy / non-uniform) | **`Rejected`** — Lift |
| **≤8** | Below bar / score cap | **`Rejected`** |

**`Approved` only when all true:**

1. Zero Critical findings
2. Overall score **= 10**/10

**`Rejected` when:** any Critical, **or** score ≤ **9**. AC / ledger / ui-contract proof is **not** this skill.

### Scoring unit

Score **quality of touched module/file after diff**, not hunk-alone correctness. Minimal patch leaving/worsening SSoT/DRY/OCP in file **cannot** score 9–10.

### Score caps (lowest that fits)

| Condition in touched module | Max score |
|-----------------------------|-----------|
| New/changed behavior with config/lookup **split across 2+ places** (SSoT) | **7** |
| Same resolution block copied in **2+ functions** in diff scope (DRY) | **7** |
| Predictable extension requires editing **3+ points** in same file (weak OCP, e.g. provider) | **7** |
| New/changed **exported / public** symbol (module `return { }`, `module.exports`, `export`, `public`/`public static`, window/global attach) with **no caller outside defining module** (grep: other files + same-file call sites that are not the export list) | **7** |
| Diff correct, zero Critical, mediocre / inconsistent pattern in file | **7–8** |
| gate/role helper or domain constant swapped without cited project-rule clause | **6** |

Internal/private/nested helpers **do not** count. **Do not** cap on function count. Example: 6 exported IP helpers vs 2 caller ops (`validateOriginIpInput`, `originIpMatches`); private `originIpKey` = OK.

**9:** zero Critical **and** smells above absent or resolved in touched module; predictable extension = one SSoT.

**10:** same as 9 **plus** no obvious fallback/redundancy; uniform pattern across file.

### Anti-inflation

- **Forbidden:** “minimal diff / tests pass / AC ok ⇒ 10”
- **Required** in Executive Summary: one sentence justifying score vs rubric (e.g. “cap 7 — apiKey outside preset”)

### Smell severity (SSoT / DRY / weak OCP / orphan public)

Split SSoT, duplicated resolution, **or orphan public/exported surface** in touched module ≥ **Warning**. Prefer **Warning + score cap** over auto-Critical. **Critical** for bugs, security. Score ≤ **9** forces `Rejected`. AC failures belong to `ns-judge`.

## Review priorities

Within each section, order by severity:

1. Critical (must fix before merge)
2. Warning (should fix)
3. Suggestion (consider)

Diff touches `agent-api` (or LangGraph runtime paths): load `../ns-langgraph-agents/references/anti-patterns.md`. Placement, Prompt inject, Bind parity, Spec drift, colon wire names = Critical if violated.

### AI / agent diff criteria

Keep anti-patterns delegation above. Extra criteria when diff touches agent/LLM surfaces:

| Finding | Severity |
| ------- | -------- |
| Irreversible write reachable without a gate | **Critical** |
| Prompt body changed without version bump | **Critical** |
| `UPDATE` / `DELETE` against audit history | **Critical** |
| Equality assertion on model output (exact string) instead of accepted range / contract | **Warning** + score cap **7–8** |
| New LLM call with no token/cost accounting | **Warning** (no extra score cap unless combined with other smells) |

### SOLID and clean code

- SRP, OCP, LSP, ISP, DIP
- Naming, cyclomatic complexity, error handling, dead code

### Performance, security, testability

- N+1, unnecessary renders, missing validation
- SQL injection, XSS, sensitive logs
- Coupling that blocks testing

| Finding | Severity |
| ------- | -------- |
| Secret/credential in versioned file | **Critical** |
| Test weakened/deleted to pass | **Critical** |
| Real LLM/network call reachable from default tier (no live marker, or not excluded from default run/CI) | **Critical** |
| Live-tier test without documented on-demand trigger, or credentials not from env/secret manager | **Warning** |
| Unjustified type escape hatch | **Warning** |
| New dependency or abstraction not approved in task | **Warning** |
| New code duplicates existing repo helper, stdlib/platform feature, or installed dependency | **Warning** + score cap **8** |
| Speculative option/config/wrapper not asked by task | **Warning** + score cap **8** |
| Moved/merged code lost validation or error handling | **Warning** + score cap **8** |
| New non-trivial logic (branch, loop, parser, money, security) without test | **Warning** + score cap **8** |

### Actor and gate semantics (rules-first)

Before proposing change to session gate, middleware, or role check:

- Read project rules for **named actor semantics**. Homonyms not interchangeable.
- Forbidden to swap helper by label similarity. **Critical** when rules define distinct actors.
- Diff introducing actor/gate spec never named in rules: **Warning**.
- Gate/auth fix-map must cite **project-rule clause**.

## Required output format

### Approved

### Executive Summary

- Score **10** (**Score gate** — `Approved` only at **10**)
- One sentence justifying score vs score-cap rubric
- Two-line overall assessment

Then: `Code Review: Approved`

### Rejected / Blocked

### Executive Summary

- Score 1–10
- One sentence justifying score
- Two-line overall assessment

### Fix map (agent)

Follow **Fix map rounds** + `references/review-fix-map.template.md` — actionable correction rows only.
Omit positive findings, suggestions-only noise, history, long prose.

Then: `Code Review: Rejected` or `Code Review: Blocked`

## Constraints

- **Read-only.** No edit/create/delete product files — including `code-review-report.md`
- **Not substitutable.** Workflow callers must invoke this skill by name; platform review subagents not equivalent unless human explicitly requests them this run
- Direct, constructive; no personal criticism
- No rewrite unrelated code
- Findings from actual diff + rules read
- Match project conventions visible in codebase
- Fix map audience = **another agent**, not human

## References

| File | When |
| ---- | ---- |
| `references/review-fix-map.template.md` | Rejected/Blocked response body |
| `../../ns-harness/references/artifact-layout.md` | Artifact paths |
| `mcp-gitlab-usage` | Posting internal review comments |
| `../ns-judge/SKILL.md` | Delivery proof after this skill returns `Approved` |

© nextstage-brasil · Apache-2.0 · nextstage-brasil/skills

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
code-reviewer coco-research Субагент code-reviewer для ревью кода, архитектуры и безопасности. Проверяет SOLID, DDD, уязвимости, API-дизайн и производительность перед слиянием PR. CX Codex ★ 328звёзд репо reviewer ruvnet Субагент reviewer для Claude Code проверяет изменения: логику, безопасность, скорость, стандарты и документацию, выдавая отчёт с критичными замечаниями. CX Codex ★ 850звёзд репо qa-reviewer First Fluke Субагент qa-reviewer автоматически проверяет код на уязвимости OWASP, проблемы производительности, доступность и качество. Запускается перед принятием изменений и выдаёт отчёт с рекомендациями по исправлению. CX Codex ★ 1 472звёзд репо architect-reviewer qdhenry Субагент architect-reviewer проверяет изменения в коде на архитектурную согласованность: паттерны, SOLID, зависимости. Пригодится после структурных правок и появления новых сервисов. CX Codex ★ 1 357звёзд репо code-review-specialist luongnv89 Скилл code-review-specialist проверяет pull request или фрагмент кода на уязвимости, проблемы производительности и читаемость. Выдаёт общую оценку от 1 до 5 и примеры правок. CX Codex +1 ★ 47 494звёзд репо review-code serpro69 Скилл review-code проверяет текущие изменения в git с акцентом на архитектуру SOLID и риски безопасности. Помогает найти регрессии до слияния веток. CX Codex +1 ★ 155звёзд репо

Из того же набора20

Весь набор →
ns-autonomous Скилл ns-autonomous для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который берёт локальный план или произвольный текст и выполняет его автономно в изолированном worktree. CX Codex +1 152установок ns-e2e-tests Скилл ns-e2e-tests задаёт структуру Cypress E2E-тестов, команд и сценариев для разных устройств. Нужен при создании и рефакторинге тестов. CX Codex +1 151установок ns-backend-tests Скилл ns-backend-tests для написания и запуска unit- и интеграционных тестов PHPUnit прямо в IDE. Работает только в Docker-контейнере, помогает быстро покрыть тестами новый Laravel-проект или переписать существующие тесты. CX Codex +1 151установок ns-docs-writer Скилл ns-docs-writer для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который пишет человекочитаемую документацию проекта: README, руководства в docs/, ранбуки и инструкции для контрибьюторов. CX Codex +1 151установок ns-coder Скилл ns-coder реализует небольшие изменения в коде: исправления, рефакторинг, скрипты и миграции. Он пригодится для разовой задачи вне многоэтапной разработки по SDD. CX Codex +1 151установок ns-living-spec Скилл ns-living-spec синхронизирует спецификации проекта в каталоге docs/specs/ с кодом. Обновляет доменные требования после закрытия версий или подтверждённых ревью. CX Codex +1 140установок ns-proto-visual-guide Скилл ns-proto-visual-guide для Claude Code помогает описывать внешний вид карточек, форм, оболочек и оверлеев. Включается для нормативного визуального гайда или чек-листа визуальной проверки. CX Codex +1 106установок ns-proto-creator Скилл ns-proto-creator для Claude Code, который снимает интерфейс через Playwright и создаёт или развивает прототип. Запускается для прототипирования по URL, разбора экранов и правок существующего prototype/. CX Codex +1 106установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой