使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-specialist-data-modeling開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
Modelar os dados do produto
Use esta skill para entender e evoluir dados persistentes, sem escolher banco ou biblioteca por suposição. Leia a stack, o sistema atual, migrations, schemas, models, contratos e testes antes de propor alteração.
Trabalho
- Identifique as entidades, seus papéis e as relações observadas no código.
- Registre campos, tipos, obrigatoriedade, origem, ciclo de vida e quem pode
consultar ou alterar cada informação.
- Descreva unicidade, consistência, retenção, exclusão, histórico e migração
quando forem pertinentes.
- Atualize a seção de dados da spec e encaminhe respostas confirmadas para
$specsfy-aux-database e .specsfy/DATABASE.md.
- Derive cenários para criação, leitura, atualização, exclusão, autorização e
dados inválidos. A implementação usa o especialista do banco detectado.
Não invente campos, relações ou tecnologia. A pessoa confirma o que o produto precisa guardar quando o sistema atual não responder.
Quando usar
- Use ao alterar tabelas, schemas, models, migrations ou contratos persistentes.
- Use também ao mapear relações e ciclos de vida antes de criar uma spec.
- Não use para escolher uma biblioteca de banco sem dados do projeto.
Fluxo
- Ler stack, migrations, schemas, models e testes existentes.
- Separar entidades, relações, campos e estados observados.
- Registrar regras de unicidade, retenção, exclusão e histórico.
- Comparar a proposta com os contratos e consultas atuais.
- Encaminhar a confirmação para a skill de banco do projeto.
- Exigir uma tarefa
[MIGRATION]com arquivo versionado para qualquer mudança
ligada ao banco e conferir sua aplicação em uma base de teste.
Padrões
- Cada campo registra tipo, origem, presença e ciclo de vida.
- Cada relação informa cardinalidade e forma de carga.
- Toda migration preserva dados existentes ou descreve a conversão necessária.
Antipadrões
- Criar campos sem uso observado no produto.
- Alterar uma relação sem conferir queries, factories e testes.
- Escolher tecnologia antes de ler o stack existente.
Validação
- Rode os testes e validadores ligados ao modelo persistente.
- Confira a migration em uma cópia do banco e compare o schema resultante.
- Confirme o arquivo, o comando de aplicação e a consulta do estado da
migration antes de encerrar a tarefa.
- Não declare o modelo pronto sem uma saída verificável do projeto.
Skills relacionadas
$specsfy-aux-databasepara manter o mapa persistente do projeto.$specsfy-specialist-postgrespara detalhes próprios do Postgres.$specsfy-specialist-laravelpara migrations e models Laravel.
Leia references/standards.md para fontes de modelagem, migrations e contratos persistentes.

