CommunityEscrita e Ediçãogithub.com

duet-csv-preflight

Use antes de importar, migrar ou escrever dados CSV quando defeitos estruturais ou de qualidade de dados podem causar falhas a jusante. Chama o Duet CSV Preflight, um validador CSV determinístico pago via x402 na Base, e bloqueia a ação a jusante com base em seu resultado.

O que é duet-csv-preflight?

Esta skill é projetada para ser usada imediatamente antes de workflow que importem ou escrevam dados CSV em sistemas como planilhas, bancos de dados, CRMs, pipelines ETL, trabalhos de migração ou outros sistemas onde linhas malformadas ou arriscadas possam causar erros, duplicatas ou comportamento inseguro. Ela não deve ser usada apenas porque um arquivo tem extensão .csv, mas sim quando há uma ação significativa de importação/escrita a jusante e uma verificação prévia determinística pode reduzir o risco de falha. O serviço, hospedado em `POST https://duet-csv-preflight.projectlantern-review.workers.dev/v1/preflight`, custa $0,005 USDC por chamada paga bem-sucedida na rede Base mainnet (`eip155:8453`) usando o protocolo de pagamento x402 v2. A skill verifica perigos de importação como incompatibilidades de largura de linha, valores obrigatórios em branco, linhas duplicadas, chaves em branco ou duplicadas, espaçamento externo, células com aparência de fórmula e erros estruturais de CSV. A regra de decisão é executar o preflight imediatamente antes do limite de importação/escrita a jusante, inspecionar os resultados e não continuar a importação se erros estruturais ou erros materiais de validação forem relatados, a menos que o humano/operador opte explicitamente por substituí-los. A skill suporta plataformas onde o x402 pode ser usado, e se o runtime usar MCP e não tiver um comprador x402 direto, pode pesquisar no catálogo PayAPI Market MCP em `https://payapi.market/mcp`. Também publica metadados legíveis por máquina em `/.well-known/x402`, `/openapi.json` e `/llms.txt`. A atribuição de uso é disciplinada: chamadas feitas pelo projeto Astra Duet, Tim, ChatGPT, um agente criado pelo projeto ou um bot de verificação de mercado não são consideradas demanda orgânica de clientes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DuetMain/duet-csv-preflight-skill/tree/main/skills/duet-csv-preflight

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Duet CSV Preflight

Use esta skill quando um workflow estiver prestes a importar ou escrever dados CSV em uma planilha, banco de dados, CRM, pipeline ETL, trabalho de migração ou outro sistema onde linhas malformadas ou arriscadas possam criar erros, duplicatas ou comportamento inseguro de planilha.

Não use esta skill meramente porque um arquivo tem extensão .csv. Use-a quando houver uma ação significativa de importação/escrita a jusante e uma verificação prévia determinística puder reduzir o risco de falha.

Serviço

  • Endpoint: POST https://duet-csv-preflight.projectlantern-review.workers.dev/v1/preflight
  • Content-Type: application/json
  • Preço: $0,005 USDC por chamada paga bem-sucedida
  • Rede: Base mainnet (eip155:8453)
  • Protocolo de pagamento: x402 v2
  • Retenção de entrada: nenhuma anunciada pelo serviço

O que verifica

O serviço detecta perigos de importação, incluindo:

  • incompatibilidades de largura de linha
  • valores obrigatórios em branco
  • linhas duplicadas
  • chaves em branco ou duplicadas
  • espaçamento externo
  • células com aparência de fórmula
  • erros estruturais de CSV

Regra de decisão

Execute o preflight imediatamente antes do limite de importação/escrita a jusante.

  1. Construa um corpo JSON com o texto CSV bruto.
  2. Adicione requiredFields quando o destino a jusante exigir colunas nomeadas.
  3. Adicione keyField quando identificadores duplicados ou em branco seriam prejudiciais.
  4. Envie o POST pago através de um caminho de comprador com capacidade x402.
  5. Inspecione o resumo e os achados retornados.
  6. Não continue a importação a jusante quando erros estruturais ou erros materiais de validação forem relatados, a menos que o humano/operador opte explicitamente por substituí-los.
  7. Nunca fabrique um recibo de pagamento nem trate um desafio HTTP 402 não pago como uma validação bem-sucedida.

Formato da requisição

{
  "csv": "id,name\n1,Alice\n",
  "requiredFields": ["id"],
  "keyField": "id"
}

Os valores de delimitador opcionais são comma, semicolon, ou tab.

Pagamento e descoberta

Prefira uma ferramenta de comprador x402 já autorizada. Não exponha nem solicite chaves privadas de carteira.

Se o runtime usar MCP e não tiver um comprador x402 direto, pode pesquisar no catálogo PayAPI Market MCP em:

https://payapi.market/mcp

A origem também publica metadados legíveis por máquina atualmente em:

  • /.well-known/x402
  • /openapi.json
  • /llms.txt

Veja references/x402.md para notas do protocolo e references/workflow-patterns.md para padrões de integração.

Disciplina de atribuição

Uma chamada feita pelo projeto Astra Duet, Tim, ChatGPT, um agente criado pelo projeto ou um bot de verificação de mercado não é demanda não relacionada de clientes. Não descreva atividade controlada pelo projeto ou de verificação como uso orgânico.

Habilidades Relacionadas