{"meta":{"title":"Problemas de arquivamento sem interromper o fluxo","intro":"Quando algo chamar sua atenção no meio da tarefa, use Copilot CLI para registrar um problema GitHub com contexto de código, PRs vinculados e rótulos e, em seguida, volte ao que você estava fazendo.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/tutorials","title":"Tutoriais"},{"href":"/pt/copilot/tutorials/copilot-cookbook","title":"Livro de receitas do GitHub Copilot"},{"href":"/pt/copilot/tutorials/copilot-cookbook/document-code","title":"Código do documento"},{"href":"/pt/copilot/tutorials/copilot-cookbook/document-code/filing-issues-without-breaking-your-flow","title":"Problemas de arquivo sem interrupção de fluxo"}],"documentType":"article"},"body":"# Problemas de arquivamento sem interromper o fluxo\n\nQuando algo chamar sua atenção no meio da tarefa, use Copilot CLI para registrar um problema GitHub com contexto de código, PRs vinculados e rótulos e, em seguida, volte ao que você estava fazendo.\n\nCopilot CLI pode abrir issues no GitHub para você pelo terminal. Em vez de alternar para um navegador e preencher um problema manualmente, você descreve o que deseja e Copilot coleta o contexto de seu repositório e GitHub e, em seguida, cria o problema para que você possa continuar trabalhando.\n\n## Cenário de exemplo 1: Registrar uma issue a partir de uma falha de CI\n\nSua CI está falhando ou você detectou erros nos logs de produção. Em vez de seguir manualmente o stack trace até um commit, você pede a Copilot CLI que investigue e registre o problema para você.\n\n### Prompt de exemplo\n\n```text copy\nThe CI workflow on main has been failing since yesterday. Look at the failing \nrun, figure out what's breaking and which commit likely introduced it, then \ncreate an issue with the stack trace, a link to the failing run, and the \nsuspected PR that caused it. Label it \"bug\" and \"regression\".\n```\n\n### Resposta de exemplo\n\n> \\[!NOTE] A resposta a seguir é um exemplo. Respostas do Copilot Chat são não determinísticas, portanto, você pode obter uma resposta diferente da mostrada aqui.\n\nCopilot CLI usa suas ferramentas MCP do GitHub para:\n\n1. **Recupere a execução do fluxo de trabalho com falha** e extraia o rastreamento da pilha dos logs.\n2. **Identificar o código responsável** , por exemplo, `src/services/payment.ts:94`.\n3. **Pesquise commits recentes** que afetaram esse arquivo e encontre o PR que introduziu a alteração.\n4. **Crie um problema** com todo o contexto montado:\n\n   ```text\n   Created issue #421: Regression: PaymentService throws TypeError after #398\n\n   What's failing:\n   The `build` job on main has failed since commit `a3f7c21`. Stack trace:\n\n   TypeError: Cannot read properties of undefined (reading 'amount') at processRefund (src/services/payment.ts:94:22)\n\n   Introduced by: PR #398 (merged 2 days ago) refactored the payment types but missed updating `processRefund` to handle the new nullable `transaction` field.\n\n   Failing run: Actions run #2847\n\n   Suggested fix: Add a null check for `transaction` before accessing `transaction.amount` on line 94.\n\n   Labels: `bug`, `regression`\n   ```\n\n## Cenário de exemplo 2: Transformando TODOs em trabalho acompanhado\n\nCom o tempo, os comentários TODO e FIXME se acumulam em uma base de código sem visibilidade. Você pode solicitar Copilot CLI a verificação desses comentários, avaliar a prioridade e criar problemas para que o trabalho seja acompanhado.\n\n### Prompt de exemplo\n\n```text copy\nScan this repo for TODO and FIXME comments. Group them by area, pick the 5 \nmost important ones based on the surrounding code context, and create an issue \nfor each. Include the code snippet, file location, and suggest a label.\n```\n\n### Resposta de exemplo\n\n> \\[!NOTE] A resposta a seguir é um exemplo. Respostas do Copilot Chat são não determinísticas, portanto, você pode obter uma resposta diferente da mostrada aqui.\n\nCopilot CLI pesquisa a base de código, lê o contexto em torno de cada comentário e prioriza com base na gravidade:\n\n```text\nFound 23 TODO/FIXME comments across the repo. Here are the 5 I'd prioritize:\n\nCreated issue #422: FIXME: SQL injection risk in search query builder\n- src/db/search.ts:34 — user input concatenated directly into query string\n- Label: security, priority:high\n\nCreated issue #423: TODO: Rate limiter bypassed for internal routes\n- src/middleware/rate_limit.ts:12 — comment says \"temporary bypass, remove before launch\"\n- Label: security, technical-debt\n\nCreated issue #424: FIXME: Memory leak in WebSocket handler\n- src/ws/handler.ts:87 — listeners are added on each connection but never cleaned up\n- Label: bug, performance\n\nCreated issue #425: TODO: Retry logic missing for payment webhook\n- src/webhooks/payment.ts:56 — failures silently dropped, no retry queue\n- Label: reliability, priority:medium\n\nCreated issue #426: TODO: Migrate to new auth token format\n- src/auth/token.ts:3 — comment references a closing down API version\n- Label: technical-debt\n```\n\n## Leitura adicional\n\n* [GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli)"}