testItRight
ENDE
Dokumentation

Test Scribe Dokumentation

Erweiterung installieren, ein KI-Backend verbinden und JIRA-Tickets in Testfälle verwandeln. Ollama-Nutzer müssen den einmaligen CORS-Fix weiter unten anwenden.

Aus dem Chrome Web Store installieren

Vier KI-Backends

Wählen Sie, was zu Ihren Anforderungen an Datenschutz, Geschwindigkeit und Kosten passt — jederzeit im Popup umschaltbar.

1 · Ollama

Lokal · Empfohlen

Läuft vollständig auf Ihrem Rechner (z. B. Qwen2.5-Coder). Keine Daten verlassen Ihr Netzwerk, keine API-Kosten.

2 · Google Gemini

Cloud

Schnelle Cloud-Generierung mit Ihrem Gemini-API-Key.

3 · Groq Cloud

Cloud

Ultraschnelle Cloud-Inferenz mit Llama 3, DeepSeek oder Mixtral-Modellen.

4 · Custom OpenAI

Lokal / Cloud

Verbinden Sie LM Studio, lokale Hosts oder Gateways (DeepSeek Cloud, OpenRouter) über die Standard-OpenAI-REST-Spezifikation.

Erweiterung installieren

Test Scribe läuft in Chrome (oder jedem Chromium-Browser) mit einer JIRA-Cloud-Instanz und einem KI-Backend — lokal oder in der Cloud.

  1. Öffnen Sie den Test-Scribe-Eintrag im Chrome Web Store und klicken Sie auf „Zu Chrome hinzufügen“.
  2. Bestätigen Sie im Browser-Dialog mit „Erweiterung hinzufügen“.
  3. Klicken Sie auf das Puzzle-Symbol (Erweiterungen) in der Chrome-Symbolleiste und pinnen Sie Test Scribe (das Stift-Icon) für schnellen Zugriff.
  4. Öffnen Sie ein JIRA-Ticket, klicken Sie auf das Test-Scribe-Icon und dann auf Einstellungen, um ein KI-Backend zu verbinden (siehe Anleitungen unten).

NoteLieber aus dem Quellcode ausführen? Klonen Sie das Repo, öffnen Sie chrome://extensions, aktivieren Sie den Entwicklermodus und laden Sie den Erweiterungsordner über „Entpackte Erweiterung laden“.

