Дата публикации
ai_products

Wiki Builder: как за минуту развернуть вики‑базу знаний для LLM в виде markdown‑репозитория

Что нового

Wiki Builder — это новый open source плагин Wiki Builder для Claude Code из маркетплейса DAIR Academy Plugins, который автоматизирует создание вики‑баз знаний для LLM.

Что он добавляет по сравнению с ручной сборкой вики:

  • Один шаг вместо ручной рутины: вместо того чтобы каждый раз создавать папки, конфиг, промпты и лог, вы вызываете одну команду или одну фразу в Claude Code.
  • Готовые "флейворы" вики под разные задачи:
    • research
    • paper
    • domain
    • product
    • person
    • organization
    • project
  • Структура репозитория по умолчанию:
    • wiki.config.md с описанием цели, аудитории, типов страниц и правил обновления
    • raw/ для исходных материалов
    • wiki/ с index.md и тематическими подпапками
    • derived/ для производных артефактов
    • prompts/ с шаблонами промптов
    • logs/maintenance-log.md для истории обслуживания
    • sources.md c источниками
  • Полностью настроенный агентный цикл: плагин сразу добавляет промпты для компиляции, ответов на вопросы и «линтинга» структуры вики.
  • Прозрачность источников: в дизайн заложено правило — каждая фактологическая фраза в вики ссылается на sources.md, а домыслы явно помечаются.

На реальном примере — Agentic Engineering Wiki, собранной через Wiki Builder, автор за несколько часов получил:

  • 51 практический совет по агентной инженерии в 7 категориях:
    • использование инструментов
    • промптинг
    • оценка
    • надёжность
    • память
    • оркестрация
    • деплоймент
  • 9 профилей компаний: Anthropic, OpenAI, Google DeepMind, Meta, Mistral, Cohere, DeepSeek, Stripe, Modal
  • 10 конспектов научных статей, ориентированных на разработчиков
  • 14 записей про open source‑инструменты
  • раздел с отобранными дискуссиями с Hacker News и Reddit
  • таймлайн развития agentic engineering

Все это собрано без кастомных скриптов, только за счёт плагина и стандартного цикла с агентом.

Как это работает

Основная идея

Wiki Builder не меняет сам подход к LLM‑вики, а автоматизирует подготовку инфраструктуры под привычный цикл:

  1. Вы складываете исходные материалы в raw/.
  2. Просите агента (Claude Code) скомпилировать структурированные страницы в wiki/.
  3. Задаёте вопросы по теме; агент отвечает и складывает ответы в wiki/questions/.
  4. Периодически запускаете "обслуживание": поиск тонких страниц, пропущенных бэклинков, неразобранных заметок.

Раньше всё это приходилось собирать руками. Теперь:

  • Один раз ставите скилл Wiki Builder в Claude Code.
  • Говорите: «создай вики по X с флейвором Y».
  • Плагин создаёт каталог, конфиг, промпты и лог, а дальше агент уже работает по местным правилам.

Что именно ставится

Wiki Builder поставляет три ключевых компонента:

  1. Скрипт scaffolding’а

    Скрипт init_wiki.sh:

    • создаёт папки
    • рендерит шаблоны
    • копирует промпты

    По умолчанию он пишет в ~/dair-wikis/<slug>, но путь можно поменять переменной окружения WIKI_ROOT или флагом --root.

  2. Набор промпт‑шаблонов

    В каждой вики появляется папка prompts/ со стандартными промптами:

    • compile-index.md — сборка wiki/index.md
    • compile-source-page.md — превращение сырья из raw/ в страницы
    • compile-concept-page.md — концептуальные страницы
    • query-and-file.md — ответы на вопросы и сохранение их в вики
    • lint-wiki.md — проверка структуры, бэклинков, пропусков

    Эти файлы лежат локально для каждой вики, их можно редактировать под конкретный проект, не ломая глобальный скилл.

  3. Файл SKILL.md

    SKILL.md обучает Claude Code тому, как использовать плагин:

    • когда подключать Wiki Builder
    • куда класть новые вики
    • как читать wiki.config.md перед изменениями
    • каким должен быть уровень качества страниц
    • как обеспечивать привязку к источникам через sources.md

Структура новой вики

Базовый шаблон репозитория выглядит так:

agentic-engineering-wiki/
├── wiki.config.md
├── raw/
├── wiki/
│   └── index.md
├── derived/
├── prompts/
│   ├── compile-index.md
│   ├── compile-source-page.md
│   ├── compile-concept-page.md
│   ├── query-and-file.md
│   └── lint-wiki.md
├── logs/
│   └── maintenance-log.md
└── sources.md
``

Дальше вы можете добавлять любые подпапки, которые описаны в `wiki.config.md`, например:

- `wiki/papers/`
- `wiki/concepts/`
- `wiki/people/`
- `wiki/tools/`

Плагин не навязывает жёсткую структуру, он ориентируется на локальный конфиг вики.

### Флейворы

При создании вики вы указываете `flavor`, и шаблоны подстраиваются под задачу. Из коробки есть:

- `research` — исследовательские вики с акцентом на обзоры и сравнения
- `paper` — глубокие разборы одной или нескольких научных статей
- `domain` — описание предметной области
- `product` — продуктовые базы знаний
- `person` — биографические / профессиональные профили
- `organization` — профили компаний и институтов
- `project` — документация и контекст конкретного проекта

Один и тот же плагин ведёт себя по‑разному в зависимости от флейвора и настроек в `wiki.config.md`.

## Что это значит для вас

