Documentar Reunião
Plugin skills-only para transformar anotações ou relato por voz em um relatório estruturado de reunião ou visita comercial. O nome técnico do pacote é gpt-workflows; o nome exibido ao usuário é Documentar Reunião.
Escopo
O workflow:
- recebe anotações livres;
- extrai apenas fatos informados pelo usuário;
- valida todos os campos obrigatórios;
- pergunta somente pelos campos ausentes, inválidos ou ainda não confirmados;
- combina respostas de vários turnos;
- gera o relatório assim que o registro estiver completo; e
- permite um rascunho incompleto somente mediante override explícito.
O PoC não possui MCP, backend, banco de dados, API externa, CRM, credenciais ou persistência. A entrada de voz depende da experiência normal do ChatGPT para produzir a mensagem do usuário.
Como usar
Campos obrigatórios
- empresa (cliente);
- data da reunião ou visita;
- pessoa(s) de contato;
- tipo:
corretiva,preventiva,desenvolvimentoounegociação; - assuntos discutidos;
- próximos passos, com responsável por cada ação; e
- data para follow up.
Uma declaração explícita de que não existem próximos passos completa apenas esse campo e é registrada como Nenhum próximo passo definido. Uma declaração explícita de que não haverá follow up também é válida e é registrada como Não haverá follow up.
Datas relativas, como “ontem” ou “sexta que vem”, são interpretadas a partir da data da conversa. O relatório só é considerado completo depois que o usuário confirma ou corrige as datas interpretadas.
Estrutura
gpt-workflows/
├── plugin.json
├── .codex-plugin/
│ └── plugin.json
├── skills/
│ └── relatorio-reuniao/
│ ├── SKILL.md
│ └── agents/
│ └── openai.yaml
├── tests/
│ ├── scenarios.json
│ └── chatgpt-acceptance.md
└── scripts/
├── build_public_zip.sh
└── test_flow.py
O contrato completo de runtime está em SKILL.md: ativação, intake, campos, validação, workflow, template e orientação de entrega. tests/ e scripts/ são recursos exclusivos de desenvolvimento.
Customização
| Alteração | Arquivo |
|---|---|
| Ativação, intake, campos, validação, workflow e saída | skills/relatorio-reuniao/SKILL.md |
| Nome exibido e prompt inicial | skills/relatorio-reuniao/agents/openai.yaml |
Validação automatizada
Execute na raiz do plugin:
python3 scripts/test_flow.py
O harness é determinístico e não faz parsing de linguagem natural. Ele lê as seções marcadas no SKILL.md; as fixtures fornecem fatos já extraídos e verificam estrutura do pacote, tipos, estados, campos ausentes, confirmação de datas, overrides e conteúdo renderizado.
Superfícies de aceite
O ChatGPT Work é a superfície principal de aceite local. A aba Chat comum pode mostrar a menção sem carregar as instruções da skill e não deve ser usada como evidência. Na página inicial do ChatGPT, selecione Work; depois, digite @ no composer e selecione Documentar Reunião no menu. Texto digitado que apenas se parece com uma menção não comprova que o host anexou a skill.
No Codex, $relatorio-reuniao é usado somente como teste auxiliar de carregamento do pacote.
Antes da submissão pública:
- instale a versão pelo marketplace local;
- reinicie o ChatGPT;
- selecione a aba Work e abra uma conversa nova;
- selecione a skill pelo menu
@; e - envie
começar.
A primeira resposta deve mostrar imediatamente os sete campos obrigatórios. Os demais cenários estão em tests/chatgpt-acceptance.md.
O teste no ChatGPT para Android ocorre somente depois que o plugin estiver publicado no marketplace público e o cliente instalar essa versão pública. Android não faz parte do critério pré-submissão.
Publicação
Gere o pacote público na raiz do repositório:
./scripts/build_public_zip.sh
O script executa a validação automatizada e cria dist/documentar-reuniao-0.3.7.zip contendo somente o manifest, o logo e os dois arquivos da skill. Esse ZIP é o arquivo enviado em Create plugin → Skills only.
O relatório é entregue como a mensagem inteira da conversa, renderizado em Markdown, sem orientações ou cercas de código; o botão de cópia da mensagem copia apenas o relatório.
A tabela de próximos passos inclui a coluna Prazo com a data de cada ação; passos gerados por override sem prazo exibem Não informado.
O pacote usa estes recursos públicos obrigatórios:
Após confirmar a identidade verificada do publicador e a permissão Apps Management: Write, envie o pacote como Skills only pelo portal de submissão.
Documentação oficial: