Claude Odoo Builder
19prince/claude-odoo-builderСкилл для разработчиков на Odoo: одна команда разворачивает полный проект с инструментами, воркфлоу и конфигурацией для проектирования, сборки и публикации страниц на сайте Odoo через JSON-RPC.
Установка
pip install requests python-dotenvREADME
Claude Odoo Builder
Превращает Claude Code в конструктор сайтов Odoo. Одна команда разворачивает полноценный проект с инструментами, воркфлоу и конфигурацией для проектирования, сборки и публикации страниц на вашем сайте Odoo.
Отказ от ответственности
Загружая и развёртывая эти файлы, вы берёте на себя полную ответственность. Ни 19 Prince, ни Darren не несут ответственности за рост или падение продуктивности, травмы от погружения в кроличью нору, потерянный сон или навязчивые разговоры о Claude Code.
Серьёзно, я старался предоставить вам полезные инструменты и искренне надеюсь, что они вам понравятся. Тем не менее — читайте файлы и будьте осторожны. Вы берёте на себя полную ответственность за любые результаты.
Что включено
Скиллы
| Скилл | Триггер | Что делает |
|---|---|---|
| new-odoo-project | /new-odoo-project | Разворачивает полный проект конструктора сайтов Odoo — инструменты, воркфлоу, .env и CLAUDE.md |
| odoo-theme-fix | Поделитесь скриншотом + попросите исправить | Анализирует скриншот страницы, пишет точечные CSS-переопределения и отправляет их через RPC |
Инструменты (Python-скрипты)
| Инструмент | Назначение |
|---|---|
odoo_client.py | Общий JSON-RPC клиент Odoo, используемый всеми остальными инструментами |
get_page.py | Получает HTML любой страницы с автоматическим резервным копированием |
list_pages.py | Выводит список всех страниц сайта со статусом публикации |
push_page.py | Создаёт или обновляет страницы с QWeb-обёрткой |
validate_html.py | Валидатор HTML перед отправкой на совместимость с Odoo |
scaffold_snippet.py | Генерирует скелеты модулей пользовательских сниппетов |
migrate_to_production.py | Переносит изменения со staging в production с резервным копированием и откатом |
Воркфлоу (Markdown SOP)
| Воркфлоу | Назначение |
|---|---|
design_page.md | Пошаговое руководство по проектированию новых страниц |
design_system.md | Справочник Bootstrap/Odoo с 13 готовыми к вставке шаблонами секций |
push_to_odoo.md | Как безопасно отправлять контент в Odoo |
css_theming.md | Внедрение CSS через custom_code_head |
create_snippet.md | Как собирать и развёртывать модули пользовательских сниппетов |
manage_pages.md | Справочник операций со страницами (список, получение, обновление, удаление) |
migrate_staging_to_prod.md | Полное руководство по миграции с dry-run и откатом |
Требования
- Установленный Claude Code
- Python 3.8+
- Экземпляр Odoo с правами администратора (URL, имя базы данных, email для входа)
Установка
- Клонируйте репозиторий:
git clone https://github.com/19prince/claude-odoo-builder.git
- Скопируйте скиллы в директорию скиллов Claude Code:
cp -r claude-odoo-builder/skills/* ~/.claude/skills/
- Установите зависимости Python:
pip install requests python-dotenv
Быстрый старт
Откройте Claude Code в терминале и введите:
/new-odoo-project
Claude запросит у вас:
- Директорию проекта — где должен находиться проект
- Имя клиента/проекта — короткое название проекта
- URL Odoo — URL вашего экземпляра Odoo
- Имя базы данных — имя вашей базы данных Odoo
- Email для входа — email, который вы используете для входа в Odoo
- Staging или production? — есть ли у вас отдельный staging-сервер
Claude создаёт структуру проекта и файл .env с шаблоном учётных данных. Пароль вы вводите самостоятельно — Claude его не видит.
После настройки
Добавьте пароль
Откройте файл .env в вашем проекте и заполните ODOO_PASSWORD=:
nano ~/projects/my-website/.env
Проверьте подключение
Claude автоматически тестирует соединение. Если всё работает, вы увидите список всех страниц сайта со статусом публикации.
Проверьте редактор сайта
Войдите в бэкенд Odoo, откройте редактор сайта и убедитесь, что:
- Миниатюры блоков сниппетов загружаются без значков предупреждений
- Блоки можно перетаскивать на страницу
- При клике на элементы появляются панели инструментов для текста и изображений
Если блоки отображаются с оранжевыми значками предупреждений — сообщите Claude, есть быстрое исправление (установка theme_clean).
Возможности
Проектирование и сборка страниц
Опишите Claude нужную страницу. Он спланирует макет, напишет совместимый с Odoo HTML с использованием готовых шаблонов, провалидирует его и опубликует на вашем сайте.
Стилизация через CSS
Claude внедряет пользовательский CSS через custom_code_head Odoo — модуль темы не нужен. Опишите желаемые изменения, и он напишет скопированный CSS.
Управление страницами
Выводите список всех страниц, получайте HTML для редактирования, публикуйте или снимайте с публикации, создавайте новые страницы с нуля.
Исправление визуальных проблем по скриншотам
Поделитесь скриншотом — Claude определит сломанные элементы, напишет точечные CSS-исправления и применит их, не затрагивая содержимое страницы.
Миграция staging в production
Собирайте на staging, затем переносите в production с автоматическим резервным копированием и откатом одной командой.
Структура проекта
После настройки папка проекта выглядит так:
my-website/
.env # Учётные данные Odoo (никогда не передаются)
CLAUDE.md # Инструкции, которые Claude читает каждую сессию
.tmp/ # Временные рабочие файлы
tools/ # Python-скрипты для взаимодействия с Odoo
workflows/ # Пошаговые руководства, которым следует Claude
Советы
- Всегда запускайте dry-run перед миграцией — у инструмента миграции есть флаг
--dry-run - Claude читает воркфлоу автоматически — попросите его спроектировать страницу, и он сначала прочитает
design_page.md - Всё резервируется — перед любой деструктивной операцией инструменты сохраняют резервную копию в
.tmp/ - Пароли остаются локально — только в вашем файле
.env, который никогда не коммитится
Лицензия
MIT — см. LICENSE.