Esta skill pega o contexto atual da conversa e o entendimento da base de código e produz uma especificação. NÃO entreviste o usuário; apenas sintetize o que você já sabe.
O rastreador de issues e o vocabulário de etiquetas de triagem devem ter sido fornecidos a você. Caso contrário, diga ao usuário para executar /setup-matt-pocock-skills.
Processo
-
Explore o repositório para entender o estado atual da base de código, caso ainda não tenha feito isso. Use o vocabulário do glossário de domínio do projeto em toda a especificação e respeite quaisquer ADRs na área que você está tocando.
-
Esboce os pontos de teste (seams) nos quais você testará a funcionalidade. Pontos de teste existentes devem ser preferidos a novos. Use o ponto de teste mais alto possível. Se novos pontos de teste forem necessários, proponha-os no ponto mais alto que você conseguir. Quanto menos pontos de teste na base de código, melhor — o número ideal é um.
Verifique com o usuário se esses pontos de teste correspondem às expectativas dele.
- Escreva a especificação usando o modelo abaixo e, em seguida, publique-a no rastreador de issues do projeto. Aplique a etiqueta de triagem
ready-for-agent— não é necessário triagem adicional.
Declaração do Problema
O problema que o usuário está enfrentando, da perspectiva do usuário.
Solução
A solução para o problema, da perspectiva do usuário.
Histórias de Usuário
Uma lista LONGA e numerada de histórias de usuário. Cada história de usuário deve estar no formato:
- Como um , quero uma , para que <benefício>
Esta lista de histórias de usuário deve ser extremamente abrangente e cobrir todos os aspectos da funcionalidade.
Decisões de Implementação
Uma lista de decisões de implementação que foram tomadas. Isso pode incluir:
- Os módulos que serão construídos/modificados
- As interfaces desses módulos que serão modificadas
- Esclarecimentos técnicos do desenvolvedor
- Decisões arquiteturais
- Mudanças de esquema
- Contratos de API
- Interações específicas
NÃO inclua caminhos de arquivo específicos ou trechos de código. Eles podem ficar desatualizados muito rapidamente.
Exceção: se um protótipo produziu um trecho que codifica uma decisão com mais precisão do que prosa (máquina de estados, redutor, esquema, formato de tipo), inclua-o dentro da decisão relevante e observe brevemente que veio de um protótipo. Corte para as partes ricas em decisão, não uma demonstração funcional, apenas os bits importantes.
Decisões de Teste
Uma lista de decisões de teste que foram tomadas. Inclua:
- Uma descrição do que constitui um bom teste (testar apenas comportamento externo, não detalhes de implementação)
- Quais módulos serão testados
- Trabalho anterior para os testes (ou seja, tipos semelhantes de testes na base de código)
Fora do Escopo
Uma descrição das coisas que estão fora do escopo desta especificação.
Notas Adicionais
Quaisquer notas adicionais sobre a funcionalidade.