Guia7 min de leitura

Guia de Demonstração de Issue do GitHub com Agente de IA

Transforme o resultado de uma issue numa tarefa que os colegas possam inspecionar.

Utilize um vídeo de navegador focado para esclarecer o resultado de uma issue do agente de IA, sem tratar o ficheiro como prova de conclusão.

Ver como funcionaOs primeiros 60 segundos de vídeo são gratuitos, com marca de água.
Verifique o seu correio eletrónico para o descarregar.

Uma demonstração de issue do GitHub com agente de IA deve tornar uma única tarefa visível mais fácil de inspecionar junto da issue que a descreve. Não substitui o registo da issue, a revisão de implementação nem as verificações aplicáveis. O seu propósito é mais restrito e mais útil. Mostre um resultado de navegador que um colega consiga comparar com o comportamento pedido, e deixe a própria issue carregar a decisão, o âmbito e a evidência que não se conseguem ver numa gravação curta.

Esta distinção importa quando um agente passou rapidamente de uma descrição de issue para uma interface. Uma atualização escrita pode nomear ficheiros e ações, mas pode deixar outra pessoa a adivinhar o resultado de navegador. Um vídeo focado consegue remover essa ambiguidade quando mostra o estado inicial relevante, a operação ligada à issue e o estado resultante. Torna-se menos útil quando tenta resumir toda a discussão, toda a escolha de implementação ou toda a rota da aplicação.

O GogoScreen recebe o URL de uma aplicação web e uma indicação de uma linha sobre o fluxo a mostrar, e depois prepara um MP4 narrado e editado. Pode usar uma conta de demonstração para uma rota protegida por início de sessão. A edição indicada inclui aproximações ao clicar, suavização do cursor, cortes de tempos mortos e legendas. Um candidato pode continuar a falhar ou precisar de uma nova tentativa, pelo que o ficheiro deve ser verificado como contexto de issue, em vez de tratado como prova de que o trabalho pedido está concluído.

Que pergunta de issue deve o vídeo responder?

Comece pela pergunta a que um colega precisa de resposta no navegador. Pode ser se uma ação revela um controlo, se um formulário produz o estado esperado ou se um novo percurso alcança um resultado. Formule a pergunta em termos de comportamento observável, em vez do título da issue. O âmbito certo é a sequência mais pequena que permite a alguém inspecionar a resposta sem ler um longo tour de trabalho não relacionado.

Use um padrão de início, ação, resultado. O início mostra o contexto relevante para a issue. A ação é o comportamento que a issue pede a uma pessoa para inspecionar. O resultado torna o efeito visível. Este padrão dá a um colega algo concreto para comparar com a descrição escrita, e torna claro quando o candidato se desviou para um fluxo diferente.

O guia de vídeo de demonstração do agente de IA descreve a prática geral de transformar um resultado de agente numa verificação humana. O guia de vídeo de demonstração de PR do agente de IA é mais específico quando o comportamento visível sustenta uma alteração proposta. O guia de vídeo de demonstração de lançamento do agente de IA tem um padrão diferente, porque sustenta uma promessa pública, e não uma discussão de issue.

Como se prepara uma rota de issue segura?

Abra a rota manualmente e repita a tarefa selecionada antes de pedir um candidato. Verifique o estado inicial, redirecionamentos, avisos de consentimento, estados vazios e janelas modais que possam interromper a ação. Uma rota de issue útil começa perto do comportamento em questão. Não exige que um colega assista a uma sequência de ecrãs de preparação não relacionados antes de ver do que trata a issue.

Use dados não sensíveis que tornem o resultado visível legível. Não mostre um nome de cliente, um URL de cliente, um documento privado nem uma credencial. Se o percurso selecionado exigir autenticação, pode ser fornecida uma conta de demonstração descartável através do processo aprovado. No GogoScreen, as credenciais são cifradas, utilizadas para uma única renderização e depois eliminadas. Se for planeado primeiro um storyboard, as credenciais ficam cifradas durante essa sessão e são eliminadas, no máximo, duas horas após a última utilização. As pessoas a discutir a issue não devem colocá-las no texto da issue nem pedir à pessoa que prepara o vídeo para as tratar.

Confirme que a rota começa no estado relevante para a issue.
Mostre a interação que a issue pede a um colega para inspecionar.
Deixe a decisão sobre a conclusão para o registo da issue e as verificações aplicáveis.

O guia de vídeo de demonstração de software a partir de um URL oferece uma checklist mais completa de preparação de rota. O guia de demonstração de automação de navegador com agente de IA foca-se em tornar observável uma sequência de ecrã quando a automação faz parte da tarefa. Ambos só são úteis depois de o estado visível ser seguro e suficientemente estreito para outra pessoa inspecionar.

Como deve a indicação ligar-se à issue?

Escreva a indicação como uma instrução de navegador única e testável. Nomeie o ponto de partida relevante, a ação do utilizador e o resultado visível. Use os rótulos que uma pessoa vê na interface, não um resumo técnico que só faz sentido para quem fez a alteração. Isto dá a um colega uma base direta para comparar o candidato com a issue.

