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

engineering-small-prs — скилл для Claude Code

Скилл engineering-small-prs раскладывает крупную фичу, рефакторинг или миграцию на маленькие PR: с порядком мержа, тестами и планом отката.

MIT 133 установок ★ 635 обновлён 2026-09-29

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

Что делает engineering-small-prs

Скилл включается, когда изменение не влезает в одно ревью: большая фича, рефакторинг, миграция. Код он не пишет. Вместо этого строит план: формулирует конечный результат одной фразой, выписывает независимые изменения, находит зависимости и предлагает последовательность PR, где каждый оставляет сборку зелёной.

Внутри набор стратегий разбиения: сначала тесты на текущее поведение, потом рефакторинг без смены поведения, вертикальные срезы по видимой функциональности, отдельные PR под конфиг и под механические правки. Для миграций заложена схема expand/contract с обратной совместимостью, бэкфиллом, переключением трафика и уборкой старого в отдельном PR. Ответ приходит таблицей: номер PR, цель, зависимости, тесты, заметки ревьюеру.

Ревьюер вправе отклонить PR только из-за размера — на этих правилах скилл и построен. Ещё он не берётся за полное код-ревью, описание PR и правки в одном файле. Перед рискованным крупным изменением советует заранее заручиться согласием ревьюера.

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

  • разбить огромный диф на ревьюабельные PR
  • выстроить порядок мержа так, чтобы сборка не падала
  • спланировать миграцию схемы через expand/contract с откатом
  • отделить рефакторинг от спрятанного в нём изменения поведения
  • получить согласие ревьюера до отправки крупного PR

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

  • Разбей этот диф на ревьюабельные куски, одним PR его не отревьюить.
  • Составь план стека PR для миграции схемы: порядок деплоя, валидация и откат.
  • Рефакторинг слишком большой для одного ревью — как разбить и в каком порядке мержить?

Как установить engineering-small-prs

1Через Skills CLI (Vercel)

npx skills add agentara/skills --skill engineering-small-prs -a claude-code

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

~/.claude/skills/engineering-small-prs/SKILL.md

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

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

Вопросы об engineering-small-prs

Как установить engineering-small-prs в Claude Code?

Выполните npx skills add agentara/skills --skill engineering-small-prs -a claude-code. Скилл окажется в ~/.claude/skills/engineering-small-prs/SKILL.md.

Что делает engineering-small-prs?

Планирует разбиение крупной фичи, рефакторинга или миграции на небольшие самодостаточные PR и выдаёт таблицу с порядком мержа, тестами и зависимостями.

Скилл делает код-ревью или пишет описание PR?

Нет. Полное ревью, описание PR и правки в одном файле в его триггеры не входят: он занимается разбиением и последовательностью изменений.

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

SKILL.md · MIT
---
name: engineering-small-prs
description: >
  Use when planning, splitting, shrinking, or sequencing large features, refactors, migrations, or pull requests into
  small reviewable PRs or CLs. TRIGGER on "split this PR", "this diff is too large", "stacked PRs",
  "change sequence", "reviewable chunks", "migration plan", "how should I break this up?", or implementation
  scope too broad for one review. DO NOT TRIGGER for full code review, PR description writing, or tiny one-file edits
  that already form one self-contained change.
---

# Engineering Small PRs

Small PRs are easier to review thoroughly, safer to merge, easier to roll back, and less likely to waste work if the direction changes. "Small" means conceptually focused and self-contained, not merely a low line count.

Adapted from Google Engineering Practices Documentation, especially "Small CLs." Source: <https://google.github.io/eng-practices/review/developer/small-cls.html>. License: CC-BY 3.0.

## Definition of a Good Small PR

A good PR:

- Makes one self-contained change.
- Includes the tests needed to validate that change.
- Leaves the system working after merge.
- Gives reviewers enough context in the PR, description, existing code, or earlier reviewed PRs.
- Is not so tiny that the behavior cannot be understood. A new API usually needs at least one usage in the same PR.
- Separates large refactors from behavior changes unless the cleanup is very local.

Reviewers may reasonably reject a PR solely because it is too large to review well.

## Splitting Workflow

1. Name the final outcome in one sentence.
2. List independent behavior changes, refactors, schema/config changes, tests, and docs.
3. Identify dependencies that must land earlier.
4. Choose split strategies from the section below.
5. Build a merge sequence where every PR keeps the build green.
6. Add context notes so reviewers understand how each PR fits into the larger work.
7. For risky or unavoidable large changes, get reviewer consent before sending the PR.

## Split Strategies

- Preparatory tests first: add missing tests around existing behavior before risky refactors.
- Refactor first: move, rename, extract, or simplify code without changing behavior.
- Vertical slices: deliver one small user-visible or API-visible behavior end-to-end.
- Horizontal slices: add shared interfaces, protocol definitions, or adapters only when paired with a real first usage in the same PR or a clearly linked dependent PR already under review.
- File or owner groups: split files by reviewer expertise when the changes are otherwise self-contained.
- Config separately: keep rollout configuration, experiments, or deployment wiring separate from code when rollback timing differs.
- Generated or mechanical changes separately: isolate trusted automated rewrites from hand-written logic.
- Deletions separately when useful: removing dead code can be a compact, easy-to-review PR.

## Migration Safety

For schema, data, API, or infrastructure migrations, prefer an expand/contract sequence:

