AGENT SKILL

rdd-gh-pr-creator

Cria Pull Requests no GitHub a partir de uma branch feature, vinculando a issue correspondente, com template padronizado (RNs cobertas, checklist de testes, screenshots quando aplicável). Usa gh CLI. Use quando o usuário pedir "abrir PR", "criar pull request", "PR da feature", "subir PR da task N", "abrir PR da branch".

License 许可
Apache-2.0
最近更新
2026-11-04
Stars
★ 4
Forks
1

01 前言 Front Matter

name
rdd-gh-pr-creator
description
Cria Pull Requests no GitHub a partir de uma branch feature, vinculando a issue correspondente, com template padronizado (RNs cobertas, checklist de testes, screenshots quando aplicável). Usa gh CLI. Use quando o usuário pedir "abrir PR", "criar pull request", "PR da feature", "subir PR da task N", "abrir PR da branch".

03 SKILL.md 正文

rdd-gh-pr-creator — Criação de Pull Requests no GitHub

Cria PRs no GitHub com template padronizado, vinculando a issue de origem e incluindo checklist de qualidade.

Pré-condições

  • gh CLI instalada e autenticada (gh auth status)
  • Branch feature já com push feito (git push origin feature/<slug>)
  • Pasta da feature do módulo disponível (fonte do body do PR — ver Lê)
  • Número da issue relacionada (opcional mas recomendado)
  • Task aprovada pelo rdd-dev-reviewer — veredito approve informado na delegação (ou front matter reviewed: true no Feature.md). Task sem aprovação de review NÃO abre PR — retorne ao rdd-dev para rodar a revisão formal

Lê (upstream)

  • branch-base confirmada pelo operador no Gate de branch do rdd-dev (IMP-088) e informada na delegação — fonte preferencial da base do PR
  • Estado do repositório (branch atual, commits)
  • Pasta da feature do módulo (IMP-035/037/040) — delivery/<YYYY-MM>/RN-NNN*/RN-NNN — Analise-Funcional.md (CONTEÚDO do body: descrição, comportamento) e RN-NNN — Analise-Tecnica.md (RNs do campo RNs, issue principal, referências). Como o título é variável, resolva SEMPRE por glob de prefixo da PASTA — NUNCA construa o nome exato: glob delivery/<YYYY-MM corrente>/RN-NNN* (deve retornar 1 pasta; mais de 1 → pergunte; 0 → próximo passo) → sprints anteriores (pasta de sprint mais recente) → fallbacks legados (arquivo flat pré-IMP-040; delivery/RN-*.md pré-IMP-035; TASKS*.md pré-IMP-032 — nesses, extraia RNs e descrição do próprio arquivo)
  • ISSUES_CREATED.md (se existir, para vincular issues)

Gera (downstream)

  • PR no GitHub via gh pr create

Nunca edita

  • Código fonte
  • Artefatos RDD do módulo
  • Issues existentes

Tools

  • bash (gh CLI — gh pr create, gh pr view)
  • question (confirmar antes de criar)

Modo de erro

interativo — se gh não estiver disponível, aborta e orienta. Se branch não tiver push, aborta e orienta git push.

Casos de Borda

  • Task sem aprovação de review: veredito do rdd-dev-reviewer ausente ou request-changes (sem reviewed: true) → recusar abrir PR e retornar ao rdd-dev para revisão formal — nunca abrir PR não revisado.
  • Branch sem commits novos vs. base: git log base..head vazio → aborta — PR vazio não se cria; oriente commitar/push antes.
  • gh CLI sem auth (gh auth status falha) ou não instalado: aborte e encaminhe ao rdd-gh-setup antes de reintentar.
  • PR já existente para a branch: gh pr view feature/<slug> retorna PR aberto → não duplique; reporte a URL existente e encerre.
  • branch-base informada não existe no remote: não caia para main por inferência — confirme com o operador (IMP-088) antes de criar.
  • Pasta da feature não localizada (glob retorna 0): aborta com orientação de regenerar via rdd-task-spec — nunca monte body de PR sem fonte funcional.

Workflow

Passo 1 — Coletar contexto

git branch --show-current
git log --oneline -5

Passo 2 — Montar body do PR

O conteúdo funcional vem dos arquivos da pasta da feature:

## Descrição
<"O que esta entrega faz" do RN-NNN — Analise-Funcional.md>

## RNs cobertas
- RN-XXX ✅ (campo RNs da issue principal no RN-NNN — Analise-Tecnica.md)
- RN-YYY ✅

## Review
Aprovado por @rdd-dev-reviewer (veredito: approve — `reviewed: true`)

## Docs atualizadas no ciclo
<lista dos artefatos de specs/glossaries tocados pelo executor no Passo 9
(do relatório da task) — ou "Nenhuma", com justificativa>

## Checklist
- [ ] Testes verdes (`cargo test` / `mvn verify` / `ng test`)
- [ ] Lint aprovado (`cargo clippy` / `mvn checkstyle` / `ng lint`)
- [ ] Código segue padrões da stack
- [ ] Docs vivas atualizadas apenas nas seções afetadas (specs/glossaries) — REQUIREMENTS/DECISIONS intocados
- [ ] Nenhuma spec foi editada
- [ ] (se UI) Screenshots anexados
- [ ] (se DB) Migração versionada

## Issue relacionada
Closes #<numero>

## Notas
<observações, decisões, pendências>

Passo 3 — Determinar branch target e confirmar

Determine a base nesta ordem (IMP-088):

  1. branch-base confirmada (fonte preferencial): base confirmada pelo operador no Gate de branch do rdd-dev e informada na delegação — use-a sem re-inferir.
  2. Fallback (campo ausente): regra legada dos executors — compare git log -1 --format=%ci main e git log -1 --format=%ci dev — a mais recente é a target; sem dev, use main. Nunca fixe main por padrão.

Use question para exibir o resumo e confirmar:

  • Repo: <org>/<repo>
  • Base: <target determinada>
  • Head: feature/<slug>
  • Title: <título da feature (RN-NNN)>
  • Body: (exibir resumo)

Passo 4 — Criar PR

gh pr create \
  --repo "<org>/<repo>" \
  --base "<target determinada no Passo 3>" \
  --head "feature/<slug>" \
  --title "<título>" \
  --body "<body>" \
  --label "<labels>"

Se o número da issue foi informado, o body inclui Closes #<numero> para fechamento automático.

Exemplo de uso

Usuário: "abrir PR da task de criar endpoint de bloqueios"
rdd-dev → @rdd-github-orchestrator → rdd-gh-pr-creator

Saída:
✔ PR #12 criado: Arbor-API#12 — Criar endpoint GET /bloqueios
  https://github.com/Acme-Group/Arbor-API/pull/12

04 同仓库更多 Skills

victor-souza-dev
victor-souza-dev/RDD-CORE

rdd-wiki-lint

Audita integridade dos artefatos RDD: contradições entre seções, artefatos órfãos, referências cruzadas quebradas, links internos inválidos e drift de estrutura. Complementa rdd-validate (que valida a DAG de RNs → downstreams) e rdd-decision-audit (que valida DECISIONS.md) com foco em integridade documental dos artefatos individualmente. Use quando o usuário pedir "lint dos documentos", "verificar integridade dos artefatos", "wiki lint", "contradições nos docs" ou "validar estrutura".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

rdd-vps-troubleshoot

Diagnóstico guiado por sintoma para VPS da organização já configurada — container unhealthy / healthcheck expirando, GHCR denied/unauthorized no pull, git "could not read Username for 'https://github.com'", GitHub Actions (appleboy/ssh-action) falhando SSH (handshake failed, ParsePrivateKey), services systemd duplicados do cloudflared em activating (auto-restart), requisições caindo no servidor errado (tunnel compartilhado), porta ocupada, logs (journalctl / docker logs), conectividade (curl local vs público, ss, nc) e banco vazio / migrations não aplicadas. Base de conhecimento: runbook.md nesta pasta (sintomas genéricos de deploy em VPS; lições de produção da organização no pack `rules/<pack-da-organizacao>.md` — IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário reportar "container unhealthy", "deploy falhou", "ssh action erro", "ghcr denied", "tunnel não responde", "banco vazio", "sem tabelas", "service duplicado", "vps com problema" ou pedir troubleshooting de deploy.

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

rdd-vps-setup

Wizard guiado de setup de VPS nova (OS do perfil — ex.: Amazon Linux) para hospedar uma API — atualização do sistema, Docker + Compose + buildx, permissões de arquivos, autenticação no registry do perfil (ex.: ghcr.io), git via SSH (deploy keys), chave SSH dedicada do GitHub Actions (appleboy/ssh-action), tunnel Cloudflare EXCLUSIVO por servidor + route DNS (domínio do perfil), tunnels como serviço systemd (autostart), logging do cloudflared com rotação, pipeline completo de deploy (push main → build → registry → ssh-action → deploy.sh) e backup automatizado (RClone + cronie + canal de alerta do perfil). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-vps-setup (IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário pedir "setup de VPS", "configurar VPS nova", "preparar servidor para deploy", "tunnel cloudflare", "ghcr", "deploy key", "backup rclone", "docker compose na vps" ou "pipeline de deploy na VPS".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

rdd-validate

Percorre o grafo de documentos do projeto e valida integridade: RN sem downstream esperado, ID quebrado, CR aprovado sem reflexo. Gera relatório VALIDATION_REPORT.md. Suporta flag --fix para auto-correção. Use quando o usuário pedir "validar integridade", "checar a DAG", "validar referências cruzadas" ou "validação do módulo".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

rdd-ui-spec

Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir "especificação de UI", "spec de telas", "layout de formulários" ou "fluxo de navegação".

★ 4
victor-souza-dev
victor-souza-dev/RDD-CORE

rdd-ui-capture

Captura evidência visual em runtime do sistema legado para migração (golden master de UI) via MCP Playwright — screenshots por rota/estado, requisições de rede observadas e erros de console, gravados em reverse/ui/ com manifesto reverse/UI_CAPTURE.md e candidatas visuais na fila reverse/CANDIDATES.md. Complemento runtime da engenharia reversa estática (IMP-144). Use quando o usuário pedir "captura visual", "golden master de UI", "screenshots do legado", "captura de UI" ou "ui capture".

★ 4