---
name: "source-command-pr"
description: "Abre Pull Request(s) no GitHub a partir do arquivo PR gerado pelo /implement"
---

# source-command-pr

Use this skill when the user asks to run the migrated source command `pr`.

## Command Template

# /pr - PR Workflow

## Propósito

Abrir Pull Request(s) no GitHub a partir do arquivo PR-{us_slug}.md gerado pelo /implement. Usa GitHub MCP para criar PR, fazer upload de evidências (screenshots/videos) e adicionar body formatado. Fallback para gh CLI ou modo manual.

## Uso

```bash
/pr <us_slug>
```

## Argumentos

- `<us_slug>`: Slug da User Story (ex: US-001-cadastro-usuario)

## Workflow Steps

### S0_INPUT: Capturar US Slug
- Capturar argumento do comando
- Se não fornecido, perguntar ao usuário
- Validar formato do us_slug

### S1_VALIDATE: Validar Arquivo PR
- Busca flexível do arquivo PR:
  - Exato: ./output/{us_slug}/PR-{us_slug}.md
  - Com prefixo US: ./output/US-{us_id_number}*/PR-*.md
  - Glob amplo: ./output/*{us_id_number}*/PR-*.md
- Verificar diretórios de evidências

### S2_PARSE: Parsear Arquivo PR
- Ler conteúdo do PR-{us_slug}.md
- Extrair: us_id, us_title, resumo, pontos de atenção
- Extrair: test_results, screenshots, videos
- Construir array prs_to_create

### S3_CHECK_MCP: Verificar GitHub MCP
- Verificar disponibilidade de tools mcp__github__*
- Se disponível: prosseguir para upload
- Se não: fallback para gh CLI

### S3_5_CHECK_GH_CLI: Verificar gh CLI
- Verificar instalação: gh --version
- Verificar autenticação: gh auth status
- Verificar contexto: gh repo view
- Se ok: prosseguir para criação via gh
- Se não: modo manual

### S4_UPLOAD_EVIDENCE: Upload de Evidências
- PRÉ-REQUISITO: github_mcp_available == true
- Upload screenshots via mcp__github__create_or_update_file
- Upload videos (verificar limite ~100MB)
- Construir array evidence_urls

### S5_CREATE_PR: Criar PR via GitHub MCP
- PRÉ-REQUISITO: github_mcp_available == true
- Montar body do PR com template
- Criar PR via mcp__github__create_pull_request
- Tratar PR já existente

### S5_CREATE_PR_GH_CLI: Criar PR via gh CLI
- PRÉ-REQUISITO: gh_cli_available == true
- Montar body com paths locais de evidências
- Salvar body em /tmp/pr-body-{us_slug}.md
- Executar: gh pr create
- Tratar PR já existente

### S5_MANUAL: Modo Manual
- Gerar body formatado para copiar
- Gerar comandos gh CLI como alternativa
- Informar sobre upload manual de evidências

### S6_REPORT: Relatório Final
- Exibir PRs criados com URLs
- Informar sobre evidências
- Listar próximos passos

## Métodos de Criação (Prioridade)

1. **GitHub MCP** (preferido)
   - Upload automático de evidências
   - Criação completa do PR

2. **gh CLI** (fallback)
   - Criação do PR sem upload
   - Evidências devem ser anexadas manualmente

3. **Modo Manual** (último recurso)
   - Instruções para criação manual
   - Body do PR formatado para copiar

## Template do PR Body

```markdown
## Summary
{resumo_para_revisor - lista de bullets}

## Attention Points
{pontos_de_atencao - lista de bullets}

## Test Results

### Unit Tests
| Metric | Value |
|--------|-------|
| Total | {unit_total} |
| Passed | {unit_passed} |
| Failed | {unit_failed} |
| Coverage | {coverage}% |

### E2E Tests
| Metric | Value |
|--------|-------|
| Total | {e2e_total} |
| Passed | {e2e_passed} |
| Failed | {e2e_failed} |

### Scenarios
{lista de cenários com checkboxes}

## Evidence

### Screenshots
![{filename}]({url})

### Videos
- [{filename}]({url})

## Modified Files
{lista de arquivos agrupados}

---
🤖 Generated with AI Framework - PR Creator
```

## Outputs

| Nome | Descrição |
|------|-----------|
| all_pr_urls | Array de URLs dos PRs criados |
| final_report | Relatório final formatado |
| github_mcp_available | Flag se MCP foi usado |

---

*Gerado a partir de: pr-workflow.xml v1.0*