ChatGPT Codex: um corpo inteligente para automatizar tarefas de engenharia de software

O Codex é um software que se baseia no codex-1 O Codex é uma inteligência de engenharia de software baseada em nuvem e centrada em modelos, agora integrada ao ChatGPT. Em vez de ser uma simples ferramenta de geração de código, o Codex é um agente capaz de executar de forma autônoma tarefas de programação complexas, executadas em um ambiente de sandbox separado e seguro na nuvem, com a capacidade de pré-carregar a base de código do usuário. Ele executa tarefas como desenvolver novos recursos, corrigir bugs e responder a perguntas sobre a base de código com base em instruções de linguagem natural. Durante a execução, ele não apenas lê e grava arquivos, mas também executa testes, ferramentas de formatação de código e verifica iterativamente até que a tarefa seja concluída. Após a conclusão de uma tarefa, o Codex confirma as alterações no código e fornece um registro verificável da operação, incluindo logs de terminal e saída de teste, para análise do usuário.

Lista de funções

• Executar tarefas completas de engenhariaExecute tarefas específicas de engenharia de software, como correção de bugs ou implementação de novos recursos, em um ambiente separado baseado em nuvem, com base nas instruções do usuário.
• Interação com a base de códigoCapacidade de ler, editar e gravar arquivos diretamente em um ambiente de área restrita com uma base de código de usuário pré-carregada.
• Executar comandos do terminalVocê pode executar comandos em um ambiente isolado, como a execução de ferramentas de teste (test runners), verificador de formato de código (linters) e o verificador de tipos (type checkers).
• Testes automatizados e correçõesCapacidade de executar testes de forma autônoma para validar as alterações feitas e, se o teste falhar, ele tenta repetir as alterações até que o teste seja aprovado.
• Gerar solicitações de revisão e alteração de códigoQuando a tarefa é concluída, ela é enviada git commitO GitHub Pull Request pode ser gerado para revisão manual com evidências da operação completa.
• Conformidade com as especificações do projetoÉ possível ler as informações de um projeto AGENTS.md documentação, aprender e seguir configurações específicas do ambiente de desenvolvimento, instruções de teste e procedimentos operacionais padrão do projeto.
• Perguntas e respostas sobre a base de códigoOs usuários podem fazer perguntas ao Codex para obter informações e explicações sobre a base de código carregada no momento.
• Aplicação de segregação seguraTodas as tarefas são executadas em um contêiner seguro e isolado da rede externa, garantindo a segurança do código do usuário.

Usando a Ajuda

O Codex é usado como uma poderosa inteligência de engenharia de software que vai além da geração de código tradicional. Ele simula um engenheiro de software que colabora remotamente, a quem você delega tarefas e as revisa quando são concluídas.

Processo de uso principal

1. Iniciar o Codex:
   • existir ChatGPT na barra lateral e selecione Codex.
   • Siga as diretrizes para conectar o Codex à sua base de código do GitHub. O Codex clonará essa base de código em um ambiente sandbox separado baseado em nuvem para operação.
2. executar algo:
   • Executar tarefas de programaçãoSe você quiser que ele modifique o código, como corrigir um bug ou adicionar um novo recurso, digite um comando claro e clique no botão Code Botões. Um bom comando deve conter contexto suficiente, por exemplo, "Please fix the astropy/astropy Uma pergunta na biblioteca:Modeling (usado em uma expressão nominal) separability_matrix Não é possível calcular o aninhamento corretamente CompoundModels de separabilidade".
   • Faça uma pergunta sobre a base de códigoSe quiser apenas entender algum aspecto da base de código, você pode inserir sua pergunta e clicar no botão Ask Botão. Por exemplo, "Por favor, explique onde está a lógica que lida com a autenticação do usuário neste projeto?"
3. Monitorar e aguardar:
   • Depois que a tarefa é iniciada, o Codex trabalha de forma autônoma em um ambiente sandbox em segundo plano. Dependendo da complexidade da tarefa, esse processo pode levar de 1 a 30 minutos.
   • Você pode monitorar o progresso da execução do Codex em tempo real e ele mostrará o que está sendo feito, como leitura de arquivos, execução de comandos, etc.
4. Resultados da análise:
   • Após a conclusão da tarefa, o Codex confirma as alterações de código feitas no ambiente sandbox.
   • Ele fornecerá um relatório detalhado com evidências verificáveis de sua operação, como registros de comandos de terminal executados e resultados de testes. Isso permite que você rastreie cada etapa da tarefa em sua totalidade, garantindo a transparência e a correção de sua operação.
   • Você pode analisar cuidadosamente o código que ele modifica, as mensagens de confirmação e os resultados dos testes.
5. operação de acompanhamento:
   • Solicitações de modificações: Se os resultados não forem exatamente os esperados, você poderá continuar a solicitar alterações.
   • Criação de uma solicitação de mudançaSe estiver satisfeito com os resultados, você pode fazer com que o Codex crie um Pull Request do GitHub com um único clique para facilitar a revisão do código pela sua equipe.
   • localizaçãoVocê também pode optar por integrar as alterações diretamente em seu ambiente de desenvolvimento local.