### Когда Wiki Builder полезен

Инструмент закрывает сценарии, где у вас есть **ограниченный, но насыщенный корпус материалов**, и вы хотите сделать из него живую базу знаний, а не разовый отчёт. Подходит, если вы:

- **Разрабатываете агентов или LLM‑сервисы**
  - собираете практики, паттерны, анти‑паттерны
  - хотите, чтобы каждый хороший ответ агента сохранялся и переиспользовался
- **Готовите глубокий ресёрч**:
  - по новой теме (например, agentic engineering)
  - по отдельной статье с арXiv с большим количеством контекста
- **Делаете внутреннюю базу знаний**:
  - по продукту
  - по домену
  - по конкретному проекту клиента
- **Ведёте личный или командный "исследовательский вики"**:
  - заметки по статьям
  - конспекты докладов
  - разборы компаний и инструментов

Ключевая мысль: Wiki Builder помогает **не терять ответы**, которые агент уже однажды сгенерировал. Каждый полезный вывод получает место в структуре вики и ссылку на источник. Со временем это превращается в устойчивый слой знаний, а не в поток одноразовых чатов.

### Когда лучше не использовать

Wiki Builder — это не про масштаб в десятки миллионов документов. Он не добавляет:

- векторные базы
- сложные retrieval‑пайплайны
- продвинутый поиск по embedding’ам

Если у вас огромный корпус, где критична скорость поиска по тысячам документов, придётся строить RAG‑систему на векторных индексах и использовать другие инструменты.

Wiki Builder хорош на масштабе:

- **несколько десятков статей**
- **несколько десятков страниц вики**
- **несколько проектов или компаний**

То есть примерно там, где вы обычно открываете Notion, Obsidian или папку с markdown‑файлами, но хотите, чтобы за компиляцию и поддержание структуры отвечал агент.

### Требования и ограничения

- Плагин живёт в **DAIR Academy Plugins marketplace**, а работает через **Claude Code**.
- Для использования нужен доступ к Claude Code и возможность подключить этот маркетплейс.
- Вопрос доступности Claude и DAIR Academy из России зависит от текущей политики провайдеров и может потребовать VPN.

Если у вас уже есть рабочий стек вокруг Claude Code, Wiki Builder логично добавить как "скелет" для всех ваших LLM‑вики.

## Место на рынке

Wiki Builder идёт **против** типичного подхода к LLM‑базам знаний, где первым делом поднимают:

- хранилище embedding’ов
- векторную БД
- RAG‑пайплайн с retrieval’ом и перегенерацией ответов

Здесь ставка на другое:

- **Формат** — обычный markdown‑репозиторий, который можно хранить где угодно: Git, локальная папка, облачный диск.
- **Движок** — Claude Code как агент, который:
  - читает `wiki.config.md`
  - использует локальные промпты
  - поддерживает структуру вики по заданным правилам
- **Фокус** — качество и накопление знаний, а не мгновенный поиск по гигантскому корпусу.

Напрямую сравнивать с GPT‑4o, Claude 3 или другими моделями по скорости/цене некорректно: Wiki Builder — это не модель и не API, а надстройка над Claude Code. Он не меняет стоимость токенов или скорость генерации, а работает на том, что уже даёт Anthropic.

Если смотреть по классу инструментов, Wiki Builder ближе к:

- шаблонам для Obsidian/Logseq, которые задают структуру вики
- скриптам, которые генерируют скелет документации

Но отличие в том, что здесь структура сразу "зашита" в агентный цикл Claude Code, а не остаётся чисто человеческой дисциплиной.

## Установка

Плагин лежит в маркетплейсе **DAIR Academy Plugins**. Сначала вы подключаете маркетплейс, затем ставите Wiki Builder.

```bash
/plugin marketplace add dair-ai/dair-academy-plugins
/plugin install wiki-builder@dair-academy-plugins

После этого можно обращаться к Claude Code в духе:

  • start a new wiki on agent memory using the research flavor
  • ingest these arXiv papers into my evaluation wiki and compile a concept page

Claude:

  1. Разберёт задачу.
  2. Найдёт нужную вики.
  3. Прочитает её wiki.config.md.
  4. Запустит цикл: разбор сырья → компиляция страниц → запись ответов → обслуживание структуры.

Как запустить вручную

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

Пример запуска для вики по памяти агентов:

bash "${CLAUDE_PLUGIN_ROOT}/skills/wiki-builder/scripts/init_wiki.sh" \
  agent-memory \
  --title "Agent Memory" \
  --flavor research

Здесь:

  • agent-memory — slug вики, он станет именем папки
  • --title "Agent Memory" — читаемое название, которое попадёт в конфиг
  • --flavor research — тип вики, от него зависят шаблоны и структура

Если нужно положить вики не в ~/dair-wikis/, а в другое место, задайте:

  • переменную окружения WIKI_ROOT
  • или флаг --root при вызове скрипта

Итог: кому это особенно зайдёт

Wiki Builder хорошо ложится в рабочий процесс:

  • разработчиков, которые строят агентов и хотят иметь живую базу паттернов и анти‑паттернов
  • ресёрчеров, которым надо быстро поднимать структурированные вики по новым темам или статьям
  • продуктовых и техлидов, которые ведут внутренние knowledge base по проектам, компаниям или доменам

Если вы уже храните знания в markdown и используете Claude Code, Wiki Builder экономит время на рутине и помогает превратить разрозненные ответы LLM в аккуратную, растущую вики с источниками и понятной структурой.


Читайте также