issues

Interaja com issues do GitHub - crie, liste e visualize issues.

Quando Usar

• O usuário quer criar, listar, inspecionar ou de outra forma trabalhar com issues do GitHub.
• A tarefa envolve o recebimento de issues ou o gerenciamento de issues de repositórios através do fluxo de trabalho da CLI do GitHub.
• Você precisa de um fluxo de issues guiado que colete títulos, descrições e seleção de ações antes de executar comandos.

Instruções

Este comando ajuda você a trabalhar com issues do GitHub usando a CLI gh.

Passo 1: Determinar Ação

Use AskUserQuestion para perguntar o que o usuário deseja fazer:

Pergunta:

• question: "O que você gostaria de fazer com as issues do GitHub?"
• header: "Ação"
• multiSelect: false
• options:
  • label: "Criar nova issue" description: "Abrir uma nova issue com título, corpo e rótulos opcionais"
  • label: "Listar issues" description: "Visualizar issues abertas no repositório atual"
  • label: "Visualizar issue" description: "Ver detalhes de uma issue específica por número"

Se "Criar nova issue" for selecionado:

Passo 2a: Obter Título da Issue

Use AskUserQuestion para obter o título da issue:

Pergunta:

• question: "Qual é um título curto e fácil de ler para esta issue? Mantenha-o breve (máximo de 5-10 palavras) - os detalhes vão no corpo. (Use 'Outro' para digitar seu título)"
• header: "Título"
• multiSelect: false
• options:
  • label: "Eu digitarei um título" description: "Insira um título conciso como 'Botão de login não responde' ou 'Adicionar suporte ao modo escuro'"

Diretrizes de título:

• Mantenha os títulos CURTOS e fáceis de ler (máximo de 5-10 palavras)
• Bom: "Corrigir fluxo quebrado de redefinição de senha"
• Ruim: "Quando tento redefinir minha senha e clico no botão nada acontece e recebo um erro"
• A descrição/corpo é onde os detalhes pertencem, não o título

Se o usuário fornecer um título longo, ajude-o a encurtá-lo e mover os detalhes para o corpo.

Passo 3a: Obter Corpo da Issue

Use AskUserQuestion para coletar o conteúdo do corpo da issue:

Pergunta 1 - Contexto do tipo de issue:

• question: "Que tipo de issue é esta?"
• header: "Tipo"
• multiSelect: false
• options:
  • label: "Bug" description: "Algo quebrado que precisa ser corrigido"
  • label: "Melhoria" description: "Melhoria em funcionalidade existente"
  • label: "Nova funcionalidade" description: "Funcionalidade totalmente nova"
  • label: "Tarefa" description: "Item de trabalho geral ou tarefa"

Pergunta 2 - Descrição:

• question: "Agora forneça os detalhes completos. É aqui que você explica o contexto, o histórico e os detalhes específicos que não couberam no título. (Use 'Outro' para digitar sua descrição)"
• header: "Descrição"
• multiSelect: false
• options:
  • label: "Eu descreverei em detalhes" description: "Forneça contexto, passos, exemplos e qualquer informação relevante"

O usuário selecionará "Outro" aqui para fornecer sua descrição completa.

Diretrizes de descrição:

• É aqui que TODOS os detalhes vão - seja minucioso
• Inclua contexto: o que você estava fazendo, qual é o histórico?
• Inclua detalhes específicos: mensagens de erro, URLs, versões, etc.
• Quanto mais detalhes aqui, melhor - ao contrário do título, que deve ser breve

Pergunta 3 - Para bugs, pergunte sobre reprodução: Se o tipo de issue for "Bug", use AskUserQuestion:

• question: "Você pode fornecer passos para reproduzir este bug? (Use 'Outro' para digitar os passos)"
• header: "Passos de Reprodução"
• multiSelect: false
• options:
  • label: "Fornecer passos" description: "Eu descreverei como reproduzir a issue"
  • label: "Não reproduzível" description: "O bug é intermitente ou difícil de reproduzir"

Pergunta 4 - Comportamento esperado vs. real (para bugs): Se o tipo de issue for "Bug", use AskUserQuestion:

• question: "O que você esperava que acontecesse vs. o que realmente aconteceu? (Use 'Outro' para descrever)"
• header: "Comportamento"
• multiSelect: false
• options:
  • label: "Descrever comportamento" description: "Eu explicarei o comportamento esperado vs. o real"

Passo 4a: Obter Rótulos (Opcional)

Use AskUserQuestion para selecionar rótulos:

• question: "Quais rótulos devemos adicionar? (se houver)"
• header: "Rótulos"
• multiSelect: true
• options:
  • label: "bug" description: "Algo não está funcionando"
  • label: "enhancement" description: "Nova funcionalidade ou solicitação"
  • label: "documentation" description: "Melhorias na documentação"
  • label: "good first issue" description: "Bom para iniciantes"

Passo 5a: Criar a Issue

Construa o corpo da issue com base no tipo:

Para relatórios de bugs:

## Descrição
[Descrição do usuário]

## Passos para Reproduzir
[Passos de reprodução do usuário ou "Não reproduzível facilmente"]

## Comportamento Esperado
[O que deveria acontecer]

## Comportamento Real

…