difit

Sobre o difit

A skill “difit” solicita uma revisão de código ao usuário por meio do “difit”, uma ferramenta local de visualização de diferenças, após a realização de alterações no código. Isso resolve o problema de incorporar feedback de revisão humana ao fluxo de trabalho do agente: o agente executa difit em um alvo de comparação escolhido, o usuário deixa comentários de revisão na interface do difit, e esses comentários são impressos na saída padrão (stdout) quando difit é encerrado, para que o agente possa continuar o trabalho e lidar com eles. Se o servidor for desligado sem comentários, o agente interpreta isso como se nenhum comentário de revisão tivesse sido fornecido.

A skill define um conjunto reduzido de comandos. Ela seleciona o binário difit, se disponível; caso contrário, recorre ao npx difit; e, se o recurso alternativo do npx exigir acesso à rede em um ambiente isolado, ela solicita permissões elevadas e a aprovação do usuário primeiro, em vez de prosseguir silenciosamente. Os alvos de revisão incluem alterações não confirmadas, o commit HEAD, alterações preparadas, alterações não preparadas, um único commit ou uma comparação entre dois commits ou ramos. Comentários opcionais de inicialização podem ser anexados via --comment como objetos de thread JSON vinculados a caminhos de arquivos e intervalos de linhas, o que é útil para exibir os resultados da revisão diretamente no diff; e arquivos não rastreados podem ser incluídos com --include-untracked. Ele só pode ser usado dentro de um diretório gerenciado pelo Git.

Os usuários-alvo são desenvolvedores que desejam um ponto de verificação de revisão com intervenção humana após o agente editar o código. A skill é voltada para a segurança: ela instrui explicitamente a nunca copiar segredos, tokens, senhas, chaves de API, chaves privadas ou outros materiais semelhantes a credenciais do diff para o corpo dos comentários ou argumentos de linha de comando. Suas ações se limitam a executar uma ferramenta de revisão local sobre diffs do Git, tornando-a inofensiva.

Perguntas frequentes

Como o feedback da revisão chega ao agente?

Quando o usuário deixa comentários em difit, eles são exibidos na saída padrão (stdout) ao encerrar o comando `difit`, e o agente então continua o trabalho para resolvê-los. Se difit for fechado sem comentários, isso será tratado como se nenhum comentário de revisão tivesse sido fornecido.

E se o `difit` não estiver instalado?

A skill usa difit se o comando `-v difit` for bem-sucedido; caso contrário, recorre ao `npx difit`. Se esse recurso alternativo do npx precisar de acesso à rede em uma sandbox sem permissão, ele solicita permissões elevadas e a aprovação do usuário antes de ser executado.

O que posso revisar com ela?

Alterações não confirmadas, o commit HEAD, alterações preparadas, alterações não preparadas, um único commit ou uma comparação entre dois commits ou ramos, incluindo opcionalmente arquivos não rastreados com --include-untracked.

Existem restrições de uso?

Sim, ele só pode ser usado dentro de um diretório gerenciado pelo Git, já que opera com diffs do Git.

Como ele lida com dados confidenciais nos diffs?

Ele instrui explicitamente para nunca copiar segredos, tokens, senhas, chaves de API, chaves privadas ou outros materiais semelhantes a credenciais do diff para os corpos de --comment ou quaisquer argumentos de linha de comando.

Todos os arquivos