20 мая 2026 г.

Dari-docs: инструмент для проверки документации с помощью параллельных ИИ-агентов

Материал подготовлен автоматизированной редакционной системой. Факты можно сверить по указанному первоисточнику.

Проект dari-docs предлагает оптимизировать техническую документацию, запуская на ней задачи для различных ИИ-агентов. Инструмент позволяет выявлять слабые места в инструкциях, которые затрудняют автоматическую интеграцию продуктов.

Ценность: С ростом использования ИИ-ассистентов в разработке критически важно, чтобы документация была понятна не только людям, но и машинам. Dari-docs предлагает практический способ тестирования документации на «агентоустойчивость».

В современной разработке программного обеспечения формируется новый стандарт качества технической документации: она должна быть пригодна для использования не только людьми, но и ИИ-агентами. Разработчики все чаще направляют такие инструменты, как Claude Code или Codex, к документации, ожидая, что модели смогут самостоятельно разобраться в продукте и реализовать интеграцию. Это меняет саму природу задачи по написанию инструкций: вместо субъективной оценки читабельности появляется конкретный критерий — сможет ли «глупый» каркас с наименее интеллектуальной моделью надежно выполнить задачу? Люди способны компенсировать непоследовательность терминологии или разрозненность контекста, но для агентов такие нюансы часто приводят к потере времени или полному сбою.

В ответ на эту проблему создан проект dari-docs. Пользователи могут загрузить свою документацию через веб-интерфейс или командную строку и запустить на ней агентов от различных провайдеров. Инструмент позволяет задать список задач и поручить их выполнение агентам с разным уровнем «интеллекта» и стоимости, работая параллельно. По завершении прогона система возвращает файлы с обратной связью в формате Markdown от каждого агента, что позволяет разработчикам вносить изменения в документацию на основе полученных данных.

Важной особенностью dari-docs является то, что это не статический анализ текста с помощью LLM. Агенты действительно пытаются использовать продукт от начала до конца: они ищут информацию в документации, следуют инструкциям, запускают команды, пробуют примеры и пытаются отлаживать ошибки. Это практический тест интеграции, а не просто ревью текста.

Для более глубокой проверки доступен режим живой верификации с использованием тестовых учетных данных. Это позволяет агентам проверять рабочие процессы против реальных API. Например, команда `dari-docs check . --live-verify --secret-env DARI_TEST_API_KEY --task "Create a checkout session"` запускает агент, который пытается создать сессию чекаута, используя предоставленный ключ.

Проект ориентирован на разработчиков CLI, API, MCP-серверов и SDK, которые активно поддерживают документацию. Авторы приглашают коллег протестировать инструмент на реальных рабочих процессах. Управляемая версия сервиса доступна по адресу optimize.dari.dev, а исходный код размещен в репозитории GitHub.