CommunitySchreiben & Editierengithub.com

QA-Sitzung

Führen Sie eine interaktive QA-Sitzung durch, bei der Probleme gehört, der Codebestand untersucht und langlebige GitHub-Issues erstellt werden.

Was ist QA-Sitzung?

Diese Fähigkeit ermöglicht es einem KI-Agenten, eine strukturierte und interaktive QA-Sitzung (Qualitätssicherung) durchzuführen. Sie ist darauf ausgelegt, Produktionsprobleme zu identifizieren, zu analysieren und in GitHub-Issues zu dokumentieren, ohne dass der Benutzer die technische Detailtiefe selbst liefern muss. Die Hauptaufgabe besteht darin, dem Benutzer zuzuhören, das beschriebene Problem durch maximal 2-3 gezielte Fragen zu klären und gleichzeitig im Hintergrund den Codebestand zu durchsuchen, um die richtige Fachsprache des Projekts zu verstehen. Anschließend bewertet der Agent, ob das Problem als einzelnes Issue oder in mehrere unabhängige Teil-Issues aufgeteilt werden muss. Die erstellten Issues werden direkt mit `gh issue create` angelegt und sind bewusst aus Benutzersicht formuliert, ohne auf interne Dateipfade oder Codezeilen zu verweisen. Dies maximiert die Langlebigkeit und Lesbarkeit der Issues, selbst nach größeren Refactorings. Die Fähigkeit unterstützt plattformübergreifend Agenten, die Shell-Befehle ausführen können, und ist besonders wertvoll für Teams, die effizientes, delegiertes Issue-Management in Continuous-Development-Workflows integrieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add K3639284/skills

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht QA-Sitzung?

Führen Sie eine interaktive QA-Sitzung durch. Der Benutzer beschreibt Probleme, auf die er stößt. Sie klären diese, durchsuchen im Hintergrund den Codebestand nach Kontext und erstellen GitHub-Issues, die langlebig, benutzerorientiert und in der Fachsprache des Projekts verfasst sind.

Für jedes vom Benutzer gemeldete Problem

1. Zuhören und leicht nachfragen

Lassen Sie den Benutzer das Problem mit eigenen Worten beschreiben. Stellen Sie höchstens 2-3 kurze Verständnisfragen, die sich konzentrieren auf:

  • Was der Benutzer erwartet hat im Vergleich zu dem, was tatsächlich passiert ist
  • Schritte zur Reproduktion (falls nicht offensichtlich)
  • Ob das Problem konsistent oder sporadisch auftritt

Überfrachten Sie das Gespräch nicht mit Fragen. Wenn die Beschreibung klar genug ist, um ein Issue zu erstellen, fahren Sie fort.

2. Im Hintergrund den Codebestand durchsuchen

Während Sie mit dem Benutzer sprechen, starten Sie einen Agenten (subagent_type=Explore) im Hintergrund, um den relevanten Bereich zu verstehen. Das Ziel ist es nicht, eine Lösung zu finden – es geht darum:

  • Die in diesem Bereich verwendete Fachsprache zu lernen (prüfen Sie UBIQUITOUS_LANGUAGE.md)
  • Zu verstehen, was die Funktion tun soll
  • Die benutzerseitige Verhaltensgrenze zu identifizieren

Dieser Kontext hilft Ihnen, ein besseres Issue zu schreiben – aber das Issue selbst sollte keine spezifischen Dateien, Zeilennummern oder internen Implementierungsdetails referenzieren.

3. Umfang bewerten: Einzelnes Issue oder Aufteilung?

Bevor Sie das Issue erstellen, entscheiden Sie, ob es sich um ein einzelnes Issue handelt oder in mehrere Issues aufgeteilt werden muss.

Teilen Sie auf, wenn:

  • Die Behebung mehrere unabhängige Bereiche betrifft (z. B. „die Formularvalidierung ist falsch UND die Erfolgsmeldung fehlt UND die Weiterleitung ist defekt“)
  • Es eindeutig trennbare Belange gibt, an denen verschiedene Personen parallel arbeiten könnten
  • Der Benutzer etwas beschreibt, das mehrere unterschiedliche Fehlermodi oder Symptome hat

Behalten Sie ein einzelnes Issue bei, wenn:

  • Es sich um ein einzelnes Verhalten handelt, das an einer Stelle falsch ist
  • Die Symptome alle durch dasselbe Grundverhalten verursacht werden

4. Das/die GitHub-Issue(s) erstellen

