Uma ferramenta poderosa de verificação de API que detecta desvio de especificação e suporta Testes de Contrato Bidirecionais (Bi-Directional Contract Testing) usando especificações OpenAPI.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install drift-testing
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o drift-testing usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Drift Testing?
A skill drift-testing é um conjunto de ferramentas abrangente para Openclaw Skills projetado para sincronizar implementações de API com suas especificações OpenAPI. Ela aproveita a Drift CLI para realizar Testes de Contrato Bidirecionais (BDCT), garantindo que a implementação do seu provedor reflita com precisão o contrato documentado. Esta skill é fundamental para desenvolvedores que precisam manter a conformidade da API, prevenir mudanças disruptivas e automatizar a verificação do provedor em pipelines de CI/CD.
Além da validação simples, esta skill fornece um ciclo de vida completo para testes de API, incluindo análise de cobertura, loops de feedback automatizados e scripting baseado em Lua para gerenciamento complexo de estado. Esteja você testando em um ambiente de produção real ou em um servidor Prism mock local, este utilitário do Openclaw Skills garante que seus endpoints estejam totalmente cobertos e em conformidade com seus padrões definidos.
Casos de uso do Drift Testing
- Verificar se uma implementação de API corresponde à sua especificação OpenAPI para evitar desvio de especificação.
- Implementar Testes de Contrato Bidirecionais (BDCT) dentro de um ecossistema PactFlow.
- Gerar automaticamente esqueletos e scaffolds de teste a partir de um documento OpenAPI existente.
- Garantir cobertura total de endpoints identificando casos de teste ausentes para códigos de resposta específicos.
- Depurar falhas de API usando um loop de nova tentativa automático que executa até que todos os testes passem.
Como o Drift Testing funciona
- A skill analisa a especificação OpenAPI fornecida para identificar todas as operações, métodos e códigos de resposta disponíveis.
- Os usuários inicializam o ambiente usando o comando drift init para criar a estrutura de configuração, conjuntos de dados e arquivos de hook.
- Os casos de teste são criados em YAML, mapeando operações específicas para códigos de status e parâmetros esperados.
- A Drift CLI executa os testes em relação a uma URL de servidor de destino ou um servidor mock local.
- Scripts de cobertura comparam os testes executados com a especificação para relatar lacunas na verificação de endpoints ou códigos de resposta.
- Um loop de feedback (run_loop.sh) pode ser usado para iterar em testes com falha e cobertura ausente até que a API esteja totalmente verificada.
Configuração do Drift Testing
Você pode usar a Drift CLI via npx ou instalá-la localmente para o seu projeto.
# Use via npx sem instalação
npx @pactflow/drift --help
# Instalação local para equipes de desenvolvimento
npm install --save-dev @pactflow/drift
# Inicialize um novo projeto Drift
drift init
Esquema de Dados e Taxonomia de Drift Testing
A skill organiza sua configuração e dados de teste em uma estrutura de diretórios específica para usuários de Openclaw Skills:
| Arquivo | Propósito |
|---|---|
drift.yaml |
Arquivo de configuração principal definindo fontes, plugins e configurações globais de autenticação. |
drift.lua |
Script Lua contendo hooks de ciclo de vida (ex: operation:started) e funções auxiliares. |
*.dataset.yaml |
Dados de teste externalizados e variáveis usadas em expressões de teste. |
*.tests.yaml |
O conjunto de testes principal contendo alvos de operação e respostas esperadas. |
Recursos avançados do Drift Testing
- Hooks de Ciclo de Vida Lua: Programe comportamentos complexos para
http:request,operation:startedeoperation:finishedpara gerenciar estado ou popular dados. - Testes de Contrato Bidirecionais: Publique resultados no PactFlow para manter a integridade do contrato em sistemas distribuídos.
- Análise Automática de Cobertura: Use scripts Python integrados para comparar seu conjunto de testes com a especificação OpenAPI para 100% de verificação.
- Integração com Mock Server: Suporte integrado para servidores Prism mock para testar a lógica da API sem um backend ativo.
- Execução Paralela: Otimize os tempos de execução de CI/CD executando conjuntos de testes em paralelo usando flags nativas da CLI.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
LinkedIn Thread Engagement
Uma camada de engajamento orientada por AI que monitora threads do LinkedIn para respostas do autor e maximiza o impulso da conversa durante a janela de resposta crítica.
SageOx Summary
Uma skill de agente AI que sintetiza as últimas 24 horas de atividade entre equipes em resumos estruturados e prontos para o Slack.
Testes de Contrato PactFlow & Pact
Um assistente especializado para gerenciar testes de contrato PactFlow e Pact open-source, garantindo implantações seguras por meio de verificações de compatibilidade automatizadas.
Star Wars API MCP Skill
Uma interface compatível com MCP para consultar dados canônicos do universo de Star Wars, incluindo filmes, personagens e naves espaciais.
LinkedIn Post Audit
Um mecanismo heurístico de nível profissional que audita rascunhos do LinkedIn para eliminar marcas de AI e maximizar o alcance algorítmico.
Doc System Generator
O Doc System Generator analisa estruturas de projetos de software para derivar e gerar automaticamente um sistema de documentação Markdown completo e de alta qualidade com base em uma filosofia única de três trilhas.
Apresentou*
