shenli/distributed-system-testingHabilidades de agentes de IA para testes de sistemas distribuídos
Duas habilidades que ajudam um agente de codificação com IA a projetar testes significativos, executá-los e explicar os resultados para sistemas que armazenam dados ou são executados em múltiplos processos ou máquinas.
Comece com uma promessa do produto — como "assim que o salvamento for bem-sucedido, os dados ainda estarão lá após uma reinicialização" — e transforme-a em testes que seu agente pode executar e verificar. Use estas habilidades para bancos de dados, filas, mecanismos de fluxo de trabalho e serviços onde novas tentativas, solicitações simultâneas ou falhas possam perder ou duplicar dados. Um serviço executado em uma única máquina também pode se beneficiar.
Você não precisa ser um especialista em testes. Descreva o recurso e o que deve permanecer verdadeiro; a habilidade de design ajuda a escolher os testes e explicar por que eles importam.
As habilidades são instruções em Markdown, modelos e material de referência. Seu agente de codificação as segue usando as ferramentas de teste e o ambiente de execução do seu projeto. Este repositório não inclui um executor de testes de banco de dados nem um cluster pronto.
| Habilidade | Forneça | Ela produz |
|---|---|---|
| Projetar testes | Uma base de código e a mudança ou recurso que você deseja testar | Um plano explicando o que testar, como verificar e quanto teste fazer |
| Executar testes | Um plano e um ambiente de teste | Resultados, logs e dados de suporte, etapas para reproduzir falhas e um relatório |
Você pode usar a habilidade de design sozinha. A execução é uma etapa separada que lê o plano salvo, para que você possa revisar o trabalho e seu custo antes de executá-lo.
Comece pelo início rápido, configuração do Codex ou guia do ambiente de teste.
Cole isto no seu agente de codificação:
Read https://raw.githubusercontent.com/shenli/distributed-system-testing/main/INSTALL.md
and follow the instructions to install or update
distributed-testing-skills for this agent.
O guia de instalação utiliza um checkout compartilhado em
~/.local/share/distributed-testing-skills/ e configura ponteiros ou
symlinks para o seu agente. Reutilize o mesmo prompt para atualizar. Os caminhos explícitos
nos prompts abaixo também permitem carregar uma skill sem descoberta automática.
Substitua pelo seu caminho de instalação caso tenha escolhido um local diferente.
Para o Claude Code, o repositório também inclui uma opção de instalação via plugin:
/plugin marketplace add shenli/distributed-system-testing
/plugin install distributed-testing-skills@distributed-testing-skills
Inicie seu agente no repositório que você deseja testar. Para uma alteração específica:
Use ~/.local/share/distributed-testing-skills/skills/designing-distributed-system-tests/SKILL.md
Design a test plan for the current branch's changes to adding log entries,
retrying failed requests, and recovering after a crash.
Reuse the existing tests and setup instructions.
Save the plan to docs/testing-plans/append-recovery.md.
Substitua o recurso de exemplo pelo seu. Para uma revisão mais ampla, peça um plano para todo o projeto e indique as partes a incluir. Esse modo revisa os testes existentes e identifica a cobertura ausente em todo o sistema, em vez de uma única alteração.
Revise as promessas que estão sendo verificadas, os testes propostos, as ferramentas necessárias e os tempos de execução. Um erro de digitação na documentação ou uma alteração de impacto igualmente baixo deve receber uma recomendação de teste leve, em vez de um plano de teste distribuído.
Use ~/.local/share/distributed-testing-skills/skills/executing-distributed-system-tests/SKILL.md
Run the small initial checks (the smoke tier) from
docs/testing-plans/append-recovery.md against this project's local test
environment. Keep temporary test scripts and results under
./test-sessions/. Use default mode; do not modify project source files.
Report what ran, what failed, and what remains untested.
A skill de execução descobre ferramentas existentes, pergunta o que está disponível no seu ambiente e então verifica os requisitos. Dependências ausentes ou falhas simuladas ineficazes devem ser reportadas em vez de contadas silenciosamente como testes bem-sucedidos. Comece pequeno, depois solicite as execuções mais longas e minuciosas definidas no plano.
Consulte USAGE.md para prompts detalhados, caminhos de saída personalizados e modo autor.
Execute o prompt de instalação acima no Codex. O guia vincula ambas as pastas de skills do checkout compartilhado em ~/.agents/skills/, onde o Codex as descobre. Para uma instalação apenas de projeto, use o .agents/skills/ desse projeto. Esses locais e o suporte a symlink estão descritos na
documentação oficial de skills do Codex.
Abra o projeto que você deseja testar. No Codex CLI ou na extensão da IDE, use
/skills para verificar se ambas as skills aparecem, ou digite $ para selecionar uma. Se uma skill recém-instalada não aparecer, reinicie o Codex. Você também pode usar os prompts explícitos com caminho de arquivo no início rápido. Consulte as
orientações oficiais de invocação.
Por exemplo, peça ao Codex para elaborar um plano:
$designing-distributed-system-tests
Design a test plan for this project's retry and recovery behavior.
I have Docker locally and can run disposable containers.
Start with normal operation, then simultaneous requests and restarts.
Save the plan to docs/testing-plans/retry-recovery.md.
Depois de revisá-lo, execute os testes iniciais:
$executing-distributed-system-tests
Run the smoke tier of docs/testing-plans/retry-recovery.md.
Use default mode and save results under ./test-sessions/.
Docker is available; use the project's documented container setup.
Report any missing tools or permissions and which tests they prevent.
Instalar uma skill fornece instruções, não Docker, acesso remoto ou um cluster de teste. O Codex precisa conseguir alcançar o ambiente onde os comandos serão executados. Para testes remotos, forneça os hosts de teste, seu método de conexão existente e os comandos de configuração do projeto. Se o acesso não estiver disponível, ele ainda pode projetar o plano, mas não pode relatar que os testes remotos foram executados.
Use a configuração mínima capaz de responder à sua pergunta. Estes são pontos de partida a adaptar à sua aplicação, não requisitos de hardware nem receitas de implantação prontas.