Repository Harness — скилл
Repository Harness ставит в репозиторий файл AGENTS.md, карту документов и явно вызываемые скиллы для онбординга, а затем безопасно обновляет их
- 1 251 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Исполняет бинарник, скачанный из релиза GitHub; перед запуском проверяются контрольная сумма и идентичность релиза
- Пишет и обновляет файлы в репозитории: `AGENTS.md`, `docs`, `.agents/skills`, `.harness-core`, а флаг `--override` заменяет существующие
- Скилл `$encode-invariant` по вашей команде добавляет в проект проверки, а `$improve-harness` меняет инструкции агента
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/repository-harnessОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Исполняет бинарник, скачанный из релиза GitHub; перед запуском проверяются контрольная сумма и идентичность релиза
- Пишет и обновляет файлы в репозитории: `AGENTS.md`, `docs`, `.agents/skills`, `.harness-core`, а флаг `--override` заменяет существующие
- Скилл `$encode-invariant` по вашей команде добавляет в проект проверки, а `$improve-harness` меняет инструкции агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Repository Harness готовит репозиторий к работе кодовых агентов: Claude Code, Codex, Cursor и других. Из папки целевого репозитория запускается скрипт установки `install-harness.sh` (для PowerShell есть `install-harness.ps1`). Дальше установку ведет бинарник `harness`. В репозитории появляются краткий `AGENTS.md`, карта документов `docs/README.md`, места для описания продукта, решений и планов работ, шаблоны, справочник по превращению правил в проверки и пять скиллов в `.agents/skills`. Скиллы запускаются только по прямой команде, установка их не включает: `$onboard-repository` изучает незнакомый репозиторий, проходит один рабочий путь и предлагает улучшения с доказательствами, причем первый проход только читает; `$audit-onboarding-proposal` независимо проверяет такое предложение; `$encode-invariant` превращает принятое правило в проверку с положительным и отрицательным подтверждением; `$improve-harness` проверяет одно улучшение на исходном и повторном прогоне; `$engineering-wisdom` дает советы по инженерным практикам. Последний ставится отдельно, с флагом `--with-engineering-wisdom`. После установки действует `scripts/bin/harness` с командами `status`, `doctor` и `update`. Обновление хранит исходную базу в `.harness-core/`, делает трехстороннее слияние и копирует измененные файлы в резерв. Если ваши правки и правки автора пересеклись, ни один управляемый файл не меняется: остаются копии BASE, LOCAL, UPSTREAM и RESOLVED, решение принимает человек, затем идут `update --continue` или `update --abort`.
Для кого. Для команд и одиночных разработчиков, которые отдают репозиторий кодовым агентам и хотят единую точку входа с картой документов и воспроизводимыми проверками.
Подходит, если
- В репозитории важные решения живут только в переписке, и агенту негде прочитать, какие документы считать главными
- Нужен краткий `AGENTS.md` и карта документов, которые можно обновлять без потери ваших правок
- Принятое правило, например запрет на определенную зависимость, надо превратить в автоматическую проверку командой `$encode-invariant`
- Вы подключаете агента к чужому репозиторию и хотите сначала получить карту с отметкой, что известно и чего не хватает, без записи в файлы
- Хотите проверить, что улучшение инструкции для агента действительно сработало на повторном прогоне
Не подходит, если
- Нужен трекер задач, оркестратор агентов или среда запуска приложения: автор прямо исключает эти роли
- Вы не можете скачать и запустить бинарник из релиза: установка и обновление идут через него
- Нужны готовые команды сборки и проверки или учетные данные для вашего приложения: Harness их не устанавливает
- Вам нужно только описание проекта для Claude Code в одном файле: для этого проще поддерживать `AGENTS.md` вручную или взять CLI Caliber из каталога
Пример запроса к агенту
Подготовь этот репозиторий для агентов через Repository Harness, сначала покажи, что изменится, а потом запусти onboard-repositoryОграничения
- Установка запускает скрипт через `curl` и канал в `bash` и скачивает бинарник. Перед записью файлов посмотрите, что будет сделано, флагом `--dry-run`.
- Harness не ставит архитектуру приложения, политику продукта, команды проверки, учетные данные, базу данных и фоновые процессы. Запуск приложения целиком автор оставляет владельцу репозитория.
- Прежний `harness-cli` на SQLite и протокол v1 сняты с поддержки 10 августа 2026 года. Последний совместимый релиз — `harness-cli-v0.1.22`, текущий репозиторий его уже не собирает и старые базы не удаляет.
- Флаги `--merge` и `--override` меняют судьбу существующих файлов: первый сохраняет их и добавляет недостающее, второй заменяет. Второй используйте осознанно.
- Скиллы описаны на английском. Лицензия указана в репозитории, остальные условия смотрите в файле `LICENSE`.
Как отключить. Просмотрите список установленных файлов в `scripts/harness-install-files.txt` и удалите их из репозитория, включая `.agents/skills` и папку `.harness-core`. Скрипта удаления в источниках нет.
Частые вопросы
Как подготовить репозиторий к работе ИИ-агента и добавить AGENTS.md?
Запустите скрипт `install-harness.sh` из папки репозитория, лучше сначала с `--dry-run`. Он положит краткий `AGENTS.md`, карту документов `docs/README.md`, шаблоны планов и решений и скиллы в `.agents/skills`. Файлы, которые у вас уже есть, сохранит флаг `--merge`.
Включаются ли скиллы сами после установки?
Нет. Каждый скилл запускается только прямой командой пользователя вроде `$onboard-repository`. Совпадение темы запроса или сама установка скилл не включают, это требование автора относится ко всем пяти скиллам.
Что происходит, если мои правки конфликтуют с обновлением Harness?
`scripts/bin/harness update` делает трехстороннее слияние и при пересечении правок не меняет ни один управляемый файл. Рядом остаются копии BASE, LOCAL, UPSTREAM и RESOLVED. После вашего решения запустите `update --continue`, а `update --abort` сбросит только подготовленное решение.
Меняет ли `$onboard-repository` файлы репозитория?
Первый проход только читает и формирует предложение. Он фиксирует исходный корень Git, ревизию, ветку и состояние, не печатает содержимое секретов и сохраняет ваши незакоммиченные изменения. Применяются только точно одобренные пункты в запрошенной области.
Как проверить, что в репозитории все в порядке после установки?
Команда `scripts/bin/harness status` показывает состояние установки, а `scripts/bin/harness doctor` проверяет ее целостность. Перед обновлением полезен `update --dry-run`.
Как поставить советы по инженерным практикам?
Это отдельная необязательная часть. Запустите `scripts/install-harness.sh --with-engineering-wisdom --yes /path/to/project`, после чего скилл `$engineering-wisdom` вызывается вручную и дает советы, а политику репозитория не устанавливает.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыЛичный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации
Кодинг-агент для терминала и рабочего стола: не засчитывает «готово» без тестов или diff и работает с DeepSeek, GLM, Kimi, Claude, Codex и Gemini
Builder Skills
Skills for agents
Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные
Два скилла для кодинг-агентов: wtf проверяет проект перед деплоем, better-codex держит агента в рамках при работе с кодом
Общая инфраструктура скиллов и инструментов для доработки 1С, подключаемая как git submodule и раскладываемая по нескольким агентам разом
Скилл автономной итерации для агента: правка, проверка, откат неудачных изменений и повтор цикла к заданной метрике
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Repository Harness (эта запись) | нет | 1 251 | |
| rpa-init | нет | 1 | один скилл онбординга: агент читает код и тесты, поднимает окружение и пишет отчет, без установки AGENTS.md и обновлений |
| Caliber | нет | 1 309 | CLI, который создает и поддерживает файлы контекста для разных агентов: CLAUDE.md, правила Cursor, AGENTS.md |
Коротко о README
В репозитории лежат скрипты установки для Bash и PowerShell, исходники бинарника на Rust, пять скиллов, каталоги `docs` и `tests`. Главная страница перечисляет проблемы агентов (намерение остается в переписке, главные документы не названы, о готовности заявляют без подтверждения), состав установки, команды обслуживания, три границы релизных доказательств и дату снятия поддержки протокола v1. В разделе разработки описан набор проверок перед слиянием: форматирование и тесты Rust, Clippy, проверки установщика и документации.