Configurar Habilidades Matt Pocock

Quando Usar

Use quando este fluxo de trabalho corresponder à solicitação do usuário: Configurar este repositório para as habilidades de engenharia — configurar seu rastreador de issues, vocabulário de rótulos de triagem e layout de documentos de domínio. Execute uma vez antes do primeiro uso das outras habilidades de engenharia.

Fonte: mattpocock/skills (MIT).

Estruturar a configuração por repositório que as habilidades de engenharia assumem:

• Rastreador de Issues — onde as issues residem (GitHub por padrão; markdown local também é suportado pronto para uso)
• Rótulos de Triagem — as strings usadas para as cinco funções canônicas de triagem
• Documentos de Domínio — onde CONTEXT.md e ADRs residem, e as regras do consumidor para lê-los

Esta é uma habilidade orientada por prompt, não um script determinístico. Explore, apresente o que encontrou, confirme com o usuário e, em seguida, escreva.

Processo

1. Explorar

Olhe para o repositório atual para entender seu estado inicial. Leia o que existir; não presuma:

• git remote -v e .git/config — este é um repositório GitHub? Qual deles?
• AGENTS.md e CLAUDE.md na raiz do repositório — algum deles existe? Já existe uma seção ## Agent skills em algum deles?
• CONTEXT.md e CONTEXT-MAP.md na raiz do repositório
• docs/adr/ e quaisquer diretórios src/*/docs/adr/
• docs/agents/ — a saída anterior desta habilidade já existe?
• .scratch/ — sinal de que uma convenção de rastreador de issues em markdown local já está em uso

2. Apresentar descobertas e perguntar

Resuma o que está presente e o que está faltando. Em seguida, guie o usuário pelas três decisões uma de cada vez — apresente uma seção, obtenha a resposta do usuário e, em seguida, passe para a próxima. Não despeje as três de uma vez.

Presuma que o usuário não sabe o que esses termos significam. Cada seção começa com uma breve explicação (o que é, por que essas habilidades precisam disso, o que muda se eles escolherem de forma diferente). Em seguida, mostre as escolhas e o padrão.

Seção A — Rastreador de Issues.

Explicação: O "rastreador de issues" é onde as issues residem para este repositório. Habilidades como to-issues, triage, to-prd e qa leem e escrevem nele — elas precisam saber se devem chamar gh issue create, escrever um arquivo markdown em .scratch/ ou seguir algum outro fluxo de trabalho que você descreva. Escolha o local onde você realmente rastreia o trabalho para este repositório.

Postura padrão: essas habilidades foram projetadas para o GitHub. Se um git remote aponta para o GitHub, proponha isso. Se um git remote aponta para o GitLab (gitlab.com ou um host auto-hospedado), proponha o GitLab. Caso contrário (ou se o usuário preferir), ofereça:

• GitHub — issues residem nas Issues do GitHub do repositório (usa a CLI gh)
• GitLab — issues residem nas Issues do GitLab do repositório (usa a CLI glab)
• Markdown Local — issues residem como arquivos em .scratch/<feature>/ neste repositório (bom para projetos solo ou repositórios sem um remoto)
• Outro (Jira, Linear, etc.) — peça ao usuário para descrever o fluxo de trabalho em um parágrafo; a habilidade o registrará como prosa livre

Se — e somente se — o usuário escolheu GitHub ou GitLab, faça uma pergunta de acompanhamento:

Explicação: Repositórios de código aberto frequentemente recebem solicitações de recursos como pull requests, não apenas issues — um PR é uma issue com código anexado. Se você ativar isso, /triage puxará PRs externos para a mesma fila e os executará através dos mesmos rótulos e estados das issues (PRs em andamento de colaboradores são deixados em paz). Deixe desativado se PRs não forem uma superfície de solicitação para você.

• PRs como superfície de solicitação — sim / não (padrão: não). Registre a resposta em docs/agents/issue-tracker.md. Para rastreadores em markdown local e outros, pule esta pergunta — não há PRs.

Seção B — Vocabulário de Rótulos de Triagem.

Explicação: Quando a habilidade triage processa uma issue recebida, ela a move através de uma máquina de estados — precisa de avaliação, aguardando o remetente, pronto para um agente AFK pegar, pronto para um humano, ou não será corrigido. Para fazer isso, ela precisa aplicar rótulos (ou o equivalente em seu rastreador de issues) que correspondam a strings que você configurou de fato. Se o seu repositório já usa nomes de rótulos diferentes (por exemplo, bug:triage em vez de needs-triage), mapeie-os aqui para que a habilidade aplique os corretos em vez de criar duplicatas.

As cinco funções canônicas:

• needs-triage — o mantenedor precisa avaliar
• needs-info — aguardando o remetente
• ready-for-agent — totalmente especificado, pronto para AFK (um agente pode pegá-lo sem contexto humano)
• ready-for-human — precisa de implementação humana
• wontfix — não será acionado

…