Comprende — плагин
Плагин заставляет агента объяснять свой код и перед пушем задавать вопросы, чтобы вы понимали, что вливаете.
- 65 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хуки блокируют пуш и слияние без отчета о проверке.
- В репозиторий добавляются шлюз, проверка в CI и MCP-сервер, который помнит, что вы уже знаете.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/comprendeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки блокируют пуш и слияние без отчета о проверке.
- В репозиторий добавляются шлюз, проверка в CI и MCP-сервер, который помнит, что вы уже знаете.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Comprende делает две вещи. Первая работает в любом проекте: агент кратко объясняет написанный код на вашем языке, но только то, что стоит объяснения, то есть новые API, неочевидную логику и опасные места. Вторая включается в репозитории по желанию и называется проверкой владения. Перед пушем агент задает от одного до шести вопросов об изменении, на неверный ответ дает пояснение и новый вопрос, а краткое описание pull request вы пишете сами. Без этого пуш и слияние блокируются. Отчет сохраняется в `.learning/checks/` и идет в тот же коммит. Для проверки есть шлюз `.learning/`, проверка в CI и хуки для Claude Code, Cursor и Codex.
Для кого. Командам и разработчикам, которые не хотят вливать код ИИ без понимания и хотят подтвержденное понимание перед слиянием.
Подходит, если
- Агент пишет debounce для поиска, и по ответу видно, что новое и опасное.
- Тимлид включает шлюз владения командой в чате «Enable the ownership gate in this repo».
- Перед пушем разработчик отвечает на вопрос об изменении и пишет описание PR.
- Чувствительные пути вроде авторизации и платежей всегда получают вопросы.
Не подходит, если
- Нужны только объяснения, а блокировка пуша мешает потоку.
- Команда не готова принять обязательную проверку в CI.
- Работаете в Windows, где плагин пока экспериментальный.
Пример запроса к агенту
Включи шлюз владения в этом репозитории и подготовь PR с проверкой в CI.Ограничения
Нужен Node.js версии 20 или новее. Установка нужна отдельно в каждом инструменте, кроме Cursor рядом с Claude Code: Cursor сам запускает плагины Claude Code. В Windows плагин экспериментален во всех трех средах. В Codex после установки и после каждого обновления нужно заново доверить два хука командой `/hooks`, иначе Codex пропускает их без предупреждения, хотя git-хук и CI продолжают проверять. Для обязательной проверки нужны права администратора GitHub.
Как отключить. Удалите плагин командой вашей среды и уберите из репозитория каталог `.learning/`, проверку в CI и хуки. Требование защиты ветки снимите в настройках GitHub.
Частые вопросы
Как поставить плагин в Claude Code?
Выполните `claude plugin marketplace add AbdulrahmanMasoud/comprende` и `claude plugin install comprende@comprende`, затем перезапустите Claude Code.
Как поставить в Cursor?
Склонируйте репозиторий командой `git clone https://github.com/AbdulrahmanMasoud/comprende.git ~/.cursor/plugins/local/comprende` и перезапустите Cursor.
Как поставить в Codex?
Выполните `codex plugin marketplace add AbdulrahmanMasoud/comprende` и `codex plugin add comprende@comprende`, затем доверьте хуки в `/hooks`.
Сколько вопросов задает проверка?
От одного до шести, по одному за раз. Для малого изменения хватает одного вопроса.
Где хранится отчет проверки?
В `.learning/checks/` и коммитится вместе с кодом, чтобы проверка в CI сопоставила его с изменением.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин для Claude Code: передает задачу локальному no_human и проверяет ветку ревьюером, не видевшим сессию кодера
CLI и плагин для ревью кода агентом: читает git diff и пишет замечания по строкам с учетом контекста
Плагин со скиллами для Claude Code и Codex: исследование кода, тесты, рефакторинг и независимая проверка готовых изменений
Плагин Claude Code: Claude выполняет задачу, затем хук остановки запускает независимое ревью в Codex, и Claude правит замечания в той же сессии
Плагин Claude Code для разработки с разделением ролей: спецификация, ревью, TDD, QA и верификация разными агентами
Набор для Claude Code: восемь агентов по фазам работы, 21 скилл и хуки, которые держат агента в заданных рамках.
Коротко о README
В документации два режима, установка для трех сред и пример диалога. Объяснения работают без настройки, проверка владения включается отдельно в репозитории.