Source: https://once-email.com/pt/skill

Documentação para desenvolvedores

Documentação para desenvolvedores Skill

# 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

[Baixar Skill open source](<https://once-email.com/downloads/test-email-flows-0.1.0-private.2.zip>) [Revisar no GitHub](<https://github.com/pangxin12345/once-email-sdks/tree/main/skills/test-email-flows>)

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.

## Disponibilidade atual

O Skill test-email-flows está disponível como pacote preliminar versionado. O código é público e a API segue controlada. 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.

Prompt + Demo

## Prompts seguros e demo autorizado

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

[Abrir prompts](<https://github.com/pangxin12345/once-email-sdks/blob/main/demos/skill/PROMPTS.md>) [Abrir demo](<https://github.com/pangxin12345/once-email-sdks/blob/main/demos/skill/DEMO.md>)

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.

[Baixar pacote](<https://once-email.com/downloads/test-email-flows-0.1.0-private.2.zip>) [SHA256SUMS](<https://once-email.com/downloads/SHA256SUMS>)

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.

[Ver código público](<https://github.com/pangxin12345/once-email-sdks>) [Ler guia prático](<https://once-email.com/pt/blog/temporary-email-api-testing-guide>)