Переход на dbt Wizard
Перейдите с Claude Code на dbt Wizard, сохранив принятые в проекте соглашения.
dbt Wizard автоматически импортирует инструкции, навыки и настройки Claude Code из вашего репозитория. Эта страница предназначена для тех, кто уже использует Claude Code в проектах dbt и хочет перенести контекст проекта, навыки или настройки модели. Если вы только начинаете работать с ИИ-агентами, ознакомьтесь с обзором dbt Wizard.
Предварительные требования
Вам понадобятся:
- Установленный CLI dbt Wizard или включённый dbt Wizard в dbt platform
- BYOK, настроенный для поддерживаемого в CLI провайдера (OpenAI, Anthropic, AWS Bedrock или Snowflake Cortex в предварительной версии)
- Существующие файлы Claude Code, которые вы хотите перенести, например
CLAUDE.md,.claude/CLAUDE.mdили.claude/skills/
Проверьте контекст проекта и навыки
dbt Wizard автоматически считывает распространённые файлы инструкций для агентов и навыки из вашего репозитория. Обычно перед началом работы с dbt Wizard переносить существующий контекст проекта не требуется.
| Файл или папка | Что делает Wizard | Нужен ли перенос? |
|---|---|---|
AGENTS.override.md в корне проекта | Сначала проверяет этот файл на наличие локальных переопределяющих инструкций. | Нет |
AGENTS.md в корне проекта | Использует его как основной файл инструкций проекта. | Нет |
CLAUDE.md в корне проекта | Использует его как встроенный резервный вариант при отсутствии AGENTS.md. | Нет |
.claude/CLAUDE.md | Использует его как ещё один резервный файл инструкций. | Нет |
.claude/skills/NAME/SKILL.md | Автоматически обнаруживает эти файлы как навыки. | Нет |
| Многоразовые промпты или новые навыки | Размещайте их в .agents/skills/NAME/SKILL.md в корне репозитория. | Да |
dbt Wizard также проходит по дереву каталогов от корня проекта до текущего рабочего каталога, считывает файлы инструкций на каждом уровне и объединяет их для сеанса.
Полное описание формата навыков приведено в разделе Навыки.
Преобразуйте многоразовые промпты в навыки
Используйте навыки для повторяющихся рабочих процессов или специализированных инструкций, а не для общего контекста проекта, который уже содержится в AGENTS.md или CLAUDE.md. Каждый навык уровня репозитория хранится в .agents/skills/SKILL_NAME/SKILL.md.
mkdir -p .agents/skills/my-team-style
touch .agents/skills/my-team-style/SKILL.md
Затем добавьте блок метаданных и инструкции:
---
name: my-team-style
description: Apply team-specific dbt modeling conventions when creating, editing, refactoring, testing, or documenting models in this project.
---
# Team style
(add your reusable instructions here)
Сформулируйте конкретное описание в description:, поскольку dbt Wizard использует его, чтобы определить, когда загружать навык.
Настройте параметры модели
Укажите учётные данные провайдера, следуя разделу Настройка BYOK.
Чтобы задать модель по умолчанию для всех сеансов, добавьте следующую строку в ~/.dbt/wizard/config.toml:
model = "claude-sonnet-4-6" # use a model ID from `wizard debug models`
Вы также можете выбрать модель в TUI с помощью /model, не изменяя конфигурацию и не используя флаг --config. Выполните wizard --help, чтобы увидеть все доступные флаги.
Проверьте результат переноса
Запустите новый сеанс из корневого каталога проекта dbt:
wizard
Попросите dbt Wizard выполнить задачу, для которой должен использоваться перенесённый навык, например:
create a new staging model for raw_invoices
Если принятые в проекте соглашения не применяются, проверьте следующее:
- Общий контекст проекта находится в файле инструкций, например
AGENTS.mdилиCLAUDE.md - Многоразовые навыки находятся в
.agents/skills/в корне проекта или в~/.agents/skills/для навыков, доступных глобально в CLI - У навыка есть понятное описание в
description: - После добавления навыка вы начали новый сеанс
Связанная документация
- Использование dbt Wizard локально
- Навыки
- Настройка BYOK
- Сценарии использования и примеры
- Как использовать dbt Wizard в проекте dbt — рекомендуемые рабочие процессы