fazer uso de AGENTS.md Arquivo Boot Codex

Para tornar o Codex mais eficiente e preciso, você pode criar um AGENTS.md arquivo. Esse arquivo é semelhante ao arquivo README.mdé um manual de instruções escrito especificamente para inteligências de IA.

• corresponde ao inglês -ity, -ism, -izationCódigo de segurança: Você pode informar ao Codex em um arquivo como navegar pela sua base de código, quais instruções de teste executar, quais convenções de codificação o projeto segue e como são os procedimentos operacionais padrão.
• Exemplo de conteúdo:

  # AGENTS.md
  ## 如何运行测试
  要运行完整的测试套件，请在项目根目录执行以下命令：
  `pytest`
  ## 编码规范
  本项目遵循 PEP 8 编码规范。在提交代码前，请确保运行 `flake8 .` 并且没有错误报告。
  ## 关键模块说明
  - `src/core/auth.py`: 负责用户认证和会话管理。
  - `src/api/v1/`: V1版本的所有API端点定义。
  

Assim como os desenvolvedores humanos, o Codex tem melhor desempenho quando o ambiente de desenvolvimento está bem configurado, a estrutura de testes é estável e a documentação é clara.

cenário do aplicativo

1. Automação de tarefas de manutenção de rotina
   Tarefas altamente repetitivas e de escopo claro, como refatoração de código, renomeação de variáveis ou funções e adição de testes de unidade ao código existente, podem ser deixadas inteiramente para o Codex, liberando os desenvolvedores para se concentrarem em um trabalho mais criativo.
2. Corrigir rapidamente os bugs conhecidos
   Quando um relatório de bug claro é recebido, o desenvolvedor pode simplesmente passar o relatório como uma tarefa para o Codex, que localizará automaticamente o código problemático, escreverá um patch de correção, executará testes relevantes para verificar a eficácia da correção e, por fim, gerará uma solicitação de alteração.
3. Criar uma nova estrutura funcional
   Ao desenvolver um novo recurso, o Codex pode ser instruído a desenvolver o código da estrutura subjacente, como a criação de novos pontos de extremidade de API, a definição do modelo de dados, a geração de arquivos de amostra para componentes e assim por diante, para acelerar o início do processo de desenvolvimento.
4. Aprimorar a qualidade da base de código
   Os desenvolvedores podem delegar ao Codex a execução de tarefas de aprimoramento da qualidade do código, como "formatar todos os códigos não conformes no projeto", "criar um novo código para o user Os módulos adicionam testes para obter uma cobertura de teste de 90% ou mais", etc.

QA

1. É seguro vincular minha base de código privada ao Codex?
   O Codex executa todas as tarefas em um contêiner sandbox de nuvem totalmente isolado e seguro. Durante a execução da tarefa, o acesso à rede é desativado, e as inteligências só podem acessar repositórios de código do GitHub e pacotes de dependências pré-instalados que você autorizar por meio de comandos, e não têm acesso a sites externos, APIs ou outros serviços.
2. AGENTS.md A documentação é necessária?
   Não é obrigatório, mas contribui muito para melhorar o desempenho do Codex. Sem esse arquivo, o Codex tentará entender e manipular seu projeto com base em seu conhecimento geral de treinamento. No entanto, ao fornecer um arquivo AGENTS.md A documentação, como um guia de projeto para um engenheiro novo na equipe, pode ajudá-lo a se adaptar mais rapidamente e a seguir os padrões e processos específicos do seu projeto.
3. Qual é a diferença entre o Codex e a solicitação de trechos de código diretamente no ChatGPT?
   Esses são dois modos de trabalho completamente diferentes. A solicitação de código diretamente no ChatGPT é a "geração de texto", em que a IA gera um trecho textual de código com base em sua descrição. O Codex, por outro lado, é uma "inteligência de engenharia de software" que opera em toda a sua base de código em um ambiente de desenvolvimento real (mas isolado), lendo e gravando arquivos, executando comandos, executando testes e enviando para o controle de versão - um fluxo de trabalho automatizado completo.
4. Quanto tempo o Codex leva para executar uma tarefa? Por que ele é mais lento do que uma pergunta e resposta direta?
   O Codex executa uma tarefa de delegação assíncrona que requer uma série de etapas, como clonar a base de código, analisar os requisitos, escrever o código, executar testes iterativamente, confirmar alterações etc. Isso imita o fluxo de trabalho de um desenvolvedor real e, portanto, leva mais tempo do que o Instant Q&A, geralmente entre 1 e 30 minutos. Isso é semelhante a delegar uma tarefa em segundo plano a um colega, que leva um certo tempo para ser concluída.

Dicas do sistema codex-1

Instruções do #
- O usuário fornecerá uma tarefa.
- A tarefa envolve trabalhar com repositórios Git em seu diretório de trabalho atual.
- Aguarde até que todos os comandos do terminal sejam concluídos (ou encerre-os) antes de terminar.

