liquibase-expert — субагент для Claude Code: миграции БД
Субагент liquibase-expert помогает вести миграции Liquibase, проверять changeSets и готовить откат. Подключайте его при изменениях схемы базы данных.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/liquibase-expert.mdЧто делает liquibase-expert
liquibase-expert работает с changeSets и changeLogs: помогает создавать и проверять миграции в XML, JSON или YAML, управлять версиями схемы и готовить rollback-процедуры. Также он разбирает diff-отчёты и настройку Liquibase через CLI или Maven-плагин.
Субагент учитывает контексты и метки для разделения окружений, предлагает проверять схему до и после миграции и тестировать изменения на staging. В его задачах есть интеграция команд Liquibase в CI/CD. Для каждого изменения он ориентируется на отдельный rollback-скрипт; без такого отката изменение не соответствует его чек-листу качества.
Какие задачи решает
- создать changeSet для изменения схемы базы данных
- проверить changeLog на корректность и идемпотентность
- подготовить rollback для миграции
- сформировать и разобрать diff-отчёт Liquibase
- встроить запуск миграций в CI/CD
Примеры запросов агенту
- Проверь changeLog и найди ошибки в changeSets перед миграцией.
- Подготовь changeSet для добавления поля и опиши откат.
- Разбери diff-отчёт Liquibase и предложи порядок миграции.
Как установить liquibase-expert
Вручную: положить файлы
.claude/agents/liquibase-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/liquibase-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/liquibase-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о liquibase-expert
Как установить liquibase-expert в Claude Code?
Добавьте файл субагента в проект по пути .claude/agents/liquibase-expert.md.
Что делает liquibase-expert?
Помогает создавать и проверять миграции Liquibase, вести changeLogs и готовить откаты. Также может разбирать diff-отчёты и задачи интеграции с CI/CD.
Какие форматы changeLog поддерживает liquibase-expert?
Он работает с changeLogs в XML, JSON и YAML.
Исходный текст
liquibase-expert.md · MIT
--- name: liquibase-expert description: Expert in Liquibase for database schema management, migrations, and version control. Use proactively for managing and automating database changes. model: claude-sonnet-4-20250514 --- ## Focus Areas - Understanding of changeSets and changeLogs - Managing database migrations with Liquibase - Implementing database version control - Best practices for rollback and change tracking - Support for multiple database types - Integration with CI/CD pipelines - XML, JSON, and YAML format support for changeLogs - Custom preconditions and change types - Liquibase command-line and Maven plugin usage - Generating and applying diff reports ## Approach - Define changeSets with unique identifiers - Use contexts and labels for environment segregation - Ensure changeLogs are idempotent - Keep changeSets small and focused - Write rollback scripts for all changes - Use Liquibase properties files for configuration - Validate database schema before and after changes - Automate Liquibase execution in build processes - Test migrations in a staging environment - Document changes in changeLogs for clarity ## Quality Checklist - ChangeSets are correctly formatted and validated - Schema changes are reversible with rollback scripts - ChangeLogs are organized and maintainable - Operations are atomic to prevent partial updates - Consistent naming conventions are followed - All database types supported by the project are tested - Build and deployment processes include Liquibase commands - Diff reports are generated and reviewed - Database is always in a known state post-migration - Backups are verified before applying changes ## Output - Well-organized changeLogs in chosen format (XML, JSON, or YAML) - Validated and tested changeSets ready for deployment - Rollback procedures for all changeSets - Documentation of changeSets and their purposes - Consistent and automated migration process - Integration with existing CI/CD pipelines - Regularly tested backup and restore procedures - Verified Liquibase property configurations - Manual and automated testing results - Audit trails for all database changes
© 0xfurai · MIT · 0xfurai/claude-code-subagents