Exportação Manual de CSV

O que é: um CSV limpo e vazio de uma lista de campos que alguém já confirmou - o formato de transporte, sem nada inventado e nada oculto.

Visão Geral

Produz uma representação em CSV de um esquema de negócios confirmado. Use-o para modelos de CSV, arquivos de importação, CSV compatível com Excel, um CSV de importação do Notion, um CSV de preparo de banco de dados ou um arquivo de entrega entre sistemas.

CSV é transporte de dados, não um banco de dados. Este é um auxiliar: ele não define sua própria tabela e renderiza qualquer lista de campos que o módulo ativo já confirmou, então o cabeçalho aqui é o mesmo cabeçalho que o módulo emite.

Camada: n/a. Encaixa-se: todas as fases. Código da tabela: n/a - renderiza a tabela do módulo ativo.

Quando Usar Esta Habilidade

• me dê um modelo de CSV
• exporte isso como um CSV
• preciso de um arquivo para importar em outro sistema
• prepare estes dados para um carregamento
• entregue isso para outra equipe como um CSV
• torne isso importável no Notion

Use-o também quando um módulo confirmou uma lista de campos e o usuário deseja essa lista como um arquivo para um sistema que não é deste repositório.

Não o use quando o usuário pediu apenas um mapeamento, uma explicação ou um formato diferente. Em seguida, gere apenas o que foi solicitado.

Como Funciona

Siga o contrato de execução compartilhado. As regras específicas do módulo abaixo definem apenas campos de domínio, decisões, cálculos e restrições de segurança.

Etapa 1 - Identificar a intenção

Leia a solicitação e escolha a intenção antes de perguntar qualquer coisa.

• "um modelo" -> um modelo de CSV vazio: linha de cabeçalho, sem linhas de dados.
• "com algumas linhas para ver o formato" -> um CSV com linhas de exemplo, apenas quando solicitado, e obviamente falsas.
• "esta importação rejeitou meu arquivo", "as colunas estão erradas" -> correção de CSV: apenas as colunas ou a escapagem que foi solicitada.
• "o que vai em qual coluna" -> mapeamento de colunas CSV: o mapeamento, sem arquivo.
• "para o Notion", "para carregar no pacote de contabilidade" -> CSV para importação nesse sistema, que pode precisar de uma codificação ou um delimitador que o usuário nomeie.

Por padrão, sem linhas de exemplo e com UTF-8:

example_rows: false
encoding: UTF-8

Use UTF-8 com marca de ordem de byte quando a compatibilidade com o Excel for importante. Peça um delimitador apenas quando o sistema de destino for um que o usuário nomeou e seu delimitador não for uma vírgula.

Etapa 2 - Pergunte apenas o que está faltando

Reutilize tudo o que já foi confirmado, inclusive pelo módulo que possui a lista de campos: os nomes e tipos de campo, as opções de seleção, os campos de data e moeda, os status e os IDs. Nunca pergunte novamente por informações que o usuário já forneceu.

Faça uma pergunta curta por mensagem, e apenas quando a resposta mudar o arquivo:

P: Você quer apenas o cabeçalho ou algumas linhas de exemplo?

P: Qual sistema está importando este arquivo?

Se a resposta não alterar materialmente o resultado, não pergunte.

Etapa 3 - Mantenha o contexto interno

Mantenha as respostas nesta forma. Ela permanece interna - não é mostrada ao usuário, a menos que eles peçam, e nunca carrega um valor que o usuário não deu.

module: csv-manual-export
intent: null            # set in Step 1, one of: template, examples, import, correction, mapping
source_module: null     # the module whose field list this renders
target_system: null     # named only when the user names one
delimiter: ","
encoding: UTF-8
bom: true               # false only when the target system rejects a byte order mark
example_rows: false
confirmed_facts: []     # only what the user actually said
open_questions: []      # the unanswered ones, in the order worth asking

source_module é o único campo que esta habilidade precisa e que uma habilidade de módulo não tem. Se for desconhecido, pergunte qual lista exportar, porque um cabeçalho inventado a partir de um palpite é um cabeçalho que o usuário terá que corrigir manualmente.

Etapa 4 - Recomende o menor fluxo de trabalho

Produza uma saída já solicitada sem perguntar novamente. Para solicitações apenas de aconselhamento, dê uma recomendação curta e ofereça a saída relevante.

Abordagem recomendada: um arquivo UTF-8, um cabeçalho com os nomes exatos dos campos na ordem canônica e nenhuma linha. Adicione uma nota de tipo de uma linha ao lado, se o sistema importador precisar.

Por que esta: um CSV não carrega tipos, fórmulas, relações ou validação. O arquivo é a metade fácil; as colunas que chegam como Texto do outro lado são a metade que decide se a importação valeu a pena.

Fluxo de trabalho: Lista de campos confirmada -> Cabeçalho escrito -> Codificação e delimitador definidos -> (importado) -> Tipos de coluna definidos do outro lado

Etapa 5 - Construa apenas sob demanda

…