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

code-review-playbook — скилл для Claude Code: обзор и установка

Скилл code-review-playbook задаёт правила ревью кода, шаблоны conventional comments и чеклисты безопасности. Подключается при проверке чужих пулл-реквестов или перед сдачей собственной ветки.

MIT 254 установок ★ 305 обновлён 2026-11-07

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

Что делает code-review-playbook

Скилл формализует проверку кода в репозитории через чёткие критерии качества и структуру комментариев. Внутри зашиты списки проверок на цикломатическую сложность функций (до 10), длину методов (до 50 строк), корректность именования и отсутствие дублирования. Отдельный блок закрывает базовую безопасность: проверку аутентификации эндпоинтов, валидацию входящих параметров против инъекций и поиск забытых в коде API-ключей.

Обратную связь скилл выстраивает по стандарту Conventional Comments, разделяя замечания на блокирующие и неблокирующие с метками вроде issue, suggestion или security. Для работы агенту разрешены только поисковые инструменты Read, Glob, Grep, WebFetch и WebSearch, поэтому сам скилл код не меняет.

Параметр user-invocable отключён, а для работы в Claude Code заявлена совместимость с версией 2.1.277 и выше. Если нужен полный автоматический прогон пулл-реквеста от начала до конца, автор рекомендует запускать отдельный скилл ork:review-pr.

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

  • стандартизировать формулировки замечаний через conventional comments
  • проверить ветку на утечки секретов и уязвимости инъекций перед слиянием
  • проконтролировать лимиты на длину функций и сложность логики
  • провести структурированное саморевью до создания пулл-реквеста

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

  • Проверь изменения в текущей ветке по чеклисту безопасности из code-review-playbook
  • Оформи замечания к контроллеру по стандарту conventional comments с нужными метками
  • Оцени функции в src/services/auth.ts на соответствие лимитам сложности и размера

Как установить code-review-playbook

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill code-review-playbook -a claude-code

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

~/.claude/skills/code-review-playbook/SKILL.md

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

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

Вопросы о code-review-playbook

Как установить code-review-playbook в Claude Code?

Выполните команду npx skills add yonatangross/orchestkit --skill code-review-playbook -a claude-code в терминале вашего проекта.

Что делает скилл code-review-playbook?

Он предоставляет агенту регламент ревью: критерии оценки архитектуры, лимиты сложности кода, правила разметки комментариев и списки проверок безопасности.

Чем code-review-playbook отличается от ork:review-pr?

Этот скилл служит справочником правил и чеклистов, тогда как сквозной аудит всего пулл-реквеста выполняет инструмент ork:review-pr.

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

SKILL.md · MIT
---
name: code-review-playbook
license: MIT
compatibility: "Claude Code 2.1.277+."
description: "Review process, conventional comments, language checklists and feedback templates. Use when reviewing code or standardizing review practice. To review a PR end to end, use review-pr."
context: inherit
user-invocable: false
hooks:
  PostToolUse:
    - matcher: "Write|Edit"
      hooks:
        - type: command
          command: "${CLAUDE_PLUGIN_ROOT}/hooks/bin/run-hook.mjs skill/pattern-consistency-enforcer"
effort: low
model: haiku
metadata:
  category: document-asset-creation
  version: "2.0.0"
  author: "OrchestKit"
  complexity: "low"
  tags: "code-review, quality, collaboration, best-practices, testing"
allowed-tools: "Read Glob Grep WebFetch WebSearch"
---

# Code Review Playbook
This skill provides a comprehensive framework for effective code reviews that improve code quality, share knowledge, and foster collaboration. Whether you're a reviewer giving feedback or an author preparing code for review, this playbook ensures reviews are thorough, consistent, and constructive.

## Overview
- Reviewing pull requests or merge requests
- Preparing code for review (self-review)
- Establishing code review standards for teams
- Training new developers on review best practices
- Resolving disagreements about code quality
- Improving review processes and efficiency

## Upstream coverage (do not restate)

This skill is a thin wrapper. General review craft is documented first-party elsewhere;
only OrchestKit's own decisions live here. Load `Read("references/ork-delta.md")`
for the house rules that survived the retired files.

| Topic | Go here instead |
|-------|-----------------|
| Review philosophy, speed, tone, PR sizing | https://google.github.io/eng-practices/review/ |
| Conventional comment labels and decorations | `references/conventional-comments.md`, https://conventionalcomments.org/ |
| OWASP Top 10 review checks | `rules/security-baseline.md`, https://owasp.org/Top10/ |
| Generic language and framework review checklists | `rules/typescript-quality.md`, `rules/python-quality.md`, `rules/linting-biome-rules.md` |
| Review report shape and multi-agent full-PR review | `ork:review-pr` |
| Applying findings to the working tree | `/code-review --fix`, `/simplify` (see below) |
| Security-only pass over the current branch | `/security-review` |
| GitHub review mechanics (approve, request changes, inline comments) | https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests |

