create-github-issues-for-unmet-specification-requirements

Sobre create-github-issues-for-unmet-specification-requirements

Esta habilidade automatiza a criação de problemas (issues) no GitHub para requisitos em um arquivo de especificação que ainda não foram implementados na base de código. Ela resolve a lacuna entre as especificações escritas e o código entregue, transformando sistematicamente os requisitos não atendidos em problemas rastreados e acionáveis, reduzindo a chance de que as necessidades documentadas sejam ignoradas silenciosamente.

O fluxo de trabalho é compacto: analisa o arquivo de especificação para extrair todos os requisitos, verifica a base de código para determinar o status de implementação de cada requisito, pesquisa problemas existentes (via search_issues) para evitar duplicatas e cria um novo problema por requisito não implementado (via create_issue) usando o modelo feature_request.yml do repositório, recorrendo ao modelo padrão quando este não estiver presente. Espera-se que cada problema contenha um ID de requisito claro e um mapeamento de descrição, diretrizes de implementação e critérios de aceitação, com rótulos como feature ou enhancement, conforme apropriado. A verificação de implementação inclui pesquisar padrões de código relacionados na base de código, verificar arquivos de especificação relacionados em um diretório /spec/ e confirmar se um requisito já não está parcialmente implementado.

Ele se destina a desenvolvedores, líderes técnicos e mantenedores de projetos que trabalham com documentos de especificação e desejam manter seu rastreador de problemas sincronizado com os requisitos não atendidos. Os casos de uso típicos incluem a inicialização de um backlog a partir de uma nova especificação, a reconciliação de uma especificação contra uma base de código existente e a garantia de que cada requisito tenha um problema rastreável. Este é um fluxo de trabalho simples de leitura e criação: ele lê a especificação e o código e escreve problemas no GitHub por meio de ferramentas padrão, sem operações destrutivas, manipulação de credenciais ou execução de código, o que o torna de baixo risco.

Perguntas Frequentes (FAQ)

O que esta habilidade produz?

Um problema do GitHub por requisito não implementado encontrado na especificação, cada um com um ID de requisito e descrição, diretrizes de implementação, critérios de aceitação e rótulos apropriados, como feature ou enhancement.

Como ela evita a criação de problemas duplicados?

Antes de criar problemas, ela pesquisa os problemas existentes (usando search_issues) e verifica se cada requisito já não está implementado ou parcialmente implementado na base de código.

Qual modelo de problema ela utiliza?

Ela utiliza o modelo feature_request.yml do repositório e recorre ao modelo padrão se esse não estiver disponível.

Como ela determina se um requisito está implementado?

Ela pesquisa padrões de código relacionados na base de código e verifica arquivos de especificação relacionados em um diretório /spec/ para avaliar o status de implementação.

Eu forneço o arquivo de especificação?

Sim. A habilidade opera em um arquivo de especificação apontado por você, extraindo todos os requisitos dele antes de verificar o status de implementação.