Evite pedidos como mostrar a issue inteira, demonstrar tudo o que o agente alterou ou provar que o trabalho está pronto. Esses pedidos pedem a um vídeo curto que decida perguntas às quais não consegue responder. Uma indicação focada faz o oposto. Identifica o resultado exato de navegador que merece atenção e torna óbvia uma incompatibilidade.

Repita a rota depois de escrever a indicação. A execução manual define a sequência pretendida, mas não garante uma renderização bem-sucedida. Se a tarefa começar a partir de uma condição frágil, prepare um estado seguro ou reduza o âmbito. O guia de vídeo de registo de alterações do agente de IA aplica esta disciplina depois de uma alteração ter sido aceite, quando a pergunta passou de comportamento proposto para uma explicação de lançamento precisa.

O que deve um colega inspecionar no candidato?

Inspecione o candidato face à pergunta da issue, e não a uma impressão geral de polimento. Confirme que o estado de abertura é relevante, que a ação é a que importa e que o resultado é visível. Assista-o sem som. Uma demonstração de issue útil continua a comunicar a transição importante antes de alguém depender de uma voz sobreposta ou legenda.

O que a issue descreve	O que o candidato tem de mostrar	Quando pedir uma nova tentativa
A condição inicial	A rota a abrir nesse estado	O vídeo começa em algo não relacionado com a issue
O comportamento a inspecionar	Essa interação, visível no ecrã	A ação está em falta, ou foi seguido um percurso diferente
O resultado esperado	O estado resultante, legível com o som desligado	O resultado está ausente, parcial ou escondido atrás de um erro

Verifique material privado ou enganador. Um erro inesperado, um estado desatualizado, um detalhe de cliente, um separador não relacionado ou um ecrã incompleto podem tornar um candidato inadequado, mesmo que a interação central pareça funcionar. Compare a narração com a sequência de ecrã. O GogoScreen procura fazer corresponder a narração ao que aconteceu no ecrã, mas quem usa a issue precisa de decidir se a explicação é precisa para esta tarefa exata.

Se o candidato precisar de uma nova tentativa, diga o que impediu a inspeção e mude a rota ou a indicação em conformidade. Não transforme um ficheiro concluído numa afirmação de conclusão. Cada conta nova recebe 60 segundos de vídeo uma única vez, com marca de água. Depois disso, os vídeos usam tempo de um plano ou de um carregamento, e o tempo só é usado quando uma renderização é bem-sucedida. Uma sequência concisa é mais fácil de comparar com uma issue do que uma gravação que mistura vários resultados não relacionados.

Quando deve o ficheiro tornar-se um tipo diferente de vídeo?

Uma demonstração de issue pode continuar útil enquanto uma tarefa está a ser discutida, mas o seu sentido muda assim que o comportamento é aceite ou partilhado mais amplamente. Uma alteração proposta pode precisar do guia de vídeo de demonstração de PR do agente de IA. Uma alteração aceite pode precisar do guia de vídeo de registo de alterações do agente de IA. Um ficheiro de lançamento precisa de uma nova verificação, porque um espectador público tem menos contexto e vai interpretar o vídeo como evidência de uma afirmação de produto.

Para uma explicação geral de projeto, o guia de demonstração de README do agente de IA pode oferecer um ponto de entrada compacto. Um vídeo de demonstração de agente de programação pode esclarecer um resultado visível junto de uma alteração técnica. Para uma comparação de fluxos de trabalho, GogoScreen versus Loom distingue a gravação manual da preparação baseada em URL, sem tratar nenhuma delas como substituto de verificar a tarefa de navegador selecionada.

Visite a página inicial do GogoScreen para compreender o fluxo de trabalho de URL e indicação. Consulte os preços para os planos e carregamentos e leia os termos antes de colocar um ficheiro num fluxo de trabalho partilhado. A pessoa responsável pela issue deve manter o julgamento final sobre se a evidência visível responde à pergunta declarada.

Esclarecimentos

Antes de começar

O que deve mostrar uma demonstração de issue do GitHub com agente de IA?

Mostre o único resultado de navegador que ajuda alguém a inspecionar a issue. Comece no estado relevante, mostre a ação ligada à issue e termine no resultado visível, sem apresentar o vídeo como substituto do registo da issue ou das verificações.

Pode um vídeo fechar uma issue por si só?

Não. Um vídeo é contexto para inspecionar comportamento de navegador. O registo da issue, as verificações aplicáveis e o julgamento humano continuam a determinar se o trabalho pedido cumpre os seus critérios declarados.

Como deve uma demonstração evitar expor detalhes da issue?

Use uma rota segura e dados preparados não sensíveis. Não mostre informação de clientes, credenciais, documentos privados nem separadores de navegador não relacionados. Reveja o candidato quanto a detalhes visíveis antes de o partilhar na discussão da issue.

Cole um URL, descreva um fluxo e obtenha um vídeo de demonstração da sua aplicação web.

Os primeiros 60 segundos de vídeo são gratuitos, com marca de água. Verifique o seu correio eletrónico para descarregar o vídeo.

Ver preços Ler os guias