---

## Conventional Comments

```
issue [blocking]: Missing error handling for API call
If the API returns a 500 error, this will crash. Add try/catch.

security [blocking]: API endpoint is not authenticated
The /api/admin/users endpoint is missing auth middleware.
```

Load `Read("references/conventional-comments.md")` for the full format, labels (praise, nitpick, suggestion, issue, question, security, bug, breaking), decorations ([blocking], [non-blocking], [if-minor]), and examples.

---

## Review Process

### 1. Before Reviewing

**Check Context:**
- Read the PR/MR description
- Understand the purpose and scope
- Review linked tickets or issues
- Check CI/CD pipeline status

**Verify Automated Checks:**
- [ ] Tests are passing
- [ ] Linting has no errors
- [ ] Type checking passes
- [ ] Code coverage meets targets
- [ ] No merge conflicts

**Set Aside Time:**
- Small PR (< 200 lines): 15-30 minutes
- Medium PR (200-500 lines): 30-60 minutes
- Large PR (> 500 lines): 1-2 hours (or ask to split)

### 2. During Review

**Follow a Pattern:**

1. **High-Level Review** (5-10 minutes)
   - Read PR description and understand intent
   - Skim all changed files to get overview
   - Verify approach makes sense architecturally
   - Check that changes align with stated purpose

2. **Detailed Review** (20-45 minutes)
   - Line-by-line code review
   - Check logic, edge cases, error handling
   - Verify tests cover new code
   - Look for security vulnerabilities
   - Ensure code follows team conventions

3. **Testing Considerations** (5-10 minutes)
   - Are tests comprehensive?
   - Do tests test the right things?
   - Are edge cases covered?
   - Is test data realistic?

4. **Documentation Check** (5 minutes)
   - Are complex sections commented?
   - Is public API documented?
   - Are breaking changes noted?
   - Is README updated if needed?

### 3. After Reviewing

**Provide Clear Decision:**
- ✅ **Approve**: Code is ready to merge
- 💬 **Comment**: Feedback provided, no action required
- 🔄 **Request Changes**: Issues must be addressed before merge

**Respond to Author:**
- Answer questions promptly
- Re-review after changes made
- Approve when issues resolved
- Thank author for addressing feedback

---

## Review Checklists

### General Code Quality

- [ ] **Readability**: Code is easy to understand
- [ ] **Naming**: Variables and functions have clear, descriptive names
- [ ] **Comments**: Complex logic is explained
- [ ] **Formatting**: Code follows team style guide
- [ ] **DRY**: No unnecessary duplication
- [ ] **SOLID Principles**: Code follows SOLID where applicable
- [ ] **Function Size**: Functions are focused and < 50 lines
- [ ] **Cyclomatic Complexity**: Functions have complexity < 10

### Security

- [ ] **Authentication**: Protected endpoints require auth
- [ ] **Authorization**: Users can only access their own data
- [ ] **Input Sanitization**: SQL injection, XSS prevented
- [ ] **Secrets Management**: No hardcoded credentials or API keys
- [ ] **Encryption**: Sensitive data encrypted at rest and in transit
- [ ] **Rate Limiting**: Endpoints protected from abuse

---

## Quick Start Guide

**For Reviewers:**
1. Read PR description and understand intent
2. Check that automated checks pass
3. Do high-level review (architecture, approach)
4. Do detailed review (logic, edge cases, tests)
5. Use conventional comments for clear communication
6. Provide decision: Approve, Comment, or Request Changes

**For Authors:**
1. Write clear PR description
2. Perform self-review before requesting review
3. Ensure all automated checks pass
4. Keep PR focused and reasonably sized (< 400 lines)
5. Respond to feedback promptly and respectfully
6. Make requested changes or explain reasoning

---

## CC Built-in Review Commands (2.1.152+)

This playbook is the manual framework; Claude Code ships built-in commands that automate parts of it:

- **`/code-review`** — reviews the current diff for correctness bugs and reuse/simplification/efficiency cleanups.
- **`/code-review --fix`** (CC 2.1.152+) — runs the review then applies the findings to your working tree (a bug-hunting review covering correctness plus reuse/simplification/efficiency).
- **`/code-review --comment`** — posts findings as inline PR comments.
- **`/simplify`** — **CC 2.1.154 changed this**: it now runs a **cleanup-only** review (reuse, simplification, efficiency, altitude) and applies the fixes — it no longer invokes the full `/code-review --fix` bug-hunt. Reach for `/simplify` for tidy-ups, `/code-review --fix` for bug-finding-plus-fix.

Use the built-ins for fast diff-scoped passes; use `ork:review-pr` for the multi-agent, full-PR review (security + testing + architecture).

---

**Skill Version**: 2.0.0
**Last Updated**: 2026-01-08
**Maintained by**: OrchestKit

## Related Skills

