Migração de Campos de Issue

Campos de issue são metadados digitados em nível de organização (seleção única, texto, número, data) que substituem soluções alternativas baseadas em rótulos por campos estruturados, pesquisáveis e entre repositórios. Cada organização recebe Priority, Effort, Start date e Target date pré-configurados, com suporte para até 25 campos personalizados.

Esta habilidade migra em massa metadados existentes para campos de issue de duas fontes:

• Rótulos de repositório: Converta rótulos como p0, p1, priority/high em valores de campo de issue estruturados (por exemplo, o campo Prioridade). Suporta a migração de vários rótulos de uma vez e, opcionalmente, a remoção deles após a migração.
• Campos do Projeto V2: Copie valores de campo (seleção única, texto, número, data, iteração) de um Projeto do GitHub para os campos de issue equivalentes em nível de organização.

Quando Usar

• Campos de issue em nível de organização adicionados pelo usuário que se sobrepõem a campos de projeto existentes
• O usuário deseja copiar valores de campos de projeto para campos de issue antes de excluir os campos de projeto antigos
• O usuário pergunta sobre "migrar", "transferir" ou "copiar" dados de campos de projeto para campos de issue
• O usuário deseja converter rótulos de repositório (por exemplo, p0, p1, p2, p3) em valores de campo de issue (por exemplo, campo Prioridade)
• O usuário pergunta sobre substituir rótulos por campos de issue ou limpar rótulos após adotar campos de issue

Pré-requisitos

• A organização de destino deve ter campos de issue habilitados
• Os campos de issue devem existir no nível da organização
• Para migração de campos de projeto: os campos de issue devem ser adicionados ao projeto
• Para migração de rótulos: os rótulos devem existir nos repositórios de destino
• O usuário deve ter acesso de gravação aos repositórios (e ao projeto, se estiver migrando campos de projeto)
• A CLI gh deve estar autenticada com os escopos apropriados

Ferramentas Disponíveis

Ferramentas MCP (operações de leitura)

CLI / API REST

Consulte references/issue-fields-api.md, references/projects-api.md e references/labels-api.md para obter detalhes completos da API.

Fluxo de Trabalho

Etapa 0: Origem da Migração

Pergunte ao usuário o que ele está migrando:

1. "Você está migrando rótulos ou campos de projeto?"

   • Rótulos: prossiga para o Fluxo de Migração de Rótulos abaixo.
   • Campos de projeto: prossiga para o Fluxo de Migração de Campos de Projeto abaixo.

2. Se o usuário disser rótulos:

   • Pergunte: "Qual organização e repositório(s) contêm os rótulos?"
   • Pergunte: "Quais rótulos você deseja migrar?" (eles podem nomeá-los ou dizer "mostre-me os rótulos primeiro")

3. Se o usuário disser campos de projeto:

   • Pergunte: "Você pode compartilhar o link do seu projeto ou me dizer o nome da organização e o número do projeto?"
   • Pergunte: "Qual campo você deseja migrar?"

Fluxo de Migração de Rótulos

Use este fluxo quando o usuário desejar converter rótulos de repositório em valores de campo de issue. Os rótulos só podem ser mapeados para campos de issue de single_select (cada nome de rótulo é mapeado para um valor de opção).

Fase L1: Entrada e Descoberta de Rótulos

1. Peça ao usuário: nome da organização e repositório(s) para migrar.
2. Busque rótulos de cada repositório:

gh label list -R {owner}/{repo} --limit 1000 --json name,color,description

3. Busque campos de issue da organização:

gh api /orgs/{org}/issue-fields \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  --jq '.[] | {id, name, content_type, options: [.options[]?.name]}'

…