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

check · juliusbrussee — скилл проверки дрейфа спецификации для Claude Code

Скилл читает SPEC.md и сравнивает его с кодом. Ничего не пишет, только сообщает о расхождениях по степеням важности.

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

Что делает check

Спецификация тихо расходится с кодом — это главный провал в разработке через спецификации. check ловит такой дрейф. Запускайте его после каждого /build и перед выпуском: расхождение, найденное здесь, — это диф; расхождение, найденное в проде, — это уже баг.

Скилл читает SPEC.md. Если файла нет, работа останавливается. Дальше он разбирает аргументы запуска: §V проверяет только инварианты (это режим по умолчанию), §I — интерфейсы, §T — статус задач против кода, --all — все три раздела. Для каждого инварианта скилл формулирует проверяемое утверждение о коде, ищет по файлам и помечает результат: HOLD, VIOLATE или UNVERIFIABLE. Для интерфейсов — MATCH, DRIFT, MISSING или EXTRA. Для задач — сверяет отметку x с фактическим кодом и помечает строки без подтверждения как STALE.

Отчёт выходит скупым, сгруппированным по важности: адрес, файл и строка с доказательством. В конце — по одной подсказке на каждый класс нарушений. Скилл предлагает починить код или вызвать скилл spec с bug:, но сам ничего не запускает. Записей ноль: ни правок SPEC.md, ни правок кода, ни субагентов. Оценок и баллов тоже нет — по каждому пункту только двоичный ответ: держится или дрейфует.

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

  • Спецификация расходится с кодом незаметно, и вы узнаёте об этом уже в проде
  • После правок кода никто не сверяет инварианты и интерфейсы со SPEC.md
  • Отметки о выполненных задачах в спецификации устаревают и не совпадают с реальными файлами

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

  • проверь дрейф между спецификацией и кодом
  • проверь инварианты из §V
  • сверь интерфейсы из §I с реализацией

Как установить check

1Через Skills CLI (Vercel)

npx skills add JuliusBrussee/cavekit --skill check -a claude-code

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

~/.claude/skills/check/SKILL.md

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

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

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

caveman Скилл переводит записи в SPEC.md и рядом с ним на телеграфный «пещерный» язык. Токенов уходит примерно на 75% меньше, чем в обычной прозе. CX Codex +1 2 800установок spec Создаёт и обновляет файл SPEC.md в корне проекта, фиксируя цели, инварианты, задачи и найденные баги в лаконичном стиле caveman. CX Codex +1 2 700установок build Выполняет задачи из SPEC.md по схеме «план, реализация, проверка». Подходит для работы с конкретной задачей §T или очередью незавершённых задач. CX Codex +1 2 700установок backprop Скилл превращает исправление багов в обновление спецификации SPEC.md. Агент находит причину ошибки, формулирует проверяемый инвариант, пишет падающий тест и фиксирует всё одним коммитом. CX Codex +1 2 600установок grill Задаёт точечные вопросы по одному за раз, чтобы отсеять слабые места в идее фичи до составления спецификации. CX Codex +1 793установок review Проводит враждебную ревизию спецификации до того, как написан код. Строит скептичного рецензента и пытается опровергнуть план, а не подписать его. CX Codex +1 787установок research Собирает факты из документации и RFC во внешний журнал §R со ссылками на источники, чтобы агент не выдумывал поведение библиотек. CX Codex +1 786установок deepen Находит поверхностные модули с громоздкими интерфейсами и проектирует глубокую архитектуру. Запускается, когда тесты зелёные и остался неизрасходованный бюджет токенов. CX Codex +1 770установок

Другие версии check

Похожие

arch-check codewithmukesh Сверяет кодовую базу с заявленной архитектурой: направление зависимостей, нарушения слоёв, утечки между модулями и циклы. Пригодится перед релизом или после крупной фичи. CX Codex +1 2 800установок indexion-sdd trkbt10 Скилл превращает RFC или спецификацию в SDD-требования и количественно сверяет их с кодом. Пригодится, когда реализацию надо удержать в рамках документа. CX Codex +1 5 000установок tlc-spec-driven Felipe Rodrigues - github.com/felipfr Организует разработку фич по спецификации через четыре фазы: Specify, Design, Tasks и Execute. Автоматически подбирает глубину и проверяет гейты скриптами на Python. CX Codex +1 1 200установок health-check codewithmukesh Прогоняет .NET-проект по восьми осям и ставит буквенные оценки A–F с общим GPA. Пригодится при онбординге, перед релизом и после уборки кода. CX Codex +1 2 800установок check-compiler-errors cursor Скилл запускает команды компиляции и проверки типов, собирает ошибки по файлам и категориям, потом чинит их по приоритету. Нужен, когда локальная валидация или CI блокируется на типах. CX Codex +1 2 300установок indexion-documentation trkbt10 Скилл оценивает покрытие документации, ищет расхождения между кодом и доками и рисует граф зависимостей. CX Codex +1 5 000установок