Erstellen Sie Issues mit gh issue create. Fragen Sie den Benutzer nicht um vorherige Überprüfung – erstellen Sie sie einfach und teilen Sie die URLs mit.

Issues müssen langlebig sein – sie sollten auch nach größeren Refactorings noch Sinn ergeben. Schreiben Sie aus der Perspektive des Benutzers.

Für ein einzelnes Issue

Verwenden Sie diese Vorlage:

## Was passiert ist

[Beschreiben Sie das tatsächliche Verhalten, das der Benutzer erlebt hat, in einfacher Sprache]

## Was ich erwartet habe

[Beschreiben Sie das erwartete Verhalten]

## Schritte zur Reproduktion

1. [Konkrete, nummerierte Schritte, die ein Entwickler befolgen kann]
2. [Verwenden Sie Fachbegriffe aus dem Codebestand, nicht interne Modulnamen]
3. [Fügen Sie relevante Eingaben, Flags oder Konfigurationen hinzu]

## Zusätzlicher Kontext

[Alle zusätzlichen Beobachtungen vom Benutzer oder aus der Codebestandsdurchsuchung, die helfen, das Issue einzuordnen – z. B. „dies tritt nur bei Verwendung der Docker-Ebene auf, nicht bei der Dateisystem-Ebene“ – verwenden Sie Fachsprache, aber zitieren Sie keine Dateien]

Für eine Aufteilung (mehrere Issues)

Erstellen Sie Issues in Abhängigkeitsreihenfolge (zuerst blockierende), damit Sie echte Issue-Nummern referenzieren können.

Verwenden Sie diese Vorlage für jedes Unter-Issue:

## Übergeordnetes Issue

#<Nummer-des-übergeordneten-Issues> (falls Sie ein Tracking-Issue erstellt haben) oder „Gemeldet während der QA-Sitzung“

## Was ist falsch

[Beschreiben Sie dieses spezifische Verhaltensproblem – nur diesen Ausschnitt, nicht den gesamten Bericht]

## Was ich erwartet habe

[Erwartetes Verhalten für diesen spezifischen Ausschnitt]

## Schritte zur Reproduktion

1. [Schritte, die spezifisch für DIESES Issue sind]

## Blockiert durch

- #<Issue-Nummer> (falls dieses Issue erst behoben werden kann, wenn ein anderes gelöst ist)

Oder „Keine – kann sofort begonnen werden“, wenn es keine Blocker gibt.

## Zusätzlicher Kontext

[Alle zusätzlichen Beobachtungen, die für diesen Ausschnitt relevant sind]

Beim Erstellen einer Aufteilung:

  • Bevorzugen Sie viele dünne Issues gegenüber wenigen dicken – jedes sollte unabhängig behebbar und überprüfbar sein
  • Markieren Sie Blockierungsbeziehungen ehrlich – wenn Issue B wirklich nicht getestet werden kann, bevor Issue A behoben ist, sagen Sie das. Wenn sie unabhängig sind, markieren Sie beide mit „Keine – kann sofort begonnen werden“
  • Erstellen Sie Issues in Abhängigkeitsreihenfolge, damit Sie in „Blockiert durch“ echte Issue-Nummern referenzieren können
  • Maximieren Sie die Parallelität – das Ziel ist, dass mehrere Personen (oder Agenten) gleichzeitig verschiedene Issues bearbeiten können

Regeln für alle Issue-Texte

  • Keine Dateipfade oder Zeilennummern – diese werden schnell veraltet
  • Verwenden Sie die Fachsprache des Projekts (prüfen Sie UBIQUITOUS_LANGUAGE.md, falls vorhanden)
  • Beschreiben Sie Verhalten, nicht Code – „der Synchronisationsdienst wendet den Patch nicht an“ nicht „applyPatch() wirft eine Exception in Zeile 42“
  • Reproduktionsschritte sind Pflicht – wenn Sie sie nicht ermitteln können, fragen Sie den Benutzer
  • Halten Sie es prägnant – ein Entwickler sollte das Issue in 30 Sekunden lesen können

Nach dem Erstellen geben Sie alle Issue-URLs aus (mit einer Zusammenfassung der Blockierungsbeziehungen) und fragen Sie: „Nächstes Problem, oder sind wir fertig?“

5. Die Sitzung fortsetzen

Fahren Sie fort, bis der Benutzer sagt, dass er fertig ist. Jedes Issue ist unabhängig – bündeln Sie sie nicht.

Verwandte Skills