rdd-migration
Gera MIGRATION.md durante o período de migração de dados real. Define estratégia de corte, mapeamento de dados, scripts de migração e rollback. Só deve ser executada com trigger explícito do usuário. Use quando o usuário pedir "migração de dados", "estratégia de corte" ou "MIGRATION".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-migration
- description
- Gera MIGRATION.md durante o período de migração de dados real. Define estratégia de corte, mapeamento de dados, scripts de migração e rollback. Só deve ser executada com trigger explícito do usuário. Use quando o usuário pedir "migração de dados", "estratégia de corte" ou "MIGRATION".
03 SKILL.md 正文
rdd-migration — Estratégia de Migração
Gera <modulo>/<projeto>/support/MIGRATION.md com a estratégia de migração de
dados do sistema legado para o novo. Condicional — só executada quando
houver migração de dados real em andamento.
Referências
- Documentos condicionais:
docs/CONSTITUTION.md §11 - Fonte primária de dados:
docs/CONSTITUTION.md §6
Resolução de caminhos (IMP-011)
Os artefatos do módulo seguem a estrutura com subpastas (IMP-011):
- Raiz: PROJECT_CHARTER.md, CONSTITUTION.md, REQUIREMENTS.md, DECISIONS.md, CHANGELOG.md
specs/: DATA_MODEL.md, API_CONTRACTS.md, ERROR_CATALOG.md, UI_SPEC.md, ARCHITECTURE.md, SECURITY.md, ACCEPTANCE_CRITERIA.md, USER_STORIES.md, US<NNN>.md, FIGMA_PROMPTS.md, COMPLIANCE.mdquality/: TEST_STRATEGY.md, DEFINITION_OF_DONE.md, TRACEABILITY.md, VALIDATION_REPORT.md, PROPAGATION_STATUS.md, PROGRESS_REPORT.mddelivery/: TASKS.md, TASKS_.md, TASKS_AZURE_CONSOLIDADO.md, SCOPE_AGREEMENT.md, CLIENT_REQUIREMENTS.md, CLIENT_REPORT_.md, HANDOVER_LOG.mdsupport/: LEGACY_CONTEXT.md, KNOWN_ERRORS.md, MIGRATION.md, CHANGE_REQUESTS.mdglossaries/: DEV_GLOSSARY.md, BUSINESS_GLOSSARY.md, USER_GLOSSARY.md, GLOSSARY.mddocs/: howto/*.md e documentos auxiliaresmeetings/,contracts/: checkpoints (inalterados)
Regra de fallback (transição): ao LER um artefato, verifique primeiro
o caminho novo (ex: specs/DATA_MODEL.md); se não existir, use o caminho
legado na raiz do módulo (ex: DATA_MODEL.md). Ao ESCREVER/GERAR, use
sempre o caminho novo. Módulos ainda não migrados via rdd-restructure
continuam legíveis durante a transição.
Lê (upstream)
<modulo>/<projeto>/support/LEGACY_CONTEXT.md(tabelas, queries, dados legados; fallback: raiz)<modulo>/<projeto>/specs/DATA_MODEL.md(modelo novo; fallback: raiz)<modulo>/<projeto>/specs/API_CONTRACTS.md(se existir; fallback: raiz)<modulo>/<projeto>/REQUIREMENTS.md(RNs de migração, se houver)
Gera (downstream)
<modulo>/<projeto>/support/MIGRATION.md
Nunca edita
LEGACY_CONTEXT.mdDATA_MODEL.md
Tools
read(ler LEGACY_CONTEXT.md, DATA_MODEL.md, REQUIREMENTS.md)write(escrever MIGRATION.md)question(para decisões de estratégia de migração)
Modo de erro
strict — se a migração falhar, o corte não pode prosseguir.
Algoritmo
- Leia
support/LEGACY_CONTEXT.mdespecs/DATA_MODEL.mdpara mapear tabelas legadas → tabelas novas - Defina o escopo da migração: tabelas, volume estimado e estratégia por tabela
- Elabore o mapeamento campo a campo com transformações necessárias
- Escreva os scripts UP (migração) e DOWN (rollback)
- Defina cronograma, validações pós-migração e riscos
- Escreva
support/MIGRATION.md
Formato de commit
docs: add migration plan for <projeto>
Template — MIGRATION.md
---
project: <NOME>
module: migracao
audience: [tecnica]
status: draft
---
# Migration Plan — [Nome do Sistema]
> **Última atualização:** DD/MM/AAAA
> **Status:** planejamento | em_andamento | concluido | revertido
---
## 1. Escopo da Migração
| Tabela legada | Tabela nova | Volume estimado | Estratégia |
|---|---|---|---|
## 2. Mapeamento de Dados
| Campo legado | Campo novo | Transformação | Observação |
|---|---|---|---|
## 3. Scripts
### 3.1 Migração (UP)
```sql
-- script de migração
3.2 Rollback (DOWN)
-- script de reversão
4. Cronograma
| Etapa | Data | Responsável |
|---|
5. Validação Pós-Migração
| Verificação | Query de validação | Resultado esperado |
|---|
6. Riscos
| Risco | Probabilidade | Impacto | Mitigação |
|---|
## Casos de Borda
- **`support/LEGACY_CONTEXT.md` inexistente** — execute `rdd-legacy-context` antes; sem o inventário legado não há mapeamento confiável.
- **Migração parcial** — documente apenas as tabelas acordadas; liste as fora do escopo.
- **Rollback executado** — atualize o status para `revertido` e registre motivo e ponto de restauração.
- **Volume alto** — prefira migração em lotes (batches) e documente o critério de corte no cronograma.
- **Sem trigger explícito do usuário** — não execute; a skill é condicional ao período real de migração.
04 同仓库更多 Skills
rdd-wiki-lint
Audita integridade dos artefatos RDD: contradições entre seções, artefatos órfãos, referências cruzadas quebradas, links internos inválidos e drift de estrutura. Complementa rdd-validate (que valida a DAG de RNs → downstreams) e rdd-decision-audit (que valida DECISIONS.md) com foco em integridade documental dos artefatos individualmente. Use quando o usuário pedir "lint dos documentos", "verificar integridade dos artefatos", "wiki lint", "contradições nos docs" ou "validar estrutura".
rdd-vps-troubleshoot
Diagnóstico guiado por sintoma para VPS da organização já configurada — container unhealthy / healthcheck expirando, GHCR denied/unauthorized no pull, git "could not read Username for 'https://github.com'", GitHub Actions (appleboy/ssh-action) falhando SSH (handshake failed, ParsePrivateKey), services systemd duplicados do cloudflared em activating (auto-restart), requisições caindo no servidor errado (tunnel compartilhado), porta ocupada, logs (journalctl / docker logs), conectividade (curl local vs público, ss, nc) e banco vazio / migrations não aplicadas. Base de conhecimento: runbook.md nesta pasta (sintomas genéricos de deploy em VPS; lições de produção da organização no pack `rules/<pack-da-organizacao>.md` — IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário reportar "container unhealthy", "deploy falhou", "ssh action erro", "ghcr denied", "tunnel não responde", "banco vazio", "sem tabelas", "service duplicado", "vps com problema" ou pedir troubleshooting de deploy.
rdd-vps-setup
Wizard guiado de setup de VPS nova (OS do perfil — ex.: Amazon Linux) para hospedar uma API — atualização do sistema, Docker + Compose + buildx, permissões de arquivos, autenticação no registry do perfil (ex.: ghcr.io), git via SSH (deploy keys), chave SSH dedicada do GitHub Actions (appleboy/ssh-action), tunnel Cloudflare EXCLUSIVO por servidor + route DNS (domínio do perfil), tunnels como serviço systemd (autostart), logging do cloudflared com rotação, pipeline completo de deploy (push main → build → registry → ssh-action → deploy.sh) e backup automatizado (RClone + cronie + canal de alerta do perfil). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-vps-setup (IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário pedir "setup de VPS", "configurar VPS nova", "preparar servidor para deploy", "tunnel cloudflare", "ghcr", "deploy key", "backup rclone", "docker compose na vps" ou "pipeline de deploy na VPS".
rdd-validate
Percorre o grafo de documentos do projeto e valida integridade: RN sem downstream esperado, ID quebrado, CR aprovado sem reflexo. Gera relatório VALIDATION_REPORT.md. Suporta flag --fix para auto-correção. Use quando o usuário pedir "validar integridade", "checar a DAG", "validar referências cruzadas" ou "validação do módulo".
rdd-ui-spec
Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir "especificação de UI", "spec de telas", "layout de formulários" ou "fluxo de navegação".
rdd-ui-capture
Captura evidência visual em runtime do sistema legado para migração (golden master de UI) via MCP Playwright — screenshots por rota/estado, requisições de rede observadas e erros de console, gravados em reverse/ui/ com manifesto reverse/UI_CAPTURE.md e candidatas visuais na fila reverse/CANDIDATES.md. Complemento runtime da engenharia reversa estática (IMP-144). Use quando o usuário pedir "captura visual", "golden master de UI", "screenshots do legado", "captura de UI" ou "ui capture".