Instruções do # Git
Se a conclusão da tarefa do usuário exigir a gravação ou modificação de arquivos.
- Não crie novas ramificações.
- Use o git para confirmar suas alterações.
- Se o pré-commit falhar, corrija os problemas e tente novamente.
- Verifique o status do git para confirmar seu commit. Você deve deixar sua árvore de trabalho em um estado limpo.
- Somente o código confirmado será avaliado.
- Não modifique ou altere os commits existentes.

Especificação # AGENTS.md
- Os contêineres geralmente contêm arquivos AGENTS.md. Esses arquivos podem aparecer em qualquer lugar do sistema de arquivos do contêiner. Os locais típicos incluem `/`, `~` e em vários lugares dentro dos repositórios do Git.
- Esses arquivos são uma forma de os humanos darem a você (o agente) instruções ou dicas para trabalhar no contêiner.
- Alguns exemplos podem ser: convenções de codificação, informações sobre como o código é organizado ou instruções sobre como executar ou testar o código.
- Os arquivos AGENTS.md podem fornecer instruções sobre mensagens PR (mensagens anexadas a um Pull Request do GitHub produzido pelo agente, descrevendo Essas instruções devem ser respeitadas). Essas instruções devem ser respeitadas.
- Instruções nos arquivos AGENTS.md.
- O escopo de um arquivo AGENTS.md é toda a árvore de diretórios com raiz na pasta que o contém.
- Para cada arquivo que você tocar no patch final, você deve obedecer às instruções em qualquer arquivo AGENTS.md cujo escopo inclua esse arquivo.
- As instruções sobre estilo de código, estrutura, nomenclatura etc. aplicam-se somente ao código dentro do escopo do arquivo AGENTS.md, a menos que o arquivo indique o contrário. O arquivo AGENTS.md não estabelece o contrário.
- Os arquivos AGENTS.md mais profundamente aninhados têm precedência no caso de instruções conflitantes.
- As instruções diretas do sistema/desenvolvedor/usuário (como parte de um prompt) têm precedência sobre as instruções do AGENTS.md.
- Os arquivos AGENTS.md não precisam estar apenas nos repositórios do Git. Por exemplo, você pode encontrar um em seu diretório pessoal.
- Se o AGENTS.md incluir verificações programáticas para verificar o seu trabalho, você DEVE executar todas elas e se esforçar ao máximo para validar se as verificações são aprovadas DEPOIS de todas as alterações de código terem sido feitas.
- Isso se aplica até mesmo a alterações que parecem simples, ou seja, documentação. Você ainda deve executar todas as verificações programáticas.

Instruções de citações #
- Se você navegou em arquivos ou usou comandos de terminal, deve adicionar citações à resposta final (não ao corpo da mensagem do BP) quando for relevante. As citações fazem referência a caminhos de arquivos e saídas de terminal com os seguintes formatos.
1) `[F:†L(-L)?]' '
- As citações de caminho de arquivo devem começar com `F:`. `file_path` é o caminho exato do arquivo em relação à raiz do repositório que contém o texto relevante.
- `line_start` é o número da linha inicial indexada em 1 da saída relevante dentro desse arquivo.
2) `[†L(-L)?]' '
- Em que `chunk_id` é o chunk_id da saída do terminal, `line_start` e `line_end` são os números de linha inicial e final indexados em 1 da saída relevante dentro desse bloco.
- Os finais de linha são opcionais e, se não forem fornecidos, o final da linha é igual ao início da linha, portanto, apenas uma linha é citada.
- Certifique-se de que os números de linha estejam corretos e que os caminhos de arquivo ou saídas de terminal citados sejam diretamente relevantes para a palavra ou cláusula antes da citação. antes da citação.
- Não cite linhas completamente vazias dentro do bloco, apenas cite linhas que tenham conteúdo.
- Somente cite caminhos de arquivos e saídas de terminais, NÃO cite diffs e comentários anteriores, nem cite hashes do git como ids de partes.
- Use citações de caminhos de arquivos que façam referência a quaisquer alterações de código, documentação ou arquivos e use citações de terminais somente para saídas de terminais relevantes. saída.
- Prefira citações de arquivos em vez de citações de terminais, a menos que a saída do terminal seja diretamente relevante para as cláusulas antes da citação, ou seja, a menos que a saída do terminal seja diretamente relevante para as cláusulas antes da citação. Prefira citações de arquivos em vez de citações de terminais, a menos que a saída do terminal seja diretamente relevante para as cláusulas antes da citação, ou seja
- Para tarefas de criação de RP, use citações de arquivos ao se referir a alterações de código na seção de resumo da sua resposta final e citações de terminais na seção de testes. Para tarefas de criação de RPs, use citações de arquivos quando se referir a alterações de código na seção de resumo da sua resposta final e citações de terminais na seção de testes.
- Para tarefas de resposta a perguntas, você só deve usar citações de terminal se precisar verificar programaticamente uma resposta (ou seja, contar linhas de código). Caso contrário, use citações de arquivo). Caso contrário, use citações de arquivo.