Introdução

Use /goal quando quiser que o Codex continue trabalhando em um único objetivo ao longo de vários turnos, em vez de parar ao fim do primeiro. O comando é útil quando o trabalho tem um alvo claro, permite validar o progresso a cada etapa e dá ao Codex autonomia para avançar sem pedir orientação a cada passo. Com /goal, o Codex pode trabalhar por várias horas sem precisar da sua intervenção.

Defina uma meta com /goal <objective>, consulte a meta atual com /goal e use /goal pause, /goal resume ou /goal clear quando precisar controlar a execução.

Se /goal não aparecer na lista de comandos de barra, habilite features.goals no arquivo config.toml:

[features]
goals = true

Você também pode executar codex features enable goals pela CLI ou pedir ao Codex que execute o comando.

Escolha o trabalho adequado

Uma boa meta vai além do que se resolve com um único prompt, mas tem um escopo menor que o de uma lista de tarefas sem fim definido. Ela deve indicar o que o Codex precisa alcançar, o que deve preservar, como validar o progresso e quando parar.

Uma meta funciona bem para:

• migrações de código em que já estão definidas as tecnologias de destino, as verificações de equivalência e as restrições
• refatorações de grande porte em que o Codex pode executar testes ao fim de cada etapa
• experimentos, jogos ou protótipos em que o Codex pode aprimorar continuamente uma versão que já funciona

Evite usar uma meta para reunir tarefas sem relação entre si.

Organize o ciclo de trabalho

O importante é deixar claros os critérios de conclusão. Antes de começar, o Codex precisa saber o que significa “concluído”. Em uma migração, “concluído” pode significar que a nova implementação passa nos testes de contrato e que ainda é possível reverter para a implementação anterior. Em um jogo ou protótipo, “concluído” pode significar que o aplicativo compila, inicia e corresponde à referência fornecida ou apresenta o comportamento esperado.

Deixe o Codex trabalhar com autonomia

Enquanto o Codex trabalha na meta, peça atualizações breves para ter mais confiança no andamento da execução. Uma boa atualização indica a etapa atual, o que o Codex verificou, o que falta fazer e se algo impede o avanço. Se as atualizações ficarem vagas, torne a meta mais específica em vez de acrescentar instruções avulsas. Diga ao Codex exatamente qual é a próxima etapa importante, qual comando comprova sua conclusão e em que circunstâncias ele deve pausar.

Ao trabalhar em uma meta, o Codex pode seguir por muitas horas sem que você precise conferir o andamento. Ele para quando está confiante de que atingiu a condição de parada. Assim, você pode tratar /goal como uma tarefa em segundo plano que dispensa monitoramento.

Exemplos de metas

Migrações

Seja para migrar jogos para um novo conjunto de tecnologias, aplicativos móveis para outra plataforma ou uma base de código para um novo framework, você pode usar /goal para que o Codex execute a migração:

Criação de protótipos

Ao criar um aplicativo do zero, um jogo ou uma funcionalidade, você pode usar /goal para que o Codex entregue uma primeira versão bem acabada. Para orientar o desenvolvimento dessa versão, descreva com precisão no arquivo PLAN.md o que você quer criar.

Otimização de prompts

Se você tem um conjunto de avaliações, pode usar /goal para otimizar os prompts com base nos resultados. O Codex pode analisar as falhas, ajustar o prompt, executar as avaliações novamente e repetir o processo até que a pontuação melhore ou que ele atinja a condição de parada definida por você.