AGENT SKILL

rdd-test-strategy

Gera TEST_STRATEGY.md e DEFINITION_OF_DONE.md a partir dos critérios de aceitação e arquitetura. Define estratégia, níveis de teste, ferramentas e a definição de done do módulo. Use quando o usuário pedir "estratégia de testes", "plano de teste", "definition of done" ou "DoD do módulo".

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

01 前言 Front Matter

name
rdd-test-strategy
description
Gera TEST_STRATEGY.md e DEFINITION_OF_DONE.md a partir dos critérios de aceitação e arquitetura. Define estratégia, níveis de teste, ferramentas e a definição de done do módulo. Use quando o usuário pedir "estratégia de testes", "plano de teste", "definition of done" ou "DoD do módulo".

03 SKILL.md 正文

rdd-test-strategy — Estratégia de Testes

Gera <modulo>/<projeto>/quality/TEST_STRATEGY.md e <modulo>/<projeto>/quality/DEFINITION_OF_DONE.md com a estratégia de testes e a definição de done para o módulo.

Referências

  • Front matter: docs/CONSTITUTION.md §2

Resolução de caminhos (IMP-011)

Os artefatos do módulo seguem a estrutura com subpastas (IMP-011):

  • Raiz: PROJECT_CHARTER.md, CONSTITUTION.md, REQUIREMENTS.md, DECISIONS.md, CHANGELOG.md
  • specs/: DATA_MODEL.md, API_CONTRACTS.md, ERROR_CATALOG.md, UI_SPEC.md, ARCHITECTURE.md, SECURITY.md, ACCEPTANCE_CRITERIA.md, USER_STORIES.md, US<NNN>.md, FIGMA_PROMPTS.md, COMPLIANCE.md
  • quality/: TEST_STRATEGY.md, DEFINITION_OF_DONE.md, TRACEABILITY.md, VALIDATION_REPORT.md, PROPAGATION_STATUS.md, PROGRESS_REPORT.md
  • delivery/: TASKS.md, TASKS_.md, TASKS_AZURE_CONSOLIDADO.md, SCOPE_AGREEMENT.md, CLIENT_REQUIREMENTS.md, CLIENT_REPORT_.md, HANDOVER_LOG.md
  • support/: LEGACY_CONTEXT.md, KNOWN_ERRORS.md, MIGRATION.md, CHANGE_REQUESTS.md
  • glossaries/: DEV_GLOSSARY.md, BUSINESS_GLOSSARY.md, USER_GLOSSARY.md, GLOSSARY.md
  • docs/: howto/*.md e documentos auxiliares
  • meetings/, contracts/: checkpoints (inalterados)

Regra de fallback (transição): ao LER um artefato, verifique primeiro o caminho novo (ex: specs/DATA_MODEL.md); se não existir, use o caminho legado na raiz do módulo (ex: DATA_MODEL.md). Ao ESCREVER/GERAR, use sempre o caminho novo. Módulos ainda não migrados via rdd-restructure continuam legíveis durante a transição.

Lê (upstream)

  • <modulo>/<projeto>/specs/ACCEPTANCE_CRITERIA.md (se existir; fallback: raiz)
  • <modulo>/<projeto>/specs/ARCHITECTURE.md (se existir, para stack de teste; fallback: raiz)
  • <modulo>/<projeto>/specs/SECURITY.md (se existir, para requisitos de segurança; fallback: raiz)
  • <modulo>/<projeto>/specs/API_CONTRACTS.md (se existir, para testes de API; fallback: raiz)
  • <modulo>/<projeto>/specs/ERROR_CATALOG.md (se existir, para casos de teste de erro; fallback: raiz)
  • <modulo>/<projeto>/REQUIREMENTS.md (para contexto)

Gera (downstream)

  • <modulo>/<projeto>/quality/TEST_STRATEGY.md
  • <modulo>/<projeto>/quality/DEFINITION_OF_DONE.md

Nunca edita

  • ACCEPTANCE_CRITERIA.md
  • ARCHITECTURE.md

Tools

  • read (ler documentos upstream)
  • write (escrever TEST_STRATEGY.md, DEFINITION_OF_DONE.md)
  • question (para decisões de estratégia)

Modo de erro

skip — tier completo, baixa frequência, não bloqueia.

Algoritmo

  1. Leia specs/ACCEPTANCE_CRITERIA.md (se existir) para derivar os níveis de teste necessários
  2. Leia specs/ARCHITECTURE.md e specs/SECURITY.md (se existirem) para stack, ferramentas e requisitos de segurança testáveis
  3. Leia specs/API_CONTRACTS.md e specs/ERROR_CATALOG.md (se existirem) para testes de contrato e de erro
  4. Preencha o template de TEST_STRATEGY.md (níveis, ferramentas, dados de teste, CI/CD)
  5. Derive o checklist de DEFINITION_OF_DONE.md a partir dos critérios de aceitação e da estratégia
  6. Escreva ambos em quality/
  7. Aponte o próximo passo natural: fechado o conjunto de specs do módulo, a camada seguinte da DAG é a de features — proponha gerá-la com rdd-task-spec (análise analysis/RN-NNN — <título>/ + delivery/<grupo>/RN-NNN — <título> — Feature.md — IMP-092/093) ou confirme a ordem com rdd-next.

Formato de commit

docs: add test strategy and dod for <projeto>

Template — TEST_STRATEGY.md

---
project: <NOME>
module: testes
audience: [tecnica]
status: draft
---
# Test Strategy — [Nome do Sistema]

> **Última atualização:** DD/MM/AAAA

---

## 1. Níveis de Teste

| Nível | Responsável | Ferramenta | Cobertura esperada |
|---|---|---|---|
| Unitário | Dev | | > 80% |
| Integração | Dev | | Fluxos críticos |
| API (contrato) | Dev | | Todos endpoints |
| E2E | QA | | Fluxos principais |

## 2. Ferramentas

| Finalidade | Ferramenta |
|---|---|

## 3. Dados de Teste

| Origem | Estratégia |
|---|---|

## 4. CI/CD

| Pipeline | Gatilho | Ações |
|---|---|---|

Template — DEFINITION_OF_DONE.md

---
project: <NOME>
module: dod
audience: [tecnica]
status: draft
---
# Definition of Done — [Nome do Sistema]

> **Última atualização:** DD/MM/AAAA

---

## Checklist (todos devem ser true para considerar "done")

- [ ] Código revisado por pelo menos 1 par
- [ ] Testes unitários passando
- [ ] Testes de integração passando
- [ ] Documentação atualizada (REQUIREMENTS, API_CONTRACTS, UI_SPEC)
- [ ] Critérios de aceitação validados
- [ ] Sem alertas de segurança críticos
- [ ] CHANGELOG.md atualizado

Casos de Borda

  • Sem ACCEPTANCE_CRITERIA.md — derive os níveis das RNs em REQUIREMENTS.md e sinalize que os critérios formais ainda não existem.
  • Projeto API-only (sem UI) — marque E2E de interface como não aplicável; mantenha unitário, integração e API.
  • Stack não informada — pergunte via question antes de fixar ferramentas.
  • Módulo sem CI/CD definido — registre a seção correspondente como "a definir" em vez de inventar pipeline.

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