convez.ai
SkillAutomaçãoAvançado
keremt-dev

Auditor de Cobertura de Testes

keremt-dev/test-kapsam-denetimi

Detecta lacunas de cobertura de testes com matriz rastreável e relatório executivo

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que valida sistematicamente se cenários de teste cobrem requisitos e casos de uso item por item, gerando relatório de lacunas de cobertura. Usa agentes paralelos Opus 4.8 com validação rigorosa em múltiplas fases (extração, análise, síntese, verificação pós-síntese).

Instalação

$npx convez-ai keremt-dev/test-kapsam-denetimi

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Validar completude de testes contra requisitos SRS em projetos complexos
  • Gerar matriz de rastreabilidade teste↔requisito↔caso de uso com código de cores
  • Identificar requisitos descobertos, testes órfãos e cenários alternativos não testados
  • Criar evidência auditável de cobertura com comentários parametrizáveis para Jira

Veredito

Ferramenta sólida e bem arquitetada para QA em projetos de grande escala com múltiplos módulos. A validação em 6 camadas (C1–C6) antes da síntese é rigorosa; saída estruturada (Markdown + Excel + comentários Jira) facilita integração. Ideal para equipes que precisam rastreabilidade formal teste↔requisito.

README

A tradução para o português deste README ainda está na fila.

test-kapsam-denetimi

Test senaryolarının kullanım senaryolarını ne kadar karşıladığını madde madde denetleyen ve kapsam boşluğu raporu üreten bir Claude Code skill'i. BVA (BVAKP) modülleri (KEY, AT, …) için tasarlandı; aynı doküman şablonunu kullanan her modüle uygulanabilir.

Ne yapar?

Üç kaynak dokümandan yola çıkar:

KaynakAçıklama
SRS gereksinim .xlsxGereksinim Numarası başlıklı gereksinim listesi
Kullanım senaryoları .docxHer KS bir tablo (ana akış, alternatifler, iş kuralları, ön/son koşul)
Test senaryoları .xlsxHer KS bir sayfa; ID, adım, beklenen sonuç, gereksinim etiketi

Her kullanım senaryosunu ayrı bir paralel ajan (Opus 4.8) ile denetler. Her KS şu 5 boyutta atomik maddelere ayrılıp test senaryolarıyla Tam / Kısmi / Yok olarak eşleştirilir:

  • Ana Akış adımları
  • Alternatif Senaryolar
  • İş Kuralları
  • İlgili SRS Gereksinimleri
  • Ön / Son Koşullar

Ters yönde de denetler: hangi testin hangi maddeyi karşıladığı, gereksinim etiketi boş testler, ve yalnızca başlık içeren artık/iskelet test satırları.

Çıktılar

  • <MOD>_Kapsam_Bosluk_Raporu.md — yönetici özeti, kritik boşluklar, KS bazında detay
  • <MOD>_Kapsam_Bosluk_Matrisi.xlsx — renk kodlu izlenebilirlik matrisi (Matris / Ozet / Etiketsiz_Artik)
  • <test dosyası> - Inceleme.xlsx — orijinalin kopyası + her satıra Kapsam İnceleme Notu sütunu (orijinale dokunulmaz)
  • <MOD>_jira_yorumlari.md — KS başına insansı/emojisiz, eklemeye hazır Jira yorumları

Kurulum

git clone https://github.com/keremt-dev/test-kapsam-denetimi.git \
  ~/.claude/skills/test-kapsam-denetimi
pip install openpyxl python-docx

Claude Code skill'i otomatik keşfeder. Tetikleyiciler: "test kapsam denetimi", "kapsam boşluğu", "coverage gap", "test senaryoları yeterli mi" …

Kullanım

Bir modülün üç kaynak dosyasını bir klasöre koyup skill'i tetikleyin. Manuel akış:

SKILL_DIR=~/.claude/skills/test-kapsam-denetimi

# Faz 0 — çıkarım
python "$SKILL_DIR/scripts/extract_bundles.py" --indir . --outdir work

# Faz 1 — her KS için paralel Opus 4.8 ajanı (Claude Code orkestre eder)
#          work/<KS>_input.md oku → work/<KS>_result.json yaz

# Faz 3 — sert doğrulama (PASS olmadan sentez yok)
python "$SKILL_DIR/scripts/verify.py" --workdir work

# Faz 4 — sentez
python "$SKILL_DIR/scripts/synthesize.py" --workdir work --outdir .
python "$SKILL_DIR/scripts/verify.py" --workdir work --post --outdir .

Windows'ta tüm komutları PYTHONIOENCODING=utf-8 ile çalıştırın.

Doğrulama (test kontrol yapısı)

verify.py, sentezden önce çalışan sert bir kapıdır; herhangi bir FAIL'de teslim yapılmaz:

KontrolAmaç
C1Sayımları madde durumundan yeniden hesaplar; ajanın ozet değerine güvenilmez
C2Atıf yapılan her Test ID kaynak dosyada gerçekten var (uydurma yok)
C3Her geçerli Test ID, test notlarında tam bir kez geçer
C4KS'nin SRS boyutu, beklenen gereksinim listesiyle birebir
C5Tüm KS'lerin SRS birleşimi = modülün SRS evreni (eksik/fazla yok)
C6durum ve tur alanları geçerli enum

--post modu sentez sonrası matris satır sayısı ve özet toplamlarını doğrular.

Tasarım ilkeleri

  • Tek doğruluk kaynağı = madde durum alanı. Hiçbir çıktı ajan özet sayımına güvenmez.
  • Başlık-tabanlı tespit — kolon/tablo sırası değişse de çalışır.
  • Kapsam-içi oran — Jira oranlarında düşük öncelikli ön/son koşul kısmileri paydadan düşülür.

Yapı

test-kapsam-denetimi/
├── SKILL.md
├── README.md
├── scripts/
│   ├── extract_bundles.py   # Faz 0: kaynaklar → girdi paketleri + manifest
│   ├── verify.py            # Faz 3: sert doğrulama (C1–C6, --post)
│   └── synthesize.py        # Faz 4: rapor + matris + yorumlu kopya + jira
└── references/
    ├── agent_prompt_template.md
    └── result_schema.json

Lisans

MIT

Ver o original no GitHub

Bom para

Relacionados