- `ork:architecture-patterns` - Enforce testing and architectural best practices during code review
- `ork:security-patterns` - Auth, input validation, and OWASP patterns to complement manual review
- `ork:testing-unit` - Unit testing patterns to verify during review

## Rules

Each category has individual rule files in `rules/` loaded on-demand:

| Category | Rule | Impact | Key Pattern |
|----------|------|--------|-------------|
| TypeScript Quality | `rules/typescript-quality.md` | HIGH | No `any`, Zod validation, exhaustive switches, React 19 |
| Python Quality | `rules/python-quality.md` | HIGH | Pydantic v2, ruff, mypy strict, async timeouts |
| Security Baseline | `rules/security-baseline.md` | CRITICAL | No secrets, auth on endpoints, input validation |
| Linting | `rules/linting-biome-setup.md` | HIGH | Biome setup, ESLint migration, gradual adoption |
| Linting | `rules/linting-biome-rules.md` | HIGH | Biome config, type-aware rules, CI integration |

**Total: 5 rules across 4 categories**

## Available Scripts

- **`scripts/review-pr.md`** - Dynamic PR review with auto-fetched GitHub data
  - Auto-fetches: PR title, author, state, changed files, diff stats, comments count
  - Usage: `review-pr [PR-number]`
  - Requires: GitHub CLI (`gh`)
  - Uses `$ARGUMENTS` and `!command` for live PR data

- **`assets/pr-template.md`** - PR description template

There is deliberately no review-report template here; `ork:review-pr` owns that output
shape. See `references/ork-delta.md`.

© OrchestKit · MIT · yonatangross/orchestkit

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

Все скиллы по теме «Код-ревью и рефакторинг» →
gjalla-code-review gjalla Скилл gjalla-code-review проверяет PR и диффы перед слиянием с позиций архитектора, инженера по безопасности и QA. Группирует замечания по степени критичности. CX Codex +1 865установок code-review jwynia Скилл code-review для Claude Code помогает искать дефекты и оценивать качество кода. Он включается по просьбе проверить код, подготовить PR или провести ревью. CX Codex +1 505установок pr-review-expert borghei Скилл pr-review-expert для Claude Code и Codex анализирует последствия правок в пулл-реквестах перед слиянием. Проверяет затронутые зависимости, бреши безопасности и поломки контрактов API. CX Codex +1 118установок code-review-and-quality addyosmani Скилл code-review-and-quality для Claude Code и других платформ проводит многоосное ревью кода по пяти критериям перед слиянием изменений. Запускается перед мёрджем любых веток и ПР. CX Codex +1 92 300установок om-auto-review-pr open-mercato Скилл om-auto-review-pr для Claude Code проверяет код или спецификацию в pull request по его номеру. Запускает изолированный worktree, ставит вердикт и передаёт замечания автору либо запускает автоисправление. CX Codex +1 4 700установок review-pr dbpolito Скилл review-pr разбирает пул-реквесты в CI: ищет дефекты, сверяется с прошлыми обсуждениями и публикует замечания построчно. CX Codex +1 4 300установок

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

Весь набор →
distributed-systems Скилл distributed-systems для Claude Code — справочник паттернов для распределённых блокировок, circuit breaker, идемпотентности и ограничения запросов. CX Codex +1 297установок monitoring-observability Скилл monitoring-observability для Claude Code настраивает метрики Prometheus, дашборды Grafana и трейсинг Langfuse v4. Включается при добавлении логирования, распределённой трассировки и подсчёта расходов на LLM. CX Codex +1 270установок vite-advanced Скилл vite-advanced для Claude Code и Codex настраивает сборку Vite 8 на Rolldown, разделение чанков и Environment API. Включается при правке vite.config.* или файлов в каталогах **/vite/**. CX Codex +1 265установок quality-gates Скилл quality-gates оценивает сложность задач от 1 до 5 и останавливает агента при тупиках или оверинжиниринге. Включается перед запуском фич и после неудачных попыток решения. CX Codex +1 259установок python-backend Скилл python-backend для Claude Code и Codex подтягивает правила асинхронного бэкенда на Python при работе с файлами *.py и манифестами зависимостей. Настраивает связку FastAPI, SQLAlchemy 2.0 и asyncio. CX Codex +1 250установок accessibility Скилл accessibility для Claude Code помогает добавлять доступность в веб-интерфейсы. Активируется при работе с клавиатурной навигацией, экранными дикторами и ARIA-компонентами. CX Codex +1 246установок memory-fabric Скилл memory-fabric для Claude Code управляет поиском по графу знаний, парсит запросы, объединяет дубликаты и ранжирует факты. Включается при отладке внутренней логики памяти агента. CX Codex +1 244установок multimodal-llm Скилл multimodal-llm для Claude Code и Codex подбирает архитектурные паттерны для работы со зрением, речью и генерацией видео. Агент подключает его при распознавании изображений, транскрипции аудио и вызовах видео-API. CX Codex +1 243установок

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

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