Einrichtung: Ollama (Lokale KI — Empfohlen)

  1. Laden Sie Ollama von ollama.com herunter und installieren Sie es.
  2. Laden Sie das empfohlene Modell (optimiert für strukturierte Ausgabe — bessere Gherkin- und Test-Tabellen als Allzweckmodelle):
    ollama pull qwen2.5-coder
  3. Klicken Sie auf das Test-Scribe-Icon → Einstellungen.
  4. Wählen Sie Ollama (Lokal) und setzen Sie die Host-URL (Standard: http://localhost:11434).
  5. Klicken Sie auf Aktualisieren neben dem Modell-Dropdown, wählen Sie qwen2.5-coder und Speichern.

NoteOllama blockiert Anfragen von Chrome-Erweiterungen standardmäßig — wenden Sie zuerst den CORS-Fix unten an.

Ollama-CORS-Fehler beheben (für Ollama erforderlich)

Chrome-Erweiterungen senden Anfragen mit einem speziellen Origin-Header, den Ollama standardmäßig blockiert (403-Fehler). Führen Sie den Befehl für Ihr Betriebssystem einmal aus und starten Sie Ollama neu.

macOS

launchctl setenv OLLAMA_ORIGINS "*"

Beenden Sie dann Ollama und starten Sie es über das Menüleisten-Symbol neu.

Linux (systemd)

sudo systemctl edit ollama.service

Fügen Sie in die Datei ein:

[Service]
Environment="OLLAMA_ORIGINS=*"

Dann neu laden und neu starten:

sudo systemctl daemon-reload && sudo systemctl restart ollama

Windows (PowerShell)

[System.Environment]::SetEnvironmentVariable("OLLAMA_ORIGINS", "*", "User")

Beenden Sie dann Ollama und starten Sie es über die Taskleiste neu.

Einrichtung: Gemini (Cloud-KI)

  1. Holen Sie sich einen kostenlosen API-Key unter aistudio.google.com/app/apikey.
  2. Klicken Sie auf das Test-Scribe-Icon → Einstellungen.
  3. Wählen Sie Gemini (Cloud), fügen Sie Ihren API-Key ein und Speichern.

Test Scribe wählt automatisch das beste verfügbare Gemini-Flash-Modell.

Einrichtung: Groq (Cloud-KI)

  1. Erstellen Sie einen API-Key in der Groq-Konsole (console.groq.com/keys).
  2. Klicken Sie auf das Test-Scribe-Icon → Einstellungen.
  3. Wählen Sie Groq (Cloud), fügen Sie Ihren API-Key ein, klicken Sie auf Aktualisieren, wählen Sie Ihr Modell und Speichern.

Einrichtung: Custom OpenAI

  1. Klicken Sie auf das Test-Scribe-Icon → Einstellungen.
  2. Wählen Sie Custom OpenAI.
  3. Geben Sie Ihre Host-URL ein (z. B. http://localhost:1234/v1 für LM Studio).
  4. Geben Sie einen API-Key ein, falls Ihr Server einen benötigt.
  5. Klicken Sie auf Aktualisieren, wählen Sie Ihr Modell aus dem Dropdown und Speichern.

Xray-Integration (Optional)

  1. In JIRA: Apps → Xray → API Keys, ein Schlüsselpaar erstellen und Client ID sowie Secret kopieren.
  2. Klicken Sie auf das Test-Scribe-Icon → Einstellungen → Xray-Integration.
  3. Geben Sie Ihre Zugangsdaten ein, klicken Sie zum Prüfen auf Test und Speichern.

Testfälle generieren

  1. Öffnen Sie ein JIRA-Ticket im Browser — jede Cloud-Instanz, deren URL-Pfad /browse/ enthält (z. B. https://ihre-domain.atlassian.net/browse/TS-101).
  2. Klicken Sie auf das Test-Scribe-Icon. Titel und Beschreibung des Tickets werden automatisch eingelesen.
  3. Wählen Sie einen Generator-Tab — Gherkin-Prompt (Cucumber BDD) oder Manual-Prompt (Schritt-Tabellen).
  4. Klicken Sie auf Testfälle generieren und prüfen Sie die Ergebnisse.

Aktionen pro Test

  • Kopieren — die Gherkin- oder manuellen Schritte in die Zwischenablage kopieren.
  • Bearbeiten — jeden Schritt direkt in den bearbeitbaren Textfeldern anpassen.
  • JIRA-/Xray-Test erstellen — den Test als verknüpfte Aufgabe nach JIRA übertragen oder in Xray Cloud importieren.

Kontext-Anreicherung

Test Scribe kann verwandte Ticket-Hierarchien lesen, damit die KI Schritte generiert, die zu Ihrem Domänen-Vokabular passen.

Epic-/Story-Kontext

Sucht automatisch nach übergeordneten Issues und hängt deren Beschreibungen an den Prompt an.

Interaktives Kontext-Panel

Gefundene Eltern-Beziehungen erscheinen als Checkliste zwischen Titel und Prompt-Editor — Sie steuern genau, was angehängt wird.

Anreicherungs-Einstellungen

Legen Sie fest, ob das übergeordnete Ticket standardmäßig einbezogen wird, oder blenden Sie das Kontext-Panel im Popup aus.

Review & Merge — Schritt-Konsistenz & Sync

Halten Sie Ihr Gherkin-Vokabular ticketübergreifend konsistent. Test Scribe synchronisiert Ihre vorhandene Schritt-Bibliothek aus Xray und nutzt sie beim Generieren und Zusammenführen neuer Szenarien.

Xray-Schritt-Bibliothek synchronisieren

  1. Verbinden Sie zuerst Xray (siehe Xray-Integration oben), damit Test Scribe Ihre Client ID und Ihr Secret hat.
  2. Öffnen Sie Einstellungen → Integration und starten Sie eine Synchronisierung (Sync).
  3. Test Scribe durchsucht jedes Test-Issue in Ihren ausgewählten JIRA-Projekten, filtert Cucumber- (Gherkin) Tests, extrahiert deren Szenario-Schritte und speichert sie lokal in der Erweiterung. Manuelle Tests werden übersprungen, damit die Bibliothek auf wiederverwendbare BDD-Schritte fokussiert bleibt.

So wird die synchronisierte Bibliothek genutzt

Fuzzy Step Matching

Generierte Schritte werden per Jaccard-Ähnlichkeit mit der synchronisierten Bibliothek verglichen. Nahe Übereinstimmungen werden hervorgehoben, damit Sie geringe Formulierungsunterschiede normalisieren können.

Schritt-Autovervollständigung

Tippen Sie im Schritt-Editor, um Vorschläge aus Ihrem synchronisierten Schritt-Wörterbuch zu erhalten.

Prompt-Kontext-Injektion

Test Scribe findet vorhandene Schritte, die dem Titel und der Beschreibung des Tickets ähneln, und fügt sie dem KI-Prompt hinzu, sodass das Modell Ihr Vokabular natürlich wiederverwendet.

Speicher- & Merge-Ziel

Mögliche Test-Tickets werden nach Gesamt-Schrittähnlichkeit gereiht, und das beste Ziel wird automatisch ausgewählt, um neue Szenarien anzuhängen.

Fehlerbehebung

403 Forbidden von Ollama

Setzen Sie OLLAMA_ORIGINS auf "*" — siehe CORS-Abschnitt oben.

Ollama nicht erreichbar

Starten Sie Ollama und prüfen Sie, ob die Host-URL in den Einstellungen zu Ihrem Port passt.

Keine Modelle gefunden

Laden Sie das empfohlene Modell:

ollama pull qwen2.5-coder

Gemini-API-Key fehlt

Einstellungen → Gemini-Tab → Key einfügen → Speichern.

Popup öffnet, zeigt aber keine JIRA-Daten

Öffnen Sie zuerst eine Ticket-URL (z. B. /browse/PROJ-123).

Tests erscheinen nicht

Rechtsklick auf das Popup → Untersuchen → Konsole auf Fehler prüfen.

Quellcode & vollständige Dokumentation

Test Scribe ist Open Source. Sehen Sie sich den Code an, melden Sie Issues und lesen Sie die vollständige Dokumentation auf GitHub.

Auf GitHub ansehen