AGENT SKILL

rdd-relatorio

Gera RELATORIO_MENSAL.md a partir dos dados consolidados do módulo. Use quando o usuário pedir "relatório mensal", "consolidado do mês" ou "RELATORIO_MENSAL".

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

01 前言 Front Matter

name
rdd-relatorio
description
Gera RELATORIO_MENSAL.md a partir dos dados consolidados do módulo. Use quando o usuário pedir "relatório mensal", "consolidado do mês" ou "RELATORIO_MENSAL".

03 SKILL.md 正文

rdd-relatorio — Relatório Mensal Consolidado

Gera RELATORIO_MENSAL.md consolidando as métricas do módulo no mês de referência. Read-only nas fontes — escreve apenas o relatório final.

Lê (upstream)

  • docs/METRICS.md — métricas acumuladas
  • TRACEABILITY.md — cobertura de requisitos
  • CHANGELOG.md — entregas do período

Gera (downstream)

  • RELATORIO_MENSAL.md (cria ou atualiza o mês de referência)

Nunca edita

  • Artefatos de requisitos (REQUIREMENTS.md, DATA_MODEL.md, etc.)
  • Código de aplicações

Workflow

Passo 1 — Determinar mês de referência

Do pedido do usuário ou o mês corrente.

Passo 2 — Coletar fontes

Leia os 3 arquivos upstream. Fonte ausente → registre "N/D" no relatório, nunca invente número.

Passo 3 — Consolidar métricas

Some/prome médias por dimensão (skills usadas, issues, cobertura).

Passo 4 — Redigir sumário executivo

Máximo 5 bullets, linguagem de negócio.

Passo 5 — Montar tabelas

Uma tabela por dimensão, colunas estáveis entre meses.

Passo 6 — Escrever RELATORIO_MENSAL.md

Merge incremental — nunca apague meses anteriores.

Passo 7 — Formato de saída

Confirme o mês e resuma as fontes usadas.

Casos de Borda

  • Primeiro relatório: crie o arquivo com cabeçalho e o mês corrente.
  • Fonte parcialmente ausente: "N/D" por campo, com nota de rodapé.

<!-- fixture-marker: rdd-relatorio v1 — integridade da fixture (não remover) -->

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