Better Harness — плагин
Команда /better-harness разбирает, как устроена работа ИИ-агента в проекте: цели, проверки, поставка и память. На выходе отчет с приоритетными правками
- 2 413 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает записи прошлых сессий агента в проекте, где бывают промпты, пути к файлам и вывод команд, а с разрешения и домашнюю папку и память
- Запускает три дополнительных агента для анализа, что расходует запросы к вашей модели, и записывает отчеты в папку проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/better-harnessОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает записи прошлых сессий агента в проекте, где бывают промпты, пути к файлам и вывод команд, а с разрешения и домашнюю папку и память
- Запускает три дополнительных агента для анализа, что расходует запросы к вашей модели, и записывает отчеты в папку проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Better Harness — плагин с открытым кодом, который оценивает обвязку вокруг агента: правила, спецификации, скиллы, проверки и порядок поставки. Работа идет через вашего агента для программирования командой `/better-harness`, у Codex это `$better-harness:better-harness`. Результат — отчет по пяти измерениям цикла работы агента: понимание задачи, контролируемое выполнение, проверка изменений, надежная поставка и сохранение уроков. Каждое измерение опирается на то, что нашлось в проекте: `AGENTS.md`, правила, скиллы, команды, MCP, хуки, тесты, CI. Команда собирает пакет данных по трем независимым источникам: журналы прошлых сессий агента в этом проекте, сам репозиторий и настроенные ассеты агента. Затем запускаются три отдельных агента только для чтения, по одному на источник, и ведущий агент объединяет их выводы. Недостающие данные в отчете помечены явно, балла за них не ставится. Каждая находка содержит влияние, ожидаемый результат, границы правки и проверки приемки, а кнопка исправления готовит план правки для вашей проверки. Отчет сохраняется как самодостаточный `report.html` с `report.md` и `findings.json`, в Claude Code по умолчанию в папку `.claude/better-harness` репозитория. В Qoder и Cursor он открывается как встроенный холст. Отдельная консольная программа `better-harness` умеет проверять состояние установки командами `plugin status` и `doctor`. Поддерживаются Claude Code, Codex, Qoder, Cursor, GitHub Copilot CLI, Qwen Code, Pi, Kimi Code, WorkBuddy и Grok.
Для кого. Для команд, где ИИ-агенты уже пишут много кода, и тимлидов, которые хотят понять, почему агент решает не ту задачу, пропускает проверки или повторяет одни и те же ошибки.
Подходит, если
- Агент уверенно решает не ту задачу или не может понять, что значит «готово», и нужно проверить правила, спецификации и критерии приемки
- Команда внедрила скиллы, хуки и MCP, но неясно, действительно ли агенты ими пользуются в реальных сессиях
- Перед вводом ИИ-агентов в процесс поставки нужно проверить, не обходят ли они ревью, тесты и подтверждения
- Через несколько недель надо сравнить отчеты по тем же измерениям и увидеть, как менялась обвязка
Не подходит, если
- Нужно проверить сам код или найти ошибку в диффе: отчет оценивает процесс вокруг агента, а не итоговые строки кода
- В проекте еще нет сессий и настроенных правил: отчет по пустым данным покажет мало, а недостающее остается неоцененным
- Нужен постоянный мониторинг в реальном времени: плагин запускается по команде, а не следит за агентом непрерывно
- Вы не готовы отдавать агенту чтение журналов прошлых сессий: для анализа он читает локальные записи сессий этого проекта
Пример запроса к агенту
/better-harness проанализируй, как устроена работа ИИ-агентов в этом проекте, и подготовь отчет с находками и проверкамиОграничения
- Пакет `@qoder-ai/better-harness` помечен версией 0.7.0-alpha2, а команда запускается только вручную: в описании скилла сказано, что вызывать его надо слэш-командой.
- Общего входа для всех сред нет: установка, проверка и запуск у Claude Code, Codex, Qoder, Cursor и Copilot разные. Плагин для Cursor в магазин не опубликован; для WorkBuddy управляемой установки плагина нет.
- Анализ сессий опирается на то, что среда сохраняет. У Copilot CLI нет данных о токенах по ответам, а в чате VS Code нет долговечных записей, поэтому эти данные в отчете остаются неоцененными.
- Чтение домашней папки пользователя, тел памяти и необработанных сессий требует отдельного явного разрешения. Три агента анализа расходуют запросы к вашей модели.
- Отчет показывает наблюдаемые тенденции и не доказывает причину улучшения. Для запуска из исходников нужен Node.js от 22.20 до 24. Лицензия MIT.
Как отключить. Удалите плагин средствами вашей среды: в Claude Code через меню `/plugin`, в Codex Desktop через Settings и Plugins. Команда `better-harness plugin plan` строит план установки, обновления и удаления для выбранной среды. Папку отчетов `.claude/better-harness` в проекте удалите вручную.
Частые вопросы
Что входит в пять измерений отчета?
Понимание задачи, контролируемое выполнение, проверка изменений, надежная поставка и сохранение уроков. Первое опирается на `AGENTS.md` и спецификации, второе на скиллы и границы песочницы, третье на тесты и хуки, четвертое на ревью и CI, пятое на память и повторно используемые скиллы.
Как плагин получает данные для отчета?
Команда собирает пакет по трем независимым источникам: записи сессий агента, файлы проекта и настроенные ассеты агента. Три агента только для чтения разбирают каждый свой источник и не видят выводов друг друга. Ведущий агент объединяет результат, а недостающие данные помечает явно.
Что отчет делает с недостающими данными?
Помечает пробелы в отчете явно. Поведение, которое не удалось наблюдать, не превращается в оценку или вывод без опоры. Находки идут по приоритету, у каждой есть влияние, ожидаемый результат, граница правки и проверки приемки. Историю отчетов можно сравнить по тем же пяти измерениям.
Что делает действие починки в находке?
Оно готовит ограниченный по области план исправления для вашей проверки, но не применяет правку молча. Отдельный режим прямого исправления запускается словами `fix` или `repair` в начале запроса. Результат вы просматриваете перед внесением изменений в проект.
Что такое Harness Inspector?
Интерактивный просмотрщик, который связывает цель продукта, активность агента, сессии, файлы и коммиты на одной шкале времени. Он открывается в режиме только для чтения. Публичный пример на сайте проекта построен на вымышленных данных и не читает вашу рабочую папку.
Как проверить состояние установки?
Консольная программа показывает локальные следы установки командами `better-harness plugin status --host all` и `better-harness doctor --platform all`. Реестры она не опрашивает и настройки не меняет. Команда `plugin plan install` лишь печатает последовательность шагов для выбранной среды.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныСобирает из GitHub-репозитория пакет с собственным ИИ-агентом: команда npx, MCP-сервер, память и подписанный выпуск
MCP-сервер Harness: один агент запускает другие сеансы Claude Code и Codex на вашем компьютере, ждет их, читает ответы и закрывает
CLI, который держит существующего агента на длинной задаче: планирует шаг, выполняет его, проверяет результат в реальной среде и сохраняет прогресс
Приложение на Rust для macOS, Linux и Windows: скиллы, MCP-серверы, плагины, хуки и конфиги 17 ИИ-агентов в одном окне, с проверкой безопасности
Курируемый ранжированный список агентных харнесов с MCP-сервером и готовыми субагентами, чтобы подобрать харнес под задачу
Сто готовых команд агентов для Claude Code: в каждой специалисты, скилл-оркестратор и доменные скиллы, на английском и корейском
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Better Harness (эта запись) | нет | 2 413 | |
| Harness | нет | 9 283 | мета-скилл, который собирает команду агентов и скиллы по описанию домена |
| AutoHarness | нет | 10 482 | самообучающийся слой скиллов, выводит скиллы из ваших сессий и обновляет их |
Коротко о README
В репозитории лежат основной скилл со справочниками по трем источникам данных, дополнительные скиллы (архитектурная модель, проверка прослеживаемости изменений, сверка спецификаций), модель оценки цикла работы агента, сборщики данных и генераторы отчетов на Node.js, манифесты плагинов для нескольких сред, настольное приложение Harness Studio и документация. Главная страница начинается с выбора среды и примера отчета, затем объясняет пять измерений, архитектуру и установку.