| name | abrir-pr-jobs-scraper |
| description | Use quando o usuario pedir para abrir PR, criar PR, enviar PR, submeter PR, fazer pull request, ou similar no projeto Jobs Scraper Global |
Abrir PR Padronizado — Jobs Scraper Global
Skill para criar Pull Requests padronizados no GitHub, integrando com o Linear para buscar dados da task.
Pre-requisitos
Antes de iniciar, verifique se todas as ferramentas estao disponiveis:
| Ferramenta | Como verificar | Se ausente |
|---|
| MCP Linear | Checar se ferramentas mcp__linear-server__* estao disponiveis | Informar: "O MCP do Linear nao esta configurado. Adicione o server linear-server nas configuracoes do Claude Code." e parar |
| GitHub CLI | Rodar gh --version | Informar: "O GitHub CLI (gh) nao esta instalado. Instale com brew install gh." e parar |
| Git | Rodar git --version | Informar: "Git nao esta instalado." e parar |
| npm | Rodar npm --version | Informar: "npm nao esta instalado." e parar |
Se qualquer ferramenta estiver ausente, informe ao usuario qual esta faltando e pare a execucao.
Fluxo
Siga os passos abaixo na ordem, sem pular etapas.
Passo 0: Verificar pre-requisitos
Rode os comandos de verificacao da tabela acima. Se algum falhar, informe e pare.
Passo 1: Identificar task Linear
- Obter o nome da branch atual:
git branch --show-current
- Tentar extrair o padrao
PAV-\d+ (case insensitive) do nome da branch
- Se encontrou um codigo PAV-XX:
- Perguntar ao usuario: "A task desenvolvida foi a PAV-XX?"
- Se confirmar, usar esse codigo
- Se negar, perguntar qual e a task
- Se nao encontrou padrao na branch:
- Perguntar ao usuario: "Qual e o codigo da task no Linear? (ex: PAV-42)"
Passo 2: Buscar dados da task no Linear
- Usar
mcp__linear-server__get_issue com o codigo da task
- Extrair: titulo e URL da task
- Se a task nao for encontrada:
- Informar ao usuario
- Sugerir: "Deseja criar uma nova task usando
/criar-task-linear?"
- Alternativamente, permitir continuar com titulo e descricao manuais
Passo 3: Verificar commits
Importante: Este projeto usa um modelo de fork. O remote origin aponta para o fork do
desenvolvedor (ex: jeremiassnts/Jobs_Scraper_Global) e o remote upstream aponta para o
repositorio principal (Benevanio/Jobs_Scraper_Global). O PR sempre deve ser criado do fork
(origin) para o upstream, usando a flag --head do gh pr create.
- Buscar os commits da branch que estao a frente de develop:
git fetch upstream develop
git log upstream/develop..HEAD --oneline
- Se nao houver commits a frente de develop:
- Informar: "Esta branch nao tem commits a frente de develop. Nao ha mudancas para abrir PR."
- Parar a execucao
- Se ja existir um PR aberto para essa branch:
- Detectar o owner do fork:
gh repo view --json owner -q .owner.login (rodado no diretorio do projeto, que aponta para origin)
- Verificar com:
gh pr list --head <owner-do-fork>:$(git branch --show-current) --repo Benevanio/Jobs_Scraper_Global --state open
- Se existir, informar ao usuario e perguntar se quer atualizar o PR existente ou parar
Passo 4: Rodar testes
- Rodar testes do backend:
cd backend && npm test 2>&1
- Rodar testes do frontend:
cd frontend && npm test 2>&1
- Consolidar os resultados em uma string, ex:
- Se todos passaram: "Testes unitarios passando — Backend: 305/305 | Frontend: 42/42"
- Se houve falhas: "Backend: 300/305 (5 falhando) | Frontend: 42/42"
- Se testes falharem: nao bloquear. Mostrar o resultado no preview — o usuario decide se prossegue.
Passo 5: Gerar descricao do PR
- Obter o diff completo contra develop:
git diff upstream/develop..HEAD
- Obter a lista de commits:
git log upstream/develop..HEAD --oneline
- Gerar um resumo curto em linguagem natural das mudancas:
- Foco no que foi desenvolvido
- Como as mudancas se relacionam com a task e o projeto
- Texto conciso (3-5 frases no maximo)
Passo 6: Montar e mostrar preview
Montar o PR completo e mostrar ao usuario:
Titulo:
PAV-XX: <titulo da task no Linear>
Target:
Benevanio/Jobs_Scraper_Global (branch develop)
Body:
## Descricao
<resumo gerado no passo 5>
## Linear link
<URL da task no Linear>
## Como foi testado
<resultado dos testes do passo 4>
Mostrar tudo formatado e perguntar: "O PR esta correto? Confirma a criacao? (s/n)"
Passo 7: Confirmar ou editar
- Se o usuario confirmar: seguir para o passo 8
- Se o usuario nao confirmar:
- Perguntar o que deseja alterar
- Ajustar os campos conforme solicitado
- Mostrar o preview novamente (voltar ao passo 6)
Passo 8: Criar o PR
Modelo de fork: O PR e criado do fork (origin) para o upstream (Benevanio/Jobs_Scraper_Global).
E necessario usar --head <owner-do-fork>:<branch> para que o GitHub identifique corretamente
a branch de origem no fork.
- Verificar se a branch foi enviada ao remote (origin = fork):
git ls-remote --heads origin $(git branch --show-current)
- Se a branch nao existe no remote: perguntar ao usuario: "A branch ainda nao foi enviada ao remote. Deseja fazer push agora? (s/n)"
- Se confirmar, rodar:
git push -u origin $(git branch --show-current)
- Se negar, parar a execucao
- Detectar o owner do fork:
FORK_OWNER=$(gh repo view --json owner -q .owner.login)
- Criar o PR via GitHub CLI:
gh pr create \
--repo Benevanio/Jobs_Scraper_Global \
--base develop \
--head "$FORK_OWNER:$(git branch --show-current)" \
--title "PAV-XX: <titulo>" \
--body "<body completo>"
- Confirmar ao usuario com o link do PR criado
Erros comuns
- Nao verificar pre-requisitos — sempre verificar antes de iniciar
- Nao confirmar a task com o usuario — sempre perguntar, mesmo que a branch seja sugestiva
- Criar PR sem preview — sempre mostrar preview e aguardar confirmacao
- Bloquear por causa de testes falhando — mostrar as falhas, mas deixar o usuario decidir
- Esquecer de buscar upstream/develop atualizado — sempre rodar
git fetch upstream develop antes de comparar
- Nao usar --head no gh pr create — como o projeto usa fork, e obrigatorio passar
--head <owner-do-fork>:<branch> para o PR ser criado corretamente
