compat-review — скилл для Claude Code: что делает и как установить
Скилл compat-review проверяет расхождения между es-toolkit/compat и lodash прямо в рантайме. Запускает тесты на PR или отдельной функции до и после правок.
MIT 238 установок ★ 11 397 обновлён 2026-10-24
npx skills add toss/es-toolkit --skill compat-review -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/compat-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/compat-review/
1Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill compat-review -a codex2Вручную: положить файлы
.agents/skills/compat-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill compat-review -a cursor2Вручную: положить файлы
.cursor/skills/compat-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install toss/es-toolkit .claude/skills/compat-review2Вручную: положить файлы
.github/skills/compat-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill compat-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/toss/es-toolkit --path .claude/skills/compat-reviewВручную: положить файлы
.devin/skills/compat-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill compat-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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