Transcription
Привет всем. Google только что анонсировал Code Wiki, и он призван устранить самую большую проблему в разработке программного обеспечения — понимание кода. Они начинают с реальной проблемы. Чтение кода — это медленно и дорого, и, честно говоря, это правда. Большинство команд разработчиков тратят часы, пытаясь понять устаревшие модули. Это основная идея. Code Wiki поддерживает вашу документацию в актуальном состоянии. Больше никаких устаревших файлов markdown. Больше никаких устаревших диаграмм. Документация автоматически развивается вместе с кодом. Эти три пункта описывают все, что вам нужно знать.
Во-первых, автоматизированный и всегда актуальный. Он сканирует всю вашу кодовую базу и перегенерирует документацию каждый раз, когда код меняется. Больше никакого устаревшего markdown, больше никаких устаревших диаграмм. Документация автоматически развивается вместе с вашим репозиторием.
Во-вторых, интеллектуальный и контекстно-зависимый. Сама вики становится мозгом для чата Gemini. Поэтому, когда вы задаете вопросы, вы не разговариваете с общей моделью. Вы разговариваете с ИИ, который действительно понимает ваш репозиторий от начала до конца.
И в-третьих, интегрированный и действенный. Каждый раздел имеет гиперссылку на точный файл, функцию или класс. Таким образом, чтение и исследование кода становится единым непрерывным рабочим процессом. Больше никакой охоты по папкам.
Code Wiki запускается как общедоступный веб-сайт для публичных репозиториев. Он обрабатывает репозиторий, сканирует весь код и перегенерирует документацию после каждого изменения. Code Wiki, по сути, превращает статическую документацию в живую, всегда точную документацию с глубокими ссылками на точные файлы, классы и функции, стоящие за каждым объяснением. И если вы застряли в сложном модуле, вы можете просто спросить встроенный чат Gemini, который дает релевантные ответы, потому что все его знания поступают из актуальной вики вашего репозитория. Наконец-то вы получаете документацию, которая остается точной без постоянного присмотра. Кроме того, он автоматически генерирует диаграммы архитектуры, классов и последовательностей, которые действительно отражают текущее состояние вашего кода, поэтому визуальные материалы никогда не лгут.
Google также работает над расширением Gemini CLI для CodeWiki, и это та часть, которая будет наиболее интересна большинству команд. Публичные репозитории — это просто, но настоящая проблема кроется внутри частных кодовых баз компаний, особенно когда оригинальных авторов нет, а устаревшие модули представляют собой лабиринт. Версия CLI позволит вам запускать Code Wiki локально и безопасно на ваших собственных внутренних репозиториях, предоставляя командам реальную документацию и реальное понимание, не отправляя код никуда. Они открыли список ожидания для нее, и как только она будет выпущена, это станет революцией для корпоративной разработки.
В качестве примера я загружаю shadcn.ui, одну из самых популярных библиотек пользовательского интерфейса, и Code Wiki отлично ее разбирает. Это самый чистый способ увидеть инструмент в действии. Он генерирует документацию непосредственно из официального репозитория shadcn.ui. Он сгенерировал чистую, хорошо организованную документацию для каждой части проекта, разбивая все по разделам таким образом, чтобы было легко следить. И впечатляет то, что каждый из этих разделов включает свою собственную автоматически созданную диаграмму, дающую вам визуальное представление о том, как все взаимосвязано. Он также добавляет глубокие гиперссылки по всей документации. Поэтому, когда упоминается файл, класс или компонент, вы можете щелкнуть и мгновенно перейти к точному местоположению в коде. Никакого поиска, никакого угадывания. Все напрямую связано.
Что меня действительно впечатлило, так это чат-бот, знающий репозиторий. Вы можете задавать конкретные вопросы о кодовой базе, и он отвечает объяснениями, привязанными непосредственно к файлам. Например, я спросил: «Как работает компонент кнопки?» И он разобрал код с прямыми ссылками. Он даже показал мне, как использовать все варианты кнопок с реальными примерами кода. И на этом он не остановился. Он объяснил, как комбинировать кнопку с другими компонентами, такими как значки, выпадающие меню, и даже как правильно использовать ссылку Next.js внутри кнопки.
Вы также можете использовать Code Wiki для генерации контекстных файлов для вашего ИИ-кодера. Например, я попросил его создать файл instructions.mmarkdown для Copilot, используя запрос «создать instructions.mmarkdown для Copilot, обобщающий архитектурные стандарты и шаблоны, которым должен соответствовать Copilot в этом проекте». И немедленно он произвел полный файл markdown. Вы можете поместить его прямо в свой проект, и ваш ИИ-кодер поймет структуру, правила и шаблоны, что означает, что он будет генерировать гораздо лучший код. Я слежу за выпуском для частных репозиториев, потому что именно тогда эта вещь становится невероятно мощной для реальных команд.
Спасибо за просмотр. Увидимся в следующем видео.