Introdução

Quando o Codex usa com frequência a mesma API, fonte de logs, caixa de entrada exportada, base de dados local ou script da equipe, crie um comando para essa tarefa. O Codex pode executá-lo em qualquer pasta, examinar e filtrar os resultados e combiná-lo com git, gh, rg, testes e scripts do repositório.

Crie também uma habilidade que documente quando o Codex deve usar a CLI, qual comando executar primeiro, como limitar a saída, onde encontrar os arquivos baixados e quais comandos de gravação exigem aprovação.

Neste fluxo de trabalho, $cli-creator ajuda o Codex a criar o comando. $skill-creator ajuda o Codex a salvar uma habilidade reutilizável, como $ci-logs, que pode ser chamada pelo nome em tarefas futuras.

Como usar

Defina o que a CLI deve fazer

Comece definindo a tarefa que o Codex deve executar antes de escolher a tecnologia que ele vai usar. Uma boa CLI transforma operações recorrentes de leitura, busca, download, exportação, criação de rascunhos, upload, consulta periódica ou gravação segura em comandos que o Codex pode executar em qualquer repositório.

Compartilhe a documentação, os arquivos ou os comandos

O Codex precisa de uma referência concreta. Pode ser a documentação ou uma especificação OpenAPI, um comando curl com os dados sensíveis ocultados, o caminho de uma exportação ou de um banco de dados, uma pasta de logs ou um script existente. Se quiser que a CLI siga um estilo familiar, cole um trecho curto da saída de --help do gh, do kubectl ou de uma ferramenta da sua equipe.

Se o comando exigir autenticação, informe ao Codex o nome da variável de ambiente, o caminho do arquivo de configuração ou o fluxo de login que a CLI deve aceitar. Configure você mesmo o segredo no shell ou no arquivo de configuração. Não cole segredos no chat. Peça ao Codex que faça a verificação de configuração da CLI falhar com uma mensagem clara quando faltar autenticação.

Peça ao Codex para criar a CLI e a habilidade

Use o prompt inicial desta página. Indique o material que o Codex deve usar como referência e a primeira tarefa que a CLI deve executar.

Antes de escrever o código, o Codex deve apresentar os comandos propostos e pedir apenas as informações cuja ausência impediria a implementação.

Verifique se o comando funciona em qualquer pasta

O Codex deve ir além de executar cargo run, python path/to/script.py ou um comando de um pacote que ainda não foi instalado. Peça que ele teste o comando instalado a partir de outro repositório ou de uma pasta temporária, como faria em uma tarefa futura.

Teste a CLI como um agente faria em uma tarefa futura

Se o Codex retornar um bloco enorme de JSON, peça que ele limite a resposta padrão e acrescente uma opção para exportar o payload completo para um arquivo. Se ele esquecer quais operações exigem aprovação, peça que atualize a habilidade antes de usá-la em outra tarefa.

Use a habilidade em outra tarefa

Quando precisar da CLI novamente, chame a habilidade sem precisar colar a documentação outra vez:

Para trabalhos recorrentes, teste a habilidade uma vez em um chat e depois peça ao Codex para agendar, no próprio chat, uma tarefa que repita a mesma chamada.