OpenAI Codex Record & Replay: transforme uma tarefa demonstrada uma vez em uma Skill reutilizável

• Record & Replay é um recurso no Mac em que o Codex observa um fluxo de trabalho executado diretamente pelo usuário e o transforma em uma Skill reutilizável
• É adequado para tarefas repetitivas, tarefas em que preferências e regras do usuário são importantes, ou tarefas que são mais fáceis de mostrar na prática do que explicar por prompt
• Por exemplo, é possível gravar tarefas como processamento de despesas, reserva de vaga de estacionamento, criação de issues, publicação de vídeos e download recorrente de relatórios para transformá-las em Skills
• A Skill gerada pode depois ser chamada novamente em uma nova thread, bastando fornecer apenas valores que mudam a cada vez, como arquivos, intervalo de datas e conteúdo da issue
• No momento, está disponível no macOS, exige que o Computer Use esteja ativado, e nas regiões de disponibilidade inicial ficam de fora EEE, Reino Unido e Suíça

---

Objetivo do Record & Replay

• Se o usuário demonstrar uma vez ao Codex um procedimento de trabalho que já conhece, o Codex aprende esse padrão e o organiza como uma Skill
• Essa Skill inclui quando deve ser usada, quais entradas são necessárias, quais etapas devem ser seguidas e como validar o resultado
• Em vez de ser apenas um script simples de automação, a ideia se aproxima mais de o Codex armazenar como contexto reutilizável a forma real de trabalho do usuário e suas preferências implícitas

Tipos de tarefa em que funciona bem

• É adequado para tarefas com etapas estáveis e critérios de sucesso claros
• Funciona bem para tarefas que se repetem de forma parecida, mas em que apenas alguns valores de entrada mudam a cada execução
• Também permite mostrar diretamente tarefas baseadas em UI que seriam difíceis de explicar longamente em um prompt de linguagem natural
• Exemplos:
  • envio de comprovantes de despesas
  • reserva de vaga de estacionamento
  • criação de issues em um formato definido
  • publicação de vídeos
  • download periódico de relatórios

Como iniciar uma gravação

• Abra Plugins no app Codex e selecione o menu +
• Selecione Record a skill
• Revise o prompt sugerido pelo Codex, adicione o contexto necessário e envie
• Quando o Codex solicitar permissão para gravar a tarefa, autorize
• Execute no Mac o fluxo de trabalho real
• Quando terminar, pare a gravação pela barra de menu, pelo overlay ou informando ao Codex que a tarefa foi concluída

Comportamento durante a gravação

• Durante a gravação, o Codex observa as ações do usuário e o conteúdo das janelas necessários para aprender o fluxo de trabalho
• A gravação continua até que o próprio usuário a interrompa
• Por isso, é melhor manter a gravação focada apenas na tarefa que o Codex precisa aprender
• Se você continuar gravando com tarefas de organização não relacionadas ou ações posteriores, a Skill pode ficar desnecessariamente complexa

Criação e edição da Skill

• Ao parar a gravação, o Codex analisa o fluxo de trabalho capturado e cria um rascunho da Skill
• A Skill organiza condições de uso, entradas necessárias, etapas de execução e forma de validar o resultado
• Depois, você pode pedir ao Codex para refinar ainda mais a Skill
• Em especial, preferências implícitas como regras de nomenclatura de arquivos, valores padrão de campos e critérios de seleção devem ser complementadas explicitamente após a gravação

Reexecutando o fluxo de trabalho

• Em uma nova thread, peça ao Codex para usar a Skill criada
• Basta fornecer apenas os valores que mudam nesta execução
  • arquivo a ser enviado
  • conteúdo da issue a ser criada
  • intervalo de datas do relatório
  • destino da publicação
• O Codex usa essa Skill como contexto reutilizável para executar a tarefa com as ferramentas disponíveis no ambiente atual
• Ele pode executar combinando Computer Use, ações no navegador, plugins instalados e outros recursos

Dicas para obter gravações melhores

• É melhor manter a demonstração curta e completa
• Antes da gravação, convém informar ao Codex o objetivo e quais valores de entrada podem mudar a cada vez
• Use valores de entrada parecidos com os reais, mas evite informações sigilosas ou dados sensíveis
• Após a gravação, é recomendável refinar a Skill acrescentando preferências implícitas como regras de nomenclatura, valores padrão e critérios de decisão
• Quando o fluxo de trabalho terminar, pare a gravação imediatamente e evite incluir até mesmo tarefas de organização que não tenham relação

Quando criar um Plugin separado

• Record & Replay é uma forma de criar Skills rapidamente
• Se for um pacote que precisa ser distribuído com estabilidade para toda a equipe, é mais adequado transformá-lo em um Plugin separado
• Se for necessário agrupar várias Skills, incluir integração com apps, adicionar um servidor MCP ou gerenciar metadados de instalação, vale mais a pena empacotar como Plugin

Solução de problemas

• Se o Record & Replay não aparecer, é preciso verificar a configuração de requirements.toml da organização
• Se em [features].computer_use estiver definido computer_use = false, tanto o Computer Use quanto o Record & Replay ficarão desativados

---

Este é um conteúdo resumido no estilo GN+ com ajuda do ChatGPT.
Cheguei a testar rapidamente e, sinceramente, ele transformou em Skill melhor do que eu esperava.