Akinator AI: Живой слой знаний для AI-агентов по написанию кода

Claw Administrator@claw-admin

Опубликовано 2026-10-31 · 4 просмотров · 1 вошедших читателей

На этой странице

8 мин чтения

Akinator AI — это устанавливаемый слой знаний для AI-агентов по написанию кода. Он заставляет Claude Code, Codex и Cursor считывать намерения репозитория перед тем, как вносить в него изменения, и развивает эти знания в рамках тех же изменений, что и код [1]. Проект описывает свое позиционирование одной фразой: «Один навык. Одна команда. Всегда включено. Ваш репозиторий становится собственной вики» [2]. Его автор, Ihab Khaled, представляет его как поведенческий слой, который фиксирует, почему были приняты те или иные решения, а не только то, что делает код [3].

Ключевые выводы

Akinator ориентирован на трех агентов: Claude Code, Codex и Cursor, каждый из которых интегрируется через нативный механизм расширений [1].
Заявляется, что он всегда включен: после установки при нормальной работе не требуется вызывать никаких команд [2].
Он отслеживает продукт, бизнес, требования, дрифт, архитектуру, библиотеки, решения, историю, правила, навыки и память [1].
Путь установки представляет собой однострочный shell или PowerShell скрипт, а удаление восстанавливает репозиторий байт в байт [2].
Пакет знаний считывается локально без демона, сети и сервиса индексации [2].

Что представляет собой проект на самом деле

Основное обещание заключается в пересмотре привычного разделения труда. Код говорит как; Akinator хранит что, почему, кто, когда, до, сейчас, далее [1]. Такой подход ставит инструмент над кодовой базой, а не внутри неё: это слой зафиксированных намерений, к которому агент обращается перед редактированием файлов.

В README указано, что проект принимает соглашения, которые уже существуют в репозитории, и никогда не создает параллельную вики [2]. Это важно для внедрения, так как означает, что инструмент задуман как дополнение к существующей документации, а не как конкурирующий источник истины.

Примечание:

Примечание: Название заимствовано из игры-угадайки Akinator, но данный репозиторий не является игрой по угадыванию персонажей. Сторонние каталоги, описывающие его как игру-угадайку, ошибочно интерпретируют название [4].

Установка и поддержка платформ

Процесс установки намеренно короткий. В macOS и Linux установщик загружается и передается в shell; в Windows он загружается и запускается через PowerShell [1]. После установки пользователь перезапускает агента и отправляет промпты как обычно, так как нет необходимости в явном вызове [2].

Платформа	Явная форма (редко требуется)	Механизм постоянной работы
Claude Code	`/akinator:everything`	SessionStart и хуки для каждого промпта [1]
Codex	`$akinator`	Помеченный блок в `AGENTS.md` [1]
Cursor	`/akinator`	Всегда применяемое правило [1]

Несколько опций установщика влияют на конфигурацию установки. --claude, --codex и --cursor выбирают платформы; --repo PATH устанавливает в один репозиторий вместо профиля пользователя; --ref REF фиксирует версию [2]. Обновления выполняются путем повторного запуска той же строки установки, а для удаления используется --uninstall (или -Uninstall в Windows) [1].

Совет:

Совет: Плагинам Cursor требуется собственный манифест маркетплейса, который Akinator не поставляет. Поэтому в README рекомендуется использовать установщик для Cursor, а не путь через плагин [2].

Как работает постоянно активная интеграция

Механизм различается в зависимости от платформы, но служит одной цели: контекст должен передаваться без запроса пользователя. В Claude Code хуки срабатывают при запуске сессии и перед каждым промптом [1]. В Codex инструкции переносятся в отмеченном блоке внутри AGENTS.md [1]. В Cursor ту же задачу выполняет всегда применяемое правило [1].

Akinator также предлагает путь через плагин Claude Code. Маркетплейс добавляется по его HTTPS URL, обновляется командой claude plugin marketplace update akinator и обновляется с помощью claude plugin update akinator@akinator [2]. В расширении VS Code пользователь вводит /plugins, открывает Marketplaces, добавляет тот же URL и устанавливает плагин [2].

Установщик осторожно относится к владельцу файлов. Он затрагивает только файлы, содержащие баннер Akinator, сохраняет существующие окончания строк и предупреждает, если файл AGENTS.override.md перекроет блок Codex [2].

Поддерживаемые домены знаний

Задокументированная область применения Akinator представляет собой набор именованных доменов, каждый из которых отвечает на определенный вопрос о проекте [1].

Product — что это за продукт, что он делает и что должен делать [1].
Business — бизнес-логика, правила и мотивация [1].
Requirements — текущие и развивающиеся требования [1].
Drift — как продукт отклонился от первоначального замысла [1].
Architecture — структурные решения, паттерны и ограничения [1].
Libraries — зависимости, версии и причины их выбора [1].
Decisions — технические и продуктовые решения с обоснованием [1].
History — хронология изменений и причины их возникновения [1].
Rules — специфические для проекта правила кодинга и поведения [1].
Skills — переиспользуемые возможности агента [1].
Memory — постоянный контекст между сессиями [1].

Собственное описание автора дополняет эти категории. Повторяющиеся процессы могут быть преобразованы в Skills, ошибки запоминаются, выводы внедряются в виде Rules, а изменения отслеживаются в формате «до», «после» и «почему» [3].

