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

compat-review — скилл для Claude Code: что делает и как установить

Скилл compat-review проверяет расхождения между es-toolkit/compat и lodash прямо в рантайме. Запускает тесты на PR или отдельной функции до и после правок.

MIT 238 установок ★ 11 397 обновлён 2026-10-24

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

Что делает compat-review

Скилл автоматизирует проверку пуллреквестов в репозитории es-toolkit. Он извлекает описание проблемы через gh pr view, находит целевую функцию и генерирует временный тестовый файл Vitest по пути src/compat/{category}/_compat-review-{fn}.spec.ts. В тесты попадают примеры автора PR и около 10 дополнительных краевых случаев: пустые значения, nullish, границы чисел и приведение типов.

Тест выполняется дважды с помощью yarn vitest. Сначала агент фиксирует реальное расхождение на ветке main, затем накладывает патч через git apply и проверяет, исчезла ли ошибка без поломки соседних кейсов. После проверки временный файл удаляется, изменения сбрасываются через git checkout -- ., а агент выдаёт отчёт в виде таблицы и чек-листа.

Без установленной утилиты gh и настроенного репозитория toss/es-toolkit скилл работать не сможет.

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

  • проверить утверждения автора PR о поведении lodash на реальном рантайме
  • сгенерировать краевые тесты с nullish и приведением типов для функций совместимости
  • убедиться в отсутствии регрессий перед принятием патча в es-toolkit
  • составить сводный отчёт с результатами до и после правок

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

  • Проверь пуллреквест 1234 на расхождения с lodash
  • Запусти проверку совместимости для функции chunk
  • Сравни поведение es-toolkit/compat и lodash для PR 850

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

1Через Skills CLI (Vercel)

npx skills add toss/es-toolkit --skill compat-review -a claude-code

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

~/.claude/skills/compat-review/SKILL.md

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

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

Вопросы о compat-review

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

Выполните команду npx skills add toss/es-toolkit --skill compat-review -a claude-code. Файл спецификации сохранится по пути ~/.claude/skills/compat-review/SKILL.md.

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

Он сверяет поведение функций из es-toolkit/compat с оригинальной библиотекой lodash. Агент создаёт временный файл Vitest, прогоняет тесты до и после патча и формирует отчёт.

Какие инструменты нужны агенту для работы скилла?

Скиллу требуются права на запуск Bash, Read, Write, Grep и Glob. В системе должны быть доступны gh, git и yarn.

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

SKILL.md · MIT
---
name: compat-review
description: Verify compat PR claims by running lodash vs es-toolkit/compat at runtime
argument-hint: '<PR number or function name>'
allowed-tools: Bash, Read, Write, Grep, Glob
---

# Compat Layer Review

Verify that a compat PR actually fixes a real lodash inconsistency.

## Input

$ARGUMENTS — PR number (e.g. `1234`) or function name (e.g. `chunk`)

## Workflow

### 1. Identify target function and PR claims

**PR number**:

```bash
gh pr view {number} --repo toss/es-toolkit --json title,body,files
```

From the PR description and diff, extract:

- Which compat function is being fixed
- What inconsistency the contributor claims (expected vs actual behavior)
- Any test examples the contributor provides

**Function name**: Read the function source and its spec to understand current behavior.

### 2. Build comparison test

Create a temporary vitest spec at `src/compat/{category}/_compat-review-{fn}.spec.ts`.

```typescript
import { describe, expect, it } from 'vitest';
import { fn as compatFn } from 'es-toolkit/compat';
import { fn as lodashFn } from 'lodash';
```

Include two groups of test cases:

**A. Contributor's claimed examples** — Extract directly from the PR description or test diff. These are the cases the PR claims to fix.

**B. ~10 additional edge cases you generate** — Based on the function's signature and lodash's known behavior patterns:

- Empty inputs: `[]`, `{}`, `''`, `0`
- Nullish: `null`, `undefined`
- Negative/zero/float numbers: `-1`, `0`, `1.5`, `NaN`, `Infinity`
- Type coercion: string numbers (`'3'`), boolean, mixed types
- Boundary: single-element arrays, very long strings, deeply nested objects
- Pick cases that are relevant to the specific function

Each test:

```typescript
it('description', () => {
  let lodashResult, compatResult;
  let lodashErr: any, compatErr: any;
  try {
    lodashResult = lodashFn(args);
  } catch (e) {
    lodashErr = e;
  }
  try {
    compatResult = compatFn(args);
  } catch (e) {
    compatErr = e;
  }

  if (lodashErr && compatErr) return; // both throw = consistent
  if (lodashErr || compatErr) {
    throw new Error(`Behavior mismatch: ${lodashErr ? 'lodash throws' : 'compat throws'}`);
  }
  expect(compatResult).toEqual(lodashResult);
});
```

