Code Wiki: инструмент документации кода на базе ИИ от Google 126

Что такое Code Wiki?

Code Wiki — это запущенный Google в ноябре 2025 года ai-инструмент для документирования кода, созданный для решения давней проблемы в создании ПО — рассинхронизации кода и документации. Он использует AI-модель Gemini для автоматического анализа репозиториев на GitHub и формирования структурированной, постоянно актуальной Wiki-документации.

В отличие от прежней фиксированной документации, написанной вручную, Code Wiki после изменения кода самостоятельно выполняет повторное сканирование и обновляет документацию, благодаря чему она всегда соответствует исходному коду.

Функциональные особенности Code Wiki

• Автоматическая генерация и обновление документации: отслеживает Git-коммиты и после каждого слияния кода (PR) автоматически пересоздаёт соответствующие страницы Wiki. Анализирует не только README, но и структуру классов, способы взаимодействия функций, определения интерфейсов. Получаемая документация имеет иерархию: общее устройство системы, описание отдельных модулей, подробное описание классов и функций.

• Автоматическое построение визуальных схем: самостоятельно генерирует диаграммы архитектуры, диаграммы классов и диаграммы последовательности. По элементам на схемах можно кликнуть и перейти к соответствующим файлам и строкам кода. При изменении кода схемы также обновляются.

• Возможность задавать вопросы через чат с Gemini: имеется чат-ассистент на базе Gemini, который знает всё о кодовой базе. Можно спрашивать обычным языком, например: «Где находится точка входа в этот сервис?» «На какие модули влияет этот код?» В ответах приводятся источники кода и ссылки на файлы, что снижает вероятность выдумок.

• Навигация по клику: термины, имена переменных и классов в документации кликабельны. От крупных понятий можно сразу переходить к конкретному коду — примерно так же, как Ctrl+клик в IDE.

• Создание AI-подкастов: на основе содержимого документации интеллектуально создаёт видео-подкасты в стиле NotebookLM с диалогом двух собеседников, однако эта функция доступна лишь для части проектов.

Сценарии применения Code Wiki

• Адаптация новичков в компании: быстро разобраться в архитектуре сложной кодовой базы — то, на что раньше уходило несколько дней, теперь занимает от 30 минут до 2 часов.

• Ревью кода: заранее узнать, какие модули затрагивает PR, и задавать вопросы вроде логики авторизации той или иной функции.

• Оценка техдолга: выявление в кодовой базе модулей, которые стоит переписать, например классов со слишком большим числом методов или повторяющегося кода.

• Изучение open-source проектов: понимание того, как устроены популярные фреймворки вроде React, Vue, Next.js.

• Поддержка legacy-кода: повторное создание документации для старых кодовых баз, у которых нет документации и в которых уже ушли люди, понимавшие их.

Как пользоваться Code Wiki

Откройте https://codewiki.google/; на главной странице введите адрес GitHub-репозитория или имя автора для поиска; слева — оглавление документации, в центре — подробное описание со схемами, справа — чат с ассистентом Gemini; кликнув по схеме или ссылке в документации, можно перейти к конкретному коду.

Часто задаваемые вопросы

В1: Какие языки программирования поддерживаются?

В основном высокоуровневые языки: Java, Go, Python, JavaScript/TypeScript. Системные языки вроде C/C++, из-за указателей и ручного управления памятью, дают результат несколько хуже.

В2: Насколько точна сгенерированная документация?

Документацию, созданную AI, следует рассматривать лишь как ориентир. По ключевым архитектурным решениям или коду, связанному с безопасностью, лучше перепроверить самому и согласовать с коллегами — не стоит слепо полагаться на неё.

В3: Это платно?

В настоящее время полностью бесплатно (публичная preview-версия).

В4: Почему у некоторых проектов нет AI-подкаста?

Не все проекты имеют эту возможность; когда она станет доступна повсеместно, пока точно не сообщается.

В5: Можно ли экспортировать в PDF или Markdown?

На данный момент официальной возможности нет, хотя многие уже запрашивали эту функцию.

Google Code Wiki изменил подход к документации кода — раньше это была писавшаяся вручную дополнительная работа, а теперь это живая, структурированная, постоянно обновляемая документация. Она особенно подходит командам, которым нужно быстро разобраться в большой кодовой базе, однако лучше использовать её вместе с написанной вручную документацией по бизнес-логике, а не вместо неё.