skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
promovaweb/specsfy448 installs

specsfy-data-discovery

Conversa em linguagem cotidiana sobre as informações que o produto precisa guardar, sugere uma forma simples de registrar cada uma e grava somente respostas confirmadas em .specsfy/DATABASE.md. Use quando backlog, importação do MVP ou spec dependerem de informações lembradas pelo sistema que ainda estão ausentes ou ambíguas. Não use para mapear o banco já existente no código (specsfy-aux-database), escolher tecnologia ou modelar tabelas.

How do I install this agent skill?

npx skills add https://github.com/promovaweb/specsfy --skill specsfy-data-discovery
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a developer tool used to document data requirements through a conversational interface. It facilitates the discovery of what information a system needs to store and records the confirmed results into a Markdown file within the project. The skill includes explicit instructions to avoid recording sensitive data and employs basic sanitization to ensure data integrity.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Descobrir as informações que o sistema precisa guardar

Descubra, com a pessoa e nas palavras dela, o que o sistema precisa lembrar, quem usa cada informação e quando ela muda ou deixa de valer. O resultado é um registro confirmado em .specsfy/DATABASE.md que backlog e spec usam como contexto.

Preparação obrigatória

Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa. Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma pendência.

Modo de interação

Modo de interação: perguntas. Antes de formular qualquer pergunta, leia e aplique o Contrato de perguntas numeradas de .specsfy/Spec.md.

Converse em Português do Brasil sem pedir que a pessoa descreva banco de dados, tabela, campo, chave ou relacionamento. Use as palavras do produto: o que será lembrado, quem usa, o que muda e quando deixa de ser necessário.

Pronto quando

  • Cada informação a guardar aplicável está confirmada, adiada ou encerrada pela pessoa, dentro do limite de oito perguntas por área.
  • Cada resposta confirmada foi gravada pelo comando na seção Informações a guardar confirmadas de .specsfy/DATABASE.md, com fontes.
  • Nenhuma hipótese, dado real, credencial ou informação pessoal sensível foi gravada.
  • O controle voltou à skill que chamou esta descoberta.

Preparar a conversa

  1. Leia em paralelo a origem da descoberta (Inbox, MVP.md, backlog, spec ou pedido), PROJECT.md e .specsfy/DATABASE.md quando existirem.
  2. Separe o que já está confirmado do que ainda precisa de conversa.
  3. Considere só informações que o sistema precise guardar, consultar, comparar, mostrar, compartilhar, corrigir ou apagar. Dado que não altera a jornada nem a operação fica fora da conversa.
  4. Preserve fontes e formulações da pessoa. Hipótese não entra no arquivo como conteúdo confirmado.

Perguntar sem linguagem técnica

Mantenha uma lista das informações a guardar ausentes ou ambíguas. Em cada rodada, escolha a de maior impacto ainda não confirmada. Depois de cada resposta, atualize a lista e siga para a próxima. Ajuste ao contexto perguntas como:

  • "O que você precisa lembrar sobre cada pedido, pessoa ou atendimento?"
  • "Quem pode ver ou mudar essa informação?"
  • "O que precisa continuar ligado quando uma pessoa fizer mais de um pedido?"
  • "Quando essa informação muda, deixa de valer ou precisa ser apagada?"
  • "Que informação não pode aparecer para outras pessoas?"

Não explique a mecânica interna. Se a pessoa usar termos técnicos, confirme o efeito no trabalho dela antes de registrar.

Sugerir como cada informação será registrada

Depois de entender a finalidade, proponha uma forma simples de registro, escolhida pelo uso esperado e sem citar tecnologia:

UsoSugestão
nomes, títulos e códigos lidos rapidamentetexto curto
observações e descrições maiorestexto livre
quantidades, medidas e contagensnúmero
preços, cobranças e descontosvalor em dinheiro
agendamentos, prazos e acontecimentosdata ou horário
situação, categoria ou prioridadeescolha entre opções
confirmaçõessim ou não
comprovantes e anexosarquivo ou imagem

Apresente a sugestão como hipótese, explique o motivo em uma frase e pergunte se ela representa o uso real. Registre o formato sugerido só depois da confirmação. Uma informação com usos distintos gera um registro por uso.

Registrar o que foi confirmado

Depois de cada resposta confirmada, chame o script com nome do domínio e frases curtas que quem opera o produto entenda:

specsfy context data \
  --project <raiz> \
  --name "<informação do produto>" \
  --purpose "<finalidade>" \
  --store "<informações necessárias>" \
  --format "<forma confirmada de registrar>" \
  --links "<o que permanece ligado a quê>" \
  --access "<quem consulta ou altera>" \
  --lifecycle "<quando muda, deixa de valer ou é apagado>" \
  --sources "<caminhos de Inbox, backlog, MVP ou spec>"

Pelo MCP, use a tool context_data. Sem o binário instalado, rode o script equivalente:

node .agents/skills/specsfy-data-discovery/scripts/\
registrar_dados_conversados.mjs \
  --project <raiz> \
  --nome "<informação do produto>" \
  --para-que-serve "<finalidade>" \
  --o-que-guardar "<informações necessárias>" \
  --formato-sugerido "<forma confirmada de registrar>" \
  --ligacoes "<o que permanece ligado a quê>" \
  --acesso "<quem consulta ou altera>" \
  --ciclo-de-vida "<quando muda, deixa de valer ou é apagado>" \
  --fontes "<caminhos de Inbox, backlog, MVP ou spec>"

Registre somente respostas confirmadas na seção Informações a guardar confirmadas, separada do que foi observado no código. O trecho detectado automaticamente pertence a $specsfy-aux-database e fica intocado.

Handoffs

OrigemQuando chamar esta skill
$specsfy-02-backlogantes de declarar o brief pronto, se a jornada depender de informações guardadas
$specsfy-mvp-milestone-interviewerpara cada informação a guardar ausente ou ambígua em um backlog importado, preservando MVP.md como fonte
$specsfy-03-specifyquando a fonte de dados não explicar o que a jornada precisa lembrar ou quem consulta cada informação
$specsfy-01-inboxnunca chama: a Inbox não pergunta, só preserva sinais para esta etapa

Limites

  • Não escolher tecnologia, estrutura interna ou implementação.
  • Não criar backlog, spec, tarefas, testes ou código.
  • Não preencher lacunas por inferência.
  • Não registrar conteúdo sensível.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/promovaweb/specsfy/specsfy-data-discovery">View specsfy-data-discovery on skillZs</a>