Documentação para desenvolvedoresSkill

Skill do Once Email

Pare de reescrever esperas frágeis em cada teste

Adicione um fluxo revisado a um aplicativo próprio ou autorizado: verifique requisitos, planeje, aguarde com prazo, exija correspondência única, retorne evidência ocultada e sempre limpe.

Skill preliminar open source disponível

O que resolve

Antes: cada projeto reescreve polling, correspondência, erros e limpeza.

Com o Skill: doctor, plan, um teste limitado e recuperação explícita.

Depois: a CI recebe uma causa útil e ocultada, não apenas “e-mail ausente”.

Três fluxos autorizados comuns

Código de verificação

Link de confirmação

Notificação e entrega

doctor → plan → run → cleanup

$test-email-flows
doctor
plan
executar um fluxo autorizado
exigir cleanup=cleaned

Escopo seguro

Criar caixa isolada, consultar com prazo, validar e excluir.

Dados fora do modelo

Chaves, endereços, códigos, links, corpos e anexos não entram em prompts ou logs.

Responsabilidade do Skill

Orquestra operações revisadas e retorna apenas resultados ocultados.

Resultado confiável

Separe prazo, ambiguidade, asserção e limpeza; retorne apenas evidência ocultada.

Fluxo recomendado

  1. Prossiga somente com acesso à API explicitamente autorizado e credenciais válidas já emitidas com as permissões mínimas necessárias. Guarde-as em um mecanismo de segredos do processo; sem esse acesso, limite-se a revisar a documentação e os downloads.
  2. Criar uma caixa por teste.
  3. Acionar e-mail do sistema autorizado.
  4. Consultar com prazo.
  5. Retornar só resultado ocultado.
  6. Sempre excluir a caixa.

Prompt + Demo

Prompts seguros e demo autorizado

Não cole chaves, endereços, códigos, links ou mensagens.

Guia completa de uso

Baixar pacote local versionado

Use somente aplicações próprias ou autorizadas. Once Email apenas recebe e-mail.

Documentação e código públicos; API controlada e downloads preliminares fora dos registros. Documentação pública e downloads preliminares não concedem acesso à API. A criação de chaves API e as chamadas reais não estão abertas ao público.

Verifique SHA256SUMS antes de extrair.

Ponto inicial local exato

unzip test-email-flows-0.1.0-private.2.zip

Do download à limpeza

  1. Baixe o Skill completo e verifique a soma.
  2. Instale toda a pasta test-email-flows.
  3. Recarregue o agente e confirme o Skill.
  4. Mantenha chave e e-mail fora do chat; rode doctor e plan.
  5. Prossiga somente com acesso à API explicitamente autorizado e credenciais válidas já emitidas com as permissões mínimas necessárias. Guarde-as em um mecanismo de segredos do processo; sem esse acesso, limite-se a revisar a documentação e os downloads. Execute um fluxo sem trace, vídeo ou capturas.
  6. Exija cleanup=cleaned e não abra o diário 0600.

Falhas e recuperação

Separe 400/401/403/404/413/429/503, timeout, ambiguidade, extração, asserção e limpeza. Tente novamente apenas dentro do prazo.