### 3. Run comparison BEFORE the PR change

```bash
yarn vitest run src/compat/{category}/_compat-review-{fn}.spec.ts
```

Record which tests fail — these are real inconsistencies that exist on main.

### 4. Apply PR changes and re-run

```bash
gh pr diff {number} --repo toss/es-toolkit | git apply
```

Run the same test again. Confirm that:

- The contributor's claimed examples now pass
- The additional edge cases still pass (no regressions)

Revert after testing:

```bash
git checkout -- .
```

### 5. Clean up

Delete `_compat-review-*.spec.ts`.

### 6. Report

```
## {fn} — Compat Review

### PR Claim
{What the contributor says they're fixing}

### Verification (BEFORE fix)
| # | Input | lodash | compat | Match? | Source |
|---|-------|--------|--------|--------|--------|
| 1 | ...   | ...    | ...    | MISMATCH | PR example |
| 2 | ...   | ...    | ...    | MATCH    | Edge case |

### Verification (AFTER fix)
| # | Input | lodash | compat | Match? | Source |
|---|-------|--------|--------|--------|--------|

### Verdict
- [ ] PR claim is valid (inconsistency confirmed on main)
- [ ] Fix resolves the claimed inconsistency
- [ ] No regressions in edge cases
- [ ] Existing tests still pass
```

© toss · MIT · toss/es-toolkit

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

Все скиллы по теме «Код-ревью и рефакторинг» →
review-policy-author Tom Farley Субагент review-policy-author пишет и проверяет политики на языке Cedar, чтобы боты не могли без подтверждения человека мержить PR, оставлять ревью и менять конфиги CI. CX Codex ★ 42 780звёзд репо babysit thedotmack Скилл babysit для Claude Code следит за пул-реквестом: проверяет CI, комментарии и треды ревью, пока все замечания не закрыты. CX Codex +1 5 400установок pr-merge-ready weave-os Скилл pr-merge-ready закрывает замечания к пулл-реквесту за один проход: группирует правки по файлам, валидирует код один раз и не спамит комментариями в тредах. CX Codex +1 ★ 5 622звёзд репо test-guard amElnagdy Скилл test-guard для Claude Code и других агентов проверяет сгенерированные тесты на избыточность, лишние моки и совпадение с логикой проекта перед коммитом. Работает с pytest, Jest, Vitest, Go и PHPUnit. CX Codex +1 4 400установок test-quality-analysis secondsky Скилл test-quality-analysis находит овермокинг, хрупкие ассерты и флакающие тесты в проекте. Скилл помогает при код-ревью тестовых наборов и проверке тестового покрытия. CX Codex +1 478установок react-stinger Legion Code Inc. Скилл react-stinger проверяет архитектуру проектов на React 18 и 19, находит дефекты в коде, а также даёт чёткие рекомендации по серверным компонентам и хранению состояния. CX Codex +1 ★ 96звёзд репо

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

recommend Скилл recommend для Claude Code ищет функции es-toolkit по описанию задачи или фрагменту кода. Помогает выбрать готовую утилиту вместо ручной реализации. CX Codex +1 741установок guide Скилл guide помогает настроить библиотеку es-toolkit в проекте, подобрать правильный импорт и команду установки для текущего рантайма. CX Codex +1 550установок migrate Скилл migrate для Claude Code разбирает код на lodash и показывает замены на es-toolkit или es-toolkit/compat. Уменьшает бандл без ручного поиска аналогов. CX Codex +1 336установок pr-review Скилл pr-review для глубокой ревью пулл-реквестов: читает исходный код, сравнивает изменения, проверяет breaking changes и выдаёт вердикт. CX Codex +1 209установок issue-review Читает свежие GitHub Issues, расставляет лейблы, проверяет контекст кода и ищет дубликаты. Запускается командой /issue-review прямо в чате с агентом. CX Codex +1 208установок release Скилл release автоматизирует подготовку релизов: сверяет ветку, обновляет версии в файлах, собирает чейнджлог через GitHub CLI и ставит тег. CX Codex +1 208установок pr-triage Скилл pr-triage запрашивает данные о пулреквесте через GitHub CLI, классифицирует изменённые файлы и формирует план ревью с быстрыми проверками тестов и типов. CX Codex +1 207установок issue-label Скилл issue-label читает содержание GitHub-ишью, выбирает подходящий лейбл из матрицы проекта и вешает его одной командой. CX Codex +1 206установок

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

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