Agent Harness Kit — рабочий процесс для агентов
Agent Harness Kit
CLI ahk разворачивает в проекте пять ролей агентов, MCP-сервер задач и навыки спецификаций для Claude Code, Codex и Cursor
- 184 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инициализация создает в проекте файлы агентов, навыки и запись MCP, а скрипт здоровья запускает команды проекта
- Роли с запретом правок ограничены инструментами агента, а не песочницей, поэтому изоляции от опасных команд нет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-harness-kitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инициализация создает в проекте файлы агентов, навыки и запись MCP, а скрипт здоровья запускает команды проекта
- Роли с запретом правок ограничены инструментами агента, а не песочницей, поэтому изоляции от опасных команд нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agent Harness Kit, или AHK, дает разным ИИ-агентам общий процесс: документы, учет задач, передачи работы и свидетельства проверки. Команда `ahk init` в каталоге проекта спрашивает провайдера, путь к документам и способ хранения, затем создает конфигурацию, файлы ролей и навыки для выбранного агента: Claude Code, Codex CLI, Cursor, Grok Build, OpenCode или OpenCode V2. Задачей занимаются пять ролей. Лид берет задачу, исследователь изучает код, консультант сравнивает подходы, строитель пишет, ревьюер проверяет и при замечаниях возвращает работу строителю. Учет задач, журнал действий, передачи и итоговая проверка здоровья проекта ведутся в MCP-сервере, а документы остаются обычными файлами. Отдельные навыки запускаются по явной просьбе: `ahk-use-case` и `ahk-spec` готовят сценарий и функциональную спецификацию, `ahk-spec-tech` проектирует реализацию, `ahk-triage` ищет причину бага без правок, `ahk-test` пишет только тесты, `ahk-docs` объясняет сам AHK.
Для кого. Командам и одиночным разработчикам, которые гоняют задачи через Claude Code или Codex и хотят следов процесса: кто взял задачу, что проверено, что утверждено.
Подходит, если
- Фича расплывчата, и перед кодом нужны сценарий и спецификация, утвержденные человеком
- Баг надо разобрать по свидетельствам, не трогая код, и получить отчет
- Один репозиторий обслуживают несколько агентов, и им требуется общий учет задач
- Готовый кусок кода проходит ревью отдельной ролью, а не тем же агентом, который его писал
- Перед закрытием задачи сервер должен прогнать скрипт здоровья проекта и сохранить результат
Не подходит, если
- Небольшая правка в одном файле: роли и документы только замедлят работу
- Скрипт здоровья писать не из чего: заглушка, которая всегда успешна, не считается свидетельством завершения
- Нужна изоляция от опасных команд: роли ограничивают инструменты, но песочницей не служат
- Задачи приходят из Jira: AHK не забирает карточки автоматически, текст запроса вставляют вручную
Пример запроса к агенту
Используй ahk-feature и преврати вставленную ниже карточку Jira в функциональную спецификацию. Сохрани черновик, спроси утверждения и не создавай задачу.Ограничения
Стартовый скрипт здоровья, который создает `ahk init`, надо заменить командами, реально проверяющими проект. Права ролей задают инструменты агента: инструкции в промптах, в том числе для Codex, границей безопасности не считаются.
Yarn Berry не поддерживает `yarn global`, глобальную установку делают через pnpm, npm или Bun. После инициализации провайдер перезапускают, чтобы он перечитал конфигурацию MCP.
Работа OpenCode V2 проверена на версии 2.1.4 с детерминированным локальным провайдером моделей, качество с платными моделями этим не подтверждено. Последний коммит репозитория: октябрь 2026.
Как отключить. Удалите пакет командой `npm uninstall -g @cardor/agent-harness-kit`, а файлы ролей, навыков и запись MCP уберите из проекта: для Claude Code это `.mcp.json` и каталог агентов.
Частые вопросы
Как поставить AHK и начать работу?
Выполните `pnpm add -g @cardor/agent-harness-kit`, затем `ahk init` в каталоге проекта. Мастер спросит провайдера и путь к документам. После этого перезапустите агента и сделайте первый ограниченный запрос, например через `ahk-feature`.
Какие агенты поддерживаются?
Claude Code, Codex CLI, Cursor, Grok Build, OpenCode и OpenCode V2. Для каждого `ahk init` создает собственные файлы: у Claude Code это `.mcp.json` в корне проекта.
Чем навык ahk-triage отличается от ahk-ask?
`ahk-triage` диагностирует баг и выдает отчет с доказательствами, не меняя код. `ahk-ask` отвечает на вопросы о коде проекта и состояние задач не затрагивает. Оба работают только на чтение.
Какие роли есть у агентов в AHK?
Пять: лид координирует, исследователь изучает код, консультант сравнивает подходы, строитель реализует, ревьюер проверяет и возвращает строителю замечания. Итоговая проверка здоровья проекта идет на сервере.
Где AHK хранит состояние?
Задачи, журнал действий, передачи и результат проверки ведет MCP-сервер, документы остаются файлами в выбранном каталоге. Базу можно держать глобально в домашнем хранилище или локально, обычно в `.harness/harness.db`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКаждому кодинг-агенту отдельная копия репозитория со своими портами и базой, а проверка результата идет одним и тем же конвейером.
Больше двадцати скиллов для кодовых агентов: MCP и хуки, режим плана, протокол багфикса, промпты и защитный хук для bash
Скиллы команды Codely ведут работу агента по фазам: план в файле или GitHub Issues, ревью после каждой фазы и аккуратный коммит
CLI, хуки и скиллы для долгой работы Claude, Codex и Pi: задачу ведут issue и PR, а на ревью приходит PR с проверками
Repository Harness ставит в репозиторий файл AGENTS.md, карту документов и явно вызываемые скиллы для онбординга, а затем безопасно обновляет их
Агент для кода в терминале: режим плана до правок, перенос настроек из Claude Code и Codex, скиллы, MCP и выбор провайдера моделей
Коротко о README
README показывает таблицу «что нужно, что запросить, что получится, чего не делает» для каждого навыка и две схемы процесса: от идеи до спецификации и от задачи до проверенной работы. Затем описаны установка, хранилище, выбор моделей по ролям и особенности OpenCode V2.