1. Expand: add backward-compatible schema/API/config support without removing old behavior.
2. Dual path: write or read both paths only when needed, with observability for divergence.
3. Backfill: migrate existing data with progress tracking, retry behavior, and validation.
4. Cut over: switch traffic or callers after validation proves both paths are safe.
5. Contract: remove old schema, code paths, flags, and compatibility shims in a cleanup PR.

Each migration PR should state deployment order, rollback behavior, validation signal, and what must not happen until the next PR lands.

## Output Template

```markdown
## Goal
[Final outcome]

## Proposed PR Sequence
| # | PR | Purpose | Depends On | Tests | Reviewer Notes |
|---|----|---------|------------|-------|----------------|
| 1 | Add characterization tests for ... | Protect existing behavior before refactor | None | ... | ... |
| 2 | Extract ... without behavior change | Prepare smaller implementation | 1 | ... | ... |
| 3 | Implement ... vertical slice | User-visible behavior | 2 | ... | ... |

## Migration Safety
- Expand/contract phase:
- Backfill/validation:
- Observability:
- Rollback:

## Build Safety
- Each PR keeps:
- Rollback notes:

## Large-Change Risk
- What could not be split:
- Reviewer consent needed:
```

## Heuristics

- Prefer a PR that is smaller than you think necessary; reviewers rarely object to focused changes.
- If a PR spreads a small logical change across many files, treat it as larger than the line count suggests.
- If the reviewer needs substantial future context to understand the PR, the sequence is probably missing an earlier preparatory PR or a better description.
- If you cannot split the PR, make it extra easy to review: stronger tests, clearer description, explicit risk, and prior reviewer agreement.

## Common Mistakes

- Mixing broad formatting changes with functional logic.
- Landing a new abstraction with no real usage.
- Creating a stacked sequence where intermediate PRs break the build.
- Hiding risky behavior change inside a "refactor" PR.
- Waiting for one PR to merge before starting the next when a safe stacked workflow is available.

© agentara · MIT · agentara/skills

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

Все скиллы по теме «Код-ревью и рефакторинг» →
batch-review-prs-awaiting-maintainer dyoshikawa Скилл batch-review-prs-awaiting-maintainer для Claude Code пакетно разбирает открытые пулреквесты: находит блокеры, отправляет замечания авторам, чистые ветки сливает, мелкие правки фиксирует в задачах. CX Codex +1 ★ 1 636звёзд репо stacked-prs Abdulrahman Qabbout Плагин stacked-prs делит большую ветку на несколько небольших PR, протаскивает правки из ревью по всей цепочке и мержит их по порядку зависимостей. CX Codex ★ 1 596звёзд репо om-review-prs open-mercato Скилл om-review-prs собирает открытые PR, которым нужно ревью, и прогоняет по каждому полный цикл om-auto-review-pr, начиная с самых новых. Запускается в начале дня как очередь ревью. CX Codex +1 3 600установок merge-open-prs jssblck Скилл merge-open-prs для Claude Code собирает список открытых PR, выбирает порядок и сливает их через GitHub. Последовательно обрабатывает несколько PR. CX Codex +1 1 700установок prs-awaiting-author dyoshikawa Скилл prs-awaiting-author показывает открытые пул-реквесты, по которым следующий шаг за автором: упал CI, не отвечены замечания ревью, ждёт ответа вопрос мейнтейнера. CX Codex +1 ★ 1 636звёзд репо antfu-simplify Anthony Fu Скилл antfu-simplify для Claude Code и Codex уменьшает текущий diff ветки или рабочей копии через абляцию, убирая лишние слои абстракции. CX Codex +1 312установок

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

Весь набор →
soviet-storybook-grotesque Скилл soviet-storybook-grotesque превращает снимки в гротескные книжные иллюстрации с дрожащими контурами, блёклой акварелью и абсурдными подписями. CX Codex +1 190установок feature-dev-loop Скилл feature-dev-loop для Claude Code оркестрирует разработку фичи от декомпозиции требований до TDD-реализации, приёмки и HTML-отчёта. Охватывает задачи масштаба пулреквеста. CX Codex +1 187установок publish-research-site Скилл publish-research-site для Claude Code превращает тему или тезис в интерактивный сайт с источниками и изображениями и развёртывает его через Vercel CLI. Публикует отчёты и истории. CX Codex +1 142установок torn-paper-collage-poster Скилл torn-paper-collage-poster составляет промпты и пайплайны генерации постеров в стиле журнального коллажа из рваной бумаги, скотча и штампов. CX Codex +1 135установок engineering-code-review Скилл engineering-code-review организует инженерное ревью пуллреквестов и локальных диффов по стандартам Google. Проверяет архитектуру, тесты, риски и выносит формальный вердикт. CX Codex +1 131установок engineering-review-comments Скилл engineering-review-comments помогает ревьюеру превратить черновые заметки в комментарии к пул-реквесту: метка важности, причина замечания и конкретное требование к автору. CX Codex +1 125установок engineering-review-feedback Скилл engineering-review-feedback учит агента работать с комментариями ревьюеров как автор изменений: применять правки, отвечать на замечания, разрешать разногласия. CX Codex +1 124установок engineering-change-descriptions Скилл engineering-change-descriptions пишет и переписывает описания PR, сообщения коммитов и сводки изменений: что поменялось, зачем и как это проверили. CX Codex +1 124установок

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

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