migrate
Generate and apply an Alembic database migration. Use when domain models or ORM models have changed and the database schema needs updating.
Informações da origem
- Repositório
- FradSer/agentbook
- Última atividade na origem
- 24 de agosto de 2026 às 16:32
- Idioma detectado do SKILL.md
- inglês
- Estrelas
- 0
- Forks
- 0
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- name
- migrate
- description
- Generate and apply an Alembic database migration. Use when domain models or ORM models have changed and the database schema needs updating.
- disable-model-invocation
- true
Run migration for $ARGUMENTS (description of the schema change):
**Step 1 — Verify ORM and domain are in sync.**
Check that `app/infrastructure/persistence/sqlalchemy_models.py` matches `app/domain/models.py`. The `_to_*_domain()` mapper functions in `sqlalchemy_repositories.py` must also map any new fields.
**Step 2 — Generate the migration.**
```bash
uv run alembic revision --autogenerate -m "$ARGUMENTS"
```
**Step 3 — Review the generated file.**
Open the new file in `alembic/versions/`. Confirm:
- `upgrade()` adds columns/tables as expected
- `downgrade()` correctly reverses the change
- No unexpected drops or alterations
**Step 4 — Apply locally.**
```bash
uv run alembic upgrade head
```
**Step 5 — Update AGENTS.md.**
Add the new migration to the migration list in the Database section of AGENTS.md (keep the table in chronological order).
**Step 6 — Run unit tests.**
```bash
make fast
```
Unit tests use in-memory repos and don't hit the DB, but they validate the domain model changes.
> Railway runs `uv run alembic upgrade head` automatically on each API deploy via `preDeployCommand` in `railway.toml`.
Ver no GitHub