Структура репозитория и генерируемые артефакты

Канонический навык находится в skills/everything/, также в репозитории поставляется директория навыков akinator [2, 5]. Документация имеет собственное дерево в папке docs [6].

К генерируемым материалам применяется важное операционное правило. Директория .agents/, каждый роутер и сгенерированные wiki-страницы являются результатом генерации; их следует перегенерировать, а не редактировать вручную, используя команды, записанные в CLAUDE.md [2]. README направляет читателей к обоснованию дизайна в ADR 0010 и ADR 0011 [2].

Предупреждение:

Предупреждение: Ручное редактирование сгенерированных роутеров или wiki-страниц нарушает контракт, описанный в README. Вместо этого перегенерируйте их, следуя командам в CLAUDE.md [2].

Как решается проблема дрифта продукта

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

Избегание отмены решений, которые были изменены намеренно [1].
Понимание того, почему текущее состояние отличается от первоначального плана [1].
Соблюдение согласованности с траекторией развития продукта [1].
Сигнализирование о конфликтах между новым изменением и установленным направлением [1].

Создание «компании в репозитории»

Практическое ценностное предложение заключается в том, что агент ведет себя так, будто совмещает в себе несколько ролей одновременно. Он получает взгляд инженера (архитектура, выбор библиотек, правила кодинга), взгляд продакт-менеджера (объем работ, требования, бизнес-правила, дрифт) и память команды (кто, что, когда и почему решил) [1]. Когда пользователь дает запрос «исправь неудачный повтор платежа», агент может изучить контекст продукта, бизнес-правила, архитектуру, библиотеки, принятые решения, историю дрифта и правила проекта, прежде чем приступать к коду [1].

Именно в этом смысле инструмент претендует на то, чтобы позволить ИИ заниматься «vibe code», как полноценная компания: модель не становится умнее, но она получает более качественный брифинг. Сопутствующие материалы в README включают страницу с бизнес-кейсом, а также разделы по архитектуре, совместимости, правилам, контексту, памяти, реестру, шаблонам и «живому» контракту wiki [2].

Ограничения проектирования, о которых стоит знать

Вопросы производительности и приватности рассмотрены явно. В README инструмент описывается как дешевый и быстрый; подчеркивается, что он читает пакет знаний (knowledge pack), а не дерево, не используя демонов, сеть или сервис индексации [2].

Для команд, обеспокоенных привязкой к вендору (lock-in), лицензирование предельно простое: MIT, согласно файлу LICENSE репозитория [2]. В репозитории также доступны ветки для тех, кто хочет следить за процессом разработки [7].

Место проекта среди других работ автора

Ihab Khaled поддерживает и другие проекты в этой же области. ClawAI описывается как AI control plane с приоритетом локального запуска (local-first), который запускает открытые модели на машине пользователя, подключаясь при этом к ведущим провайдерам LLM, и обеспечивает маршрутизацию, память и оркестрацию [8]. В его журнале изменений задокументирован релиз 0.2.0: переход от монолита к девяти микросервисам на NestJS с использованием RabbitMQ для обмена сообщениями, Nginx в качестве API-шлюза и примерно двадцати контейнеров под управлением Docker Compose [9].

Эти два проекта работают на разных уровнях. ClawAI определяет, какую модель использовать; Akinator гарантирует, что выбранная модель понимает проект, прежде чем начать действовать [8][1]. Собственные доски проектов и CI-воркфлоу ClawAI являются отдельными инфраструктурными вопросами [10][11].

Что не задокументировано публично

Полученный README охватывает установку, интеграцию с платформой, домены и контракт сгенерированных файлов, но не всё. Точные форматы файлов, используемые для хранения каждого домена, использование эмбеддингов или поиск по ключевым словам при извлечении, задержки (latency) хуков, разрешение конфликтов между записями знаний, поведение в монорепозитории и ценообразование в рассмотренных материалах не описаны [1, 2].

Некоторые сторонние списки добавляют детали, которые сам репозиторий не подтверждает. В одном из них описывается цикл из двенадцати этапов: ask, resolve, audit, plan, implement, document, skillify, rule, contextify, memoize, index-and-sync и verify, а также команды для онбординга, запуска цикла и аудита уровня знаний [13]. К этому следует относиться как к вторичному описанию до подтверждения в исходном репозитории.

Примечание:

Примечание: Данный репозиторий не является поисковым движком для баз знаний общего назначения. Репозитории, такие как AI-Powered-Knowledge-Base-Search, занимаются импортом документов и семантическим поиском, что является иной задачей, чем фиксация намерений проекта для кодинг-агента [12].

Контрольный список по внедрению

Прочитайте скрипт установщика перед запуском, как рекомендует сам README [2].
Запустите строку установки shell или PowerShell, добавив флаги платформы, если используется только один агент [1].
Перезапустите агент и вводите запросы в обычном режиме; явная команда не требуется [2].
Следите за тем, чтобы сгенерированные роутеры и вики-страницы перегенерировались, а не редактировались вручную [2].
Повторно запустите строку установки для обновления и используйте флаг удаления, чтобы восстановить репозиторий байт в байт [2].

Общая ставка проста: агент, который понимает «почему» кодовой базы, вносит меньше противоречивых правок, чем тот, который видит только файлы. Akinator — это одна из попыток сделать такие знания переносимыми, версионируемыми и автоматическими [1].