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
ghCLI 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— vereditoapproveinformado na delegação (ou front matterreviewed: trueno Feature.md). Task sem aprovação de review NÃO abre PR — retorne aordd-devpara rodar a revisão formal
Lê (upstream)
branch-baseconfirmada pelo operador no Gate de branch dordd-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) eRN-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: globdelivery/<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-*.mdpré-IMP-035;TASKS*.mdpré-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-reviewerausente ourequest-changes(semreviewed: true) → recusar abrir PR e retornar aordd-devpara revisão formal — nunca abrir PR não revisado. - Branch sem commits novos vs. base:
git log base..headvazio → aborta — PR vazio não se cria; oriente commitar/push antes. ghCLI sem auth (gh auth statusfalha) ou não instalado: aborte e encaminhe aordd-gh-setupantes 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-baseinformada não existe no remote: não caia paramainpor 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):
branch-baseconfirmada (fonte preferencial): base confirmada pelo operador no Gate de branch dordd-deve informada na delegação — use-a sem re-inferir.- Fallback (campo ausente): regra legada dos executors — compare
git log -1 --format=%ci mainegit log -1 --format=%ci dev— a mais recente é a target; semdev, usemain. Nunca fixemainpor 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
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".
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.
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".
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".
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".
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".