SkillFoxx
Telegram

gap-trap — скилл

Скилл, который один раз читает репозиторий и ставит проверки: правила кода становятся шлюзами, которые ломают коммит или CI.

  • 180 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл читает весь репозиторий и добавляет проверки и CI-задачи, которые блокируют коммиты и сборки.
  • Неверно выбранные контракты ломают пайплайн всех следующих сессий, поэтому их нужно вычитывать.
Все причины и проверки

pliablepixels/gap-trapАвтор:pliablepixels

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/gap-trap

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл читает весь репозиторий и добавляет проверки и CI-задачи, которые блокируют коммиты и сборки.
  • Неверно выбранные контракты ломают пайплайн всех следующих сессий, поэтому их нужно вычитывать.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

gap-trap запускают один раз в репозитории. Он изучает код, формулирует правила, подходящие этому проекту, и к каждому правилу добавляет шлюз: проверку, которая валит коммит или прогон CI при нарушении. Агент не может ее обойти. Скилл ставит четыре вещи. Контракты описывают части кода с единственным верным способом, будь то HTTP, логирование, настройки или авторизация: что использовать, чего избегать и какая проверка ловит обход. Доказанный красный тест — CI-задача, которая гоняет каждый новый тест на старом коде и падает, если тест там проходит. Храповики считают известные проблемы, например долг линтера или файлы длиннее 400 строк, и разрешают только уменьшение. Плейбуки хранят то, что проект узнал на практике. Для Node и Python шлюзы встраиваются в набор тестов, для остальных языков идут версии на shell с git, grep и awk. Заодно скилл ставит родственный slop-mop, чтобы документы и коммиты читались как написанные человеком.

Для кого. Командам, где большую часть кода пишет агент и где диффы уже никто не читает построчно, но качество не должно дрейфовать.

Подходит, если

  • Агент дублирует хелперы, которые уже есть, и нарушает границы слоев ради короткого пути.
  • Тесты проверяют, что код выполнился, а не что он сделал правильно.
  • Правила лежат в CLAUDE.md, но агент забывает их через неделю.
  • В репозитории копится долг линтера, и его нужно зажать храповиком.

Не подходит, если

  • Проект маленький, и достаточно одного файла с инструкциями.
  • Нет времени вычитывать сгенерированные контракты: их надо проверять обязательно.
  • Доступна только слабая модель: скилл останавливается на всем, что меньше топовой.

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

Запусти gap-trap в этом репозитории, предложи контракты для HTTP, логирования и настроек и добавь шлюзы в CI.

Ограничения

Скилл работает на лучшей кодинговой модели хоста: Opus или выше в Claude Code, топовая модель с высоким уровнем рассуждения в Codex. На меньших моделях он останавливается, поскольку неверный выбор контрактов бьет по всем следующим сессиям. Сгенерированные правила и контракты необходимо вычитать человеку до коммита. Каждый push в `main` выпускает новую версию, обновление идет через `npx skills update gap-trap` либо заменой каталога вручную. Родственный slop-mop заработает только в сессии после той, где он установлен.

Как отключить. Удалите каталог `gap-trap` из `~/.claude/skills/` (для Codex из `~/.agents/skills/`). Добавленные шлюзы и CI-задачи в репозитории уберите вручную.

Частые вопросы

Как установить gap-trap?

Командой `npx skills add pliablepixels/gap-trap` либо вручную: клонировать репозиторий и скопировать каталог `gap-trap` в `~/.claude/skills/` (для Codex в `~/.agents/skills/`).

Что такое шлюз?

Проверка, которая валит коммит или прогон CI при нарушении правила. Агент не может ее пропустить, в отличие от текстовой инструкции.

Какие языки поддержаны?

Любые. Для Node и Python шлюзы встраиваются в набор тестов, для Go, Rust, Java, Ruby, .NET, PHP, Swift и C++ идут shell-версии на git, grep, awk и вашей команде тестов.

Что такое доказанный красный тест?

CI-задача запускает каждый новый тест на старом коде и падает, если тест проходит. Тест, который не может упасть, ничего не доказывает.

Как обновить скилл?

Командой `npx skills update gap-trap`. При ручной установке обновите клон и замените копию целиком, чтобы удаленные в апстриме файлы не остались.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл состязательного аудита кода: Hunter ищет ошибки, Skeptic их оспаривает, Referee выносит вердикт, а правки без вашего разрешения не вносятся

СкиллРасширенный доступ558

Скилл evidence-code-review для Codex и Claude Code: ревью изменений по доказательствам, с уровнями MUST, SHOULD, BETTER и NITS

СкиллМинимальный доступ89

CLI и MCP для проверки скиллов: повторяемые тесты на YAML, сравнение отчетов, поиск регрессий и процесс skilled-improve

CLIРасширенный доступ72

Плагин Claude Code заставляет агента проверять код вокруг правки и доказывать работу тестом и независимым ревью до слова «готово»

ПлагинРасширенный доступ121

Скилл ведет Claude Code и Codex через пишущий и чинящий цикл автотестов API на pytest с проверкой реальным запуском.

СкиллРасширенный доступ174

33 скилла инженерной дисциплины для Claude Code, Codex и Gemini CLI плюс vibe-cli для CI: ревью, тесты, покрытие, выкладка и откат

СкиллРасширенный доступ163

Коротко о README

Проект разбирает дрейф качества в репозитории с кодом от агента и решает его проверками вместо текстовых правил. Перечислены четыре артефакта, требования к модели и порядок обновления. Рядом лежат справочники по обнаружению, структуре, шлюзам и доработке и шаблоны AGENTS.md и CLAUDE.md.

Бейдж для README

Исходный SKILL.md

---
name: gap-trap
description: Use when asked to set up, install, or refine an agent quality framework in a repository (rules with gates, architecture contracts, proven-red tests, ratchets, playbooks), or when the user says "gap-trap", "gap-trap setup", "gap-trap refine", "gate the rules", or "make the agents' code match the rules".
---

# gap-trap

Sets up a quality framework for repositories where agents write most of
the code. Every rule the agents follow has a gate that fails a commit, a
push, or a CI run when the rule breaks. A rule a script could check but
that names no gate is a defect. The framework is the one described in
`reference/framework.md`; read it before either mode.

Two modes: `setup` builds the framework in a repo that has none.
`refine` audits a repo that has it and proposes the next rules and gates
from what broke. Bare `gap-trap` with no keyword means `setup` when the
repo has no `AGENTS.project.md`, otherwise `refine`. A hand-written
`AGENTS.md` or `CLAUDE.md` on its own is input to setup, not a sign the
framework exists.

## Model gate

This skill runs on the top coding model of your harness: in Claude Code,
Opus or a more capable model (Opus 4.8 or newer, Opus 5, Fable, Mythos);
in Codex, the frontier coding model at high or xhigh reasoning effort.
Discovery decides which parts of a codebase get a contract, and a wrong
contract costs every later session. Your system prompt names your model.

If it is a cheaper or faster tier (Sonnet, Haiku, a mini model, or low
reasoning effort), stop. Read nothing, write nothing. Say exactly this
and end the turn:

> gap-trap runs on the top coding model of this harness. You are on
> <model name>. Switch with `/model`, then run gap-trap again.

Do not dispatch stronger subagents from a weaker orchestrator, start
"the easy parts", or offer a lighter version.

## setup

Сообщить о проблеме