AGENT SKILL

rdd-gh-setup

Wizard de configuração da GitHub CLI (gh) para o workflow RDD — verifica instalação, autentica via gh auth login e valida o acesso à org GitHub do perfil (`org_github` em `rules/client-profile.md` — IMP-103/IMP-105). Idempotente e executado por demanda; delegado pelo rdd-setup. Use quando o usuário pedir "configurar gh", "setup do gh", "autenticar github cli", "instalar gh" ou "onboarding github".

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

01 前言 Front Matter

name
rdd-gh-setup
description
Wizard de configuração da GitHub CLI (gh) para o workflow RDD — verifica instalação, autentica via gh auth login e valida o acesso à org GitHub do perfil (`org_github` em `rules/client-profile.md` — IMP-103/IMP-105). Idempotente e executado por demanda; delegado pelo rdd-setup. Use quando o usuário pedir "configurar gh", "setup do gh", "autenticar github cli", "instalar gh" ou "onboarding github".

03 SKILL.md 正文

rdd-gh-setup — Wizard de Configuração da GitHub CLI

Setup da gh CLI numa máquina: garante instalação, autenticação e acesso à org GitHub do perfil (org_github). Pré-condição das skills rdd-gh-issue-creator e rdd-gh-pr-creator (e do @rdd-github-orchestrator). Idempotente — pode ser reexecutado; passos já completos são pulados.

Contexto do problema que resolve

O ecossistema GitHub do RDD depende da gh CLI instalada e autenticada, mas não havia skill de setup: o rdd-gh-issue-creator/rdd-gh-pr-creator apenas abortavam com "orientar gh auth login", e o rdd-setup não validava gh no Passo 6 nem delegava para um setup de GitHub.

Lê (upstream)

  • Saída de gh --version — instalação presente?
  • Saída de gh auth status — autenticação ativa? org atual?

Gera (downstream)

  • Relatório textual de validação (não persiste arquivo)
  • Estado autenticado da gh CLI (efeito colateral: gh auth login)

Nunca edita

  • Agentes e skills versionados (agents/rdd-*.md, skills/rdd-*/SKILL.md)
  • Artefatos de módulo RDD (REQUIREMENTS, TASKS, etc.)
  • AGENTS.md / opencode.jsonc — este setup não toca a config do OpenCode
  • Remote — nunca commita nem push

Tools

  • bash (validação: gh --version, gh auth status; gh auth login é interativo)
  • question (perguntar se deseja instalar/autenticar quando ausente)
  • read (opcional: ler bloco <!-- repositorios --> no AGENTS.md para contexto de org)

Modo de erro

warn — validações que falharem não bloqueiam a conclusão do wizard: entram no relatório como ⚠️ com orientação de correção. Só é strict na validação final mínima (sem gh instalada, reporta falha clara e orienta instalação antes de encerrar).

Formato de commit

Nenhum — este wizard não edita artefatos versionados e nunca commita.

Algoritmo

Fluxo síncrono (obrigatório)

Passo 1 → Passo 2 → Passo 3 → Passo 4 → Passo 5
              ↓           ↓           ↓
           [pular]     [pular]     [pular]

Passo 1 — Detectar estado atual

gh --version 2>&1
gh auth status 2>&1

Monte o diagnóstico:

Item Fonte Estado esperado
gh instalada gh --version versão >= 2.x exibida
Autenticada gh auth status Logged in to github.com
Org/acesso gh auth status / gh api user acesso à org org_github do perfil

Exiba o diagnóstico antes de alterar qualquer coisa.

Passo 2 — Instalação (se ausente)

Se gh --version falhar:

  • Windows: winget install --id GitHub.cli -e
  • macOS: brew install gh
  • Linux (Debian/Ubuntu): seguir docs oficiais (apt repo do GitHub CLI)

Após instalar, peça confirmação para revalidar (gh --version). Se ainda ausente (PATH não atualizado), oriente reiniciar o terminal/sessão e registre ⚠️ no relatório.

Passo 3 — Autenticação (se ausente)

Se gh auth status falhar:

gh auth login --web

Fluxo preferido: GitHub.com → HTTPS → Login with a web browser. O gh exibirá um one-time code e abrirá o browser — o wizard orienta o usuário a concluir lá. Aguarde a conclusão e revalide com gh auth status.

Passo 4 — Validar a org do perfil (org_github)

gh api user --jq .login
gh api orgs/<org_github do perfil> --jq .login 2>&1
  • Se a org responder 200 → acesso OK.
  • Se 404/403 → o usuário autenticado não tem acesso à org <org_github> do perfil; oriente solicitar acesso ao admin da org e registre ⚠️.
  • Fonte da org: rules/client-profile.md (org_github, IMP-103/IMP-105) — a skill apenas valida, não altera config global do gh. Sem perfil, pergunte a org ao operador (question agrupada).

Passo 5 — Relatório final

═══ rdd-gh-setup — <RESULTADO> ═══

✅ gh instalada: <versão>
✅ Autenticada: <login> @ github.com
✅ Org <org_github do perfil>: acesso confirmado | ⚠️ Sem acesso — solicite ao admin

🔍 Validação:
| Verificação | Estado | Observação |

Próximo passo sugerido: @rdd-github-orchestrator para issues/PRs,
ou continue o rdd-setup (Passo 6 — validação de ambiente).

Casos de borda

  • Re-execução (idempotente): itens já OK são pulados; nada é refeito.
  • gh instalada mas desatualizada: reporte a versão; upgrade é opcional (gh upgrade) — não bloqueia.
  • Múltiplas contas logadas: gh auth status pode listar várias — valide que ao menos uma tem acesso à org do perfil; não troca conta sem pedido.
  • Ambiente sem browser (SSH/headless): gh auth login --web pode falhar — oriente gh auth login com token PAT (scope repo, read:org) como alternativa.
  • winget/brew indisponível: oriente instalação manual via página de releases do cli/cli no GitHub.
  • Delegado pelo rdd-setup: ao concluir, retorne o relatório para o wizard pai seguir ao Passo 6 (validação de ambiente).

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