Рядом в теме «Код-ревью и рефакторинг»

Всё по теме «Код-ревью и рефакторинг» →

Вопросы о check

Что делает скилл check?

Сравнивает SPEC.md с текущим кодом и сообщает о расхождениях, сгруппированных по важности. Ничего не пишет и не правит.

Как установить check в Claude Code?

Командой npx skills add JuliusBrussee/cavekit --skill check -a claude-code. Файл скилла окажется в ~/.claude/skills/check/SKILL.md.

Скилл сам исправляет нарушения?

Нет. Он только сообщает и подсказывает, что делать: починить код или вызвать скилл spec. Правки не запускаются.

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

SKILL.md · MIT
---
name: check
description: |
  Read-only drift detector. Diffs SPEC.md against current code and reports
  violations grouped by severity. Writes nothing — suggests remedies via
  the spec or build skills but never invokes them. Triggers when the user
  asks to check drift, audit the spec, verify invariants, or ask whether
  code still matches the spec. Phrasings: "check drift", "audit the spec",
  "does the code still match §V", "check invariants", "spec vs code".
---

# check — drift report

Pure diagnostic. Reports violations. Writes nothing. User decides remedy.

Spec drifting silently from code is the #1 SDD failure mode. check is the
detector. Run it after each `/build` and before each ship — drift caught here is
a diff; drift caught in prod is a §B.

## LOAD

1. Read `SPEC.md`. If missing → "no spec, nothing to check." Stop.
2. Parse invocation args:
   - `§V` → check invariants only (default)
   - `§I` → check interfaces
   - `§T` → audit task status vs code
   - `--all` → all three

## CHECK §V — invariants

For each V<n>:

1. Translate invariant into verifiable claim about code.
2. Grep / read relevant files.
3. Classify: **HOLD** / **VIOLATE** / **UNVERIFIABLE**.
4. Record address + file:line evidence.

## CHECK §I — interfaces

For each I item:

1. Locate implementation.
2. Classify:
   - **MATCH** — shape in code = shape in spec.
   - **DRIFT** — impl exists, shape differs.
   - **MISSING** — impl absent.
   - **EXTRA** — code exposes surface not in §I.

## CHECK §T — tasks

For each T<n>:

1. If `x`: verify claimed work present.
2. If `~`: note as in-progress.
3. If `.`: note as pending.
4. Flag `x` rows with no evidence as **STALE**.

## REPORT

Caveman. Grouped by severity.

```
## §V drift
V2 VIOLATE: auth/mw.go:47 uses `<` not `≤`. see §B.1.
V5 UNVERIFIABLE: no test covers ∀ req path.

## §I drift
I.api DRIFT: POST /x returns `{result}` not `{id}`. route.go:112.
I.cmd MISSING: `foo bar` absent from cli/*.go.

## §T drift
T3 STALE: status `x`, no middleware file exists.

## summary
2 violate. 1 missing. 1 stale. 1 unverifiable.
next: spec skill with `bug:` or fix code at cited lines.
```

## REMEDY HINTS (not actions)

End report with one-line hint per class:
- VIOLATE / DRIFT → invoke spec skill `bug: <V.n>` or fix code.
- MISSING → invoke build skill on `§T.n` if task exists; else spec skill `amend §T`.
- STALE → spec skill `amend §T` to uncheck.
- EXTRA → spec skill `amend §I` to document, or delete code.

Never invoke fixes. Report only.

## NON-GOALS

- Zero writes. No SPEC.md edits. No code edits.
- No sub-agents. Main thread reads.
- No scores, no grades. Binary per item: holds or drifts.

© JuliusBrussee · MIT · JuliusBrussee/cavekit

Смотрите также

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

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