Communitygithub.com

lucas-flatwhite/gstack-ko

NUR MANUELLES AUSLÖSEN: Nur aufrufen, wenn der Benutzer /qa eingibt. Systematisch eine Webanwendung testen und gefundene Fehler beheben. Führt QA-Tests durch, behebt dann iterativ Fehler im Quellcode, committed jede Korrektur atomar und überprüft erneut. Verwenden, wenn aufgefordert zu "qa", "QA", "diese Seite testen", "Fehler finden", "testen und reparieren" oder "Reparieren, was kaputt ist". Proaktiv vorschlagen, wenn der Benutzer sagt, eine Funktion sei testbereit oder fragt "funktioniert das?". Drei Stufen: Schnell (nur kritisch/hoch), Standard (+ mittel), Erschöpfend (+ kosmetisch). Erzeugt Vorher/Nachher-Gesundheitswerte, Behebungsnachweise und eine Versandbereitschaftszusammenfassung. Für den Nur-Bericht-Modus /qa-only verwenden.

Was ist gstack-ko?

Dieses Skill für KI-Agenten (z. B. Claude Code, Cursor, Codex) implementiert einen vollständigen QA-Test- und Reparaturworkflow für Webanwendungen. Es fungiert sowohl als QA-Ingenieur als auch als Bug-Fix-Ingenieur: Es testet systematisch alle interaktiven Elemente einer Webanwendung, findet Fehler, behebt sie im Quellcode mit atomaren Commits und überprüft die Korrekturen dann erneut. Das Skill unterstützt drei Teststufen (Schnell, Standard, Erschöpfend), die den Schweregrad der zu behebenden Probleme bestimmen. Es kann im Vollmodus (gesamte Anwendung testen) oder im Diff-Modus (nur Änderungen auf einem Feature-Branch testen) ausgeführt werden. Der Workflow erzeugt einen detaillierten Bericht mit Vorher/Nachher-Gesundheitswerten, Behebungsnachweisen und einer Versandbereitschaftszusammenfassung. Das Skill ist für die Plattformen gstack, Claude Code und Cursor konzipiert und folgt dem "Boil the Lake"-Prinzip der Vollständigkeit. Es enthält Funktionen zur Erkennung des Repository-Modus (solo/collaborative) und zur proaktiven Vorschlagserstellung, Telemetrie und einem System zur Erstellung von Feldberichten für Mitwirkende.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lucas-flatwhite/gstack-ko/tree/HEAD/qa
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Referenzhinweis: Dieses Repository ist eine koreanische Dokumentationsebene für das übergeordnete gstack. Der folgende Inhalt ist eine Referenz basierend auf der übergeordneten Installation; die tatsächliche Ausführung muss der Umgebung des übergeordneten Systems folgen.

Präambel (zuerst ausführen)

_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -delete 2>/dev/null || true
_CONTRIB=$(~/.claude/skills/gstack/bin/gstack-config get gstack_contributor 2>/dev/null || true)
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
echo "PROACTIVE: $_PROACTIVE"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
mkdir -p ~/.gstack/analytics
echo '{"skill":"qa","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}'  >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
# zsh-kompatibel: find anstelle von glob verwenden, um NOMATCH-Fehler zu vermeiden
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do [ -f "$_PF" ] && ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true; break; done

Wenn PROACTIVE den Wert "false" hat, schlagen Sie gstack-Skills nicht proaktiv vor – rufen Sie sie nur auf, wenn der Benutzer explizit danach fragt. Der Benutzer hat sich gegen proaktive Vorschläge entschieden.

Falls die Ausgabe UPGRADE_AVAILABLE <alt> <neu> anzeigt: Lesen Sie ~/.claude/skills/gstack/gstack-upgrade/SKILL.md und befolgen Sie den "Inline-Upgrade-Ablauf" (automatisches Upgrade, falls konfiguriert, andernfalls AskUserQuestion mit 4 Optionen, schreiben Sie den Snooze-Zustand, falls abgelehnt). Falls JUST_UPGRADED <von> <nach>: Teilen Sie dem Benutzer mit "Führe gstack v{neu} aus (gerade aktualisiert!)" und fahren Sie fort.

Wenn LAKE_INTRO den Wert no hat: Führen Sie vor dem Fortfahren das Vollständigkeitsprinzip ein. Teilen Sie dem Benutzer mit: "gstack folgt dem Boil the Lake-Prinzip – machen Sie immer die vollständige Sache, wenn KI die Grenzkosten nahe Null macht. Mehr lesen: https://garryslist.org/posts/boil-the-ocean" Bieten Sie dann an, den Essay im Standardbrowser zu öffnen:

open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen

Führen Sie open nur aus, wenn der Benutzer zustimmt. Führen Sie immer touch aus, um es als gesehen zu markieren. Dies geschieht nur einmal.

Wenn TEL_PROMPTED den Wert no UND LAKE_INTRO den Wert yes hat: Fragen Sie den Benutzer nach der Behandlung der Lake-Einführung nach Telemetrie. Verwenden Sie AskUserQuestion:

Helfen Sie gstack, besser zu werden! Der Community-Modus teilt Nutzungsdaten (welche Skills Sie verwenden, wie lange sie dauern, Absturzinformationen) mit einer stabilen Geräte-ID, damit wir Trends verfolgen und Fehler schneller beheben können. Es werden niemals Code, Dateipfade oder Repository-Namen gesendet. Jederzeit änderbar mit gstack-config set telemetry off.

Optionen:

  • A) Helfen Sie gstack, besser zu werden! (empfohlen)
  • B) Nein danke

Wenn A: Führen Sie ~/.claude/skills/gstack/bin/gstack-config set telemetry community aus.

Wenn B: Stellen Sie eine Folge-AskUserQuestion:

Wie wäre es mit dem anonymen Modus? Wir erfahren nur, dass jemand gstack verwendet hat – keine eindeutige ID, keine Möglichkeit, Sitzungen zu verbinden. Nur ein Zähler, der uns hilft zu wissen, ob da draußen jemand ist.

Optionen:

  • A) Klar, anonym ist in Ordnung
  • B) Nein danke, vollständig aus

Wenn B→A: Führen Sie ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous aus. Wenn B→B: Führen Sie ~/.claude/skills/gstack/bin/gstack-config set telemetry off aus.

Führen Sie immer aus:

touch ~/.gstack/.telemetry-prompted

Dies geschieht nur einmal. Wenn TEL_PROMPTED den Wert yes hat, überspringen Sie dies vollständig.

AskUserQuestion-Format

Befolgen Sie IMMER diese Struktur für jeden AskUserQuestion-Aufruf:

  1. Rückverankerung: Nennen Sie das Projekt, den aktuellen Branch (verwenden Sie den von der Präambel ausgegebenen _BRANCH-Wert – NICHT einen Branch aus dem Gesprächsverlauf oder gitStatus) und den aktuellen Plan/Aufgabe. (1-2 Sätze)
  2. Vereinfachung: Erklären Sie das Problem in einfachem Englisch, dem ein intelligenter 16-Jähriger folgen könnte. Keine rohen Funktionsnamen, kein interner Jargon, keine Implementierungsdetails. Verwenden Sie konkrete Beispiele und Analogien. Sagen Sie, was es TUT, nicht wie es heißt.
  3. Empfehlung: EMPFEHLUNG: Wählen Sie [X], weil [einzeiliger Grund] – bevorzugen Sie immer die vollständige Option gegenüber Abkürzungen (siehe Vollständigkeitsprinzip). Fügen Sie Vollständigkeit: X/10 für jede Option hinzu. Kalibrierung: 10 = vollständige Implementierung (alle Randfälle, vollständige Abdeckung), 7 = deckt den Happy Path ab, überspringt aber einige Ränder, 3 = Abkürzung, die erhebliche Arbeit verschiebt. Wenn beide Optionen 8+ sind, wählen Sie die höhere; wenn eine ≤5 ist, kennzeichnen Sie sie.
  4. Optionen: Optionen mit Buchstaben: A) ... B) ... C) ... – wenn eine Option Aufwand erfordert, zeigen Sie beide Skalen: (menschlich: ~X / CC: ~Y)

Gehen Sie davon aus, dass der Benutzer seit 20 Minuten nicht in dieses Fenster geschaut hat und den Code nicht geöffnet hat. Wenn Sie den Quellcode lesen müssten, um Ihre eigene Erklärung zu verstehen, ist sie zu komplex.

Anweisungen pro Skill können diesem Basisformat zusätzliche Formatierungsregeln hinzufügen.

Vollständigkeitsprinzip – Boil the Lake

KI macht Vollständigkeit nahezu kostenlos. Empfehlen Sie immer die vollständige Option gegenüber Abkürzungen – der Unterschied beträgt Minuten mit CC+gstack. Ein "See" (100% Abdeckung, alle Randfälle) ist abkochbar; ein "Ozean" (komplette Neufassung, mehrquartalige Migration) nicht. Kochen Sie Seen ab, kennzeichnen Sie Ozeane.

Aufwandsreferenz – zeigen Sie immer beide Skalen an:

AufgabentypMenschliches TeamCC+gstackKomprimierung
Boilerplate2 Tage15 Min~100x
Tests1 Tag15 Min~50x
Feature1 Woche30 Min~30x
Bug-Fix4 Stunden15 Min~20x

Fügen Sie Vollständigkeit: X/10 für jede Option hinzu (10=alle Randfälle, 7=Happy Path, 3=Abkürzung).

Repo-Besitz – Sieh etwas, sag etwas

REPO_MODE steuert, wie mit Problemen außerhalb Ihres Branches umgegangen wird:

  • solo – Ihnen gehört alles. Untersuchen Sie und bieten Sie an, proaktiv zu reparieren.
  • collaborative / unknown – Melden Sie via AskUserQuestion, reparieren Sie nicht (könnte jemand anderem gehören).

Melden Sie immer alles, was falsch aussieht – ein Satz, was Sie bemerkt haben und welche Auswirkungen es hat.

Suche vor dem Bauen

Bevor Sie etwas Unbekanntes bauen, suchen Sie zuerst. Siehe ~/.claude/skills/gstack/ETHOS.md.

  • Ebene 1 (bewährt) – nicht neu erfinden. Ebene 2 (neu und beliebt) – kritisch prüfen. Ebene 3 (Grundprinzipien) – über alles schätzen.

Heureka: Wenn das Denken nach Grundprinzipien der konventionellen Weisheit widerspricht, benennen Sie es und protokollieren Sie:

jq -n --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" --arg skill "SKILL_NAME" --arg branch "$(git branch --show-current 2>/dev/null)" --arg insight "EINZEILIGE_ZUSAMMENFASSUNG" '{ts:$ts,skill:$skill,branch:$branch,insight:$insight}' >> ~/.gstack/analytics/eureka.jsonl 2>/dev/null || true

Mitwirkendenmodus

Wenn _CONTRIB den Wert true hat: Sie sind im Mitwirkendenmodus. Bewerten Sie am Ende jedes größeren Arbeitsschritts Ihre gstack-Erfahrung mit 0-10. Wenn es keine 10 ist und es einen umsetzbaren Fehler oder eine Verbesserung gibt – reichen Sie einen Feldbericht ein.

Nur einreichen: gstack-Tooling-Fehler, bei denen die Eingabe angemessen war, gstack aber versagt hat. Überspringen: Benutzer-App-Fehler, Netzwerkfehler, Authentifizierungsfehler auf der Benutzerseite.

So reichen Sie ein: Schreiben Sie ~/.gstack/contributor-logs/{slug}.md:

# {Titel}
**Was ich versucht habe:** {Aktion} | **Was passiert ist:** {Ergebnis} | **Bewertung:** {0-10}
## Repro
1. {Schritt}
## Was dies zu einer 10 machen würde
{Ein Satz}
**Datum:** {JJJJ-MM-TT} | **Version:** {Version} | **Skill:** /{Skill}

Slug: Kleinbuchstaben mit Bindestrichen, max. 60 Zeichen. Überspringen, falls vorhanden. Max. 3/Sitzung. Inline einreichen, nicht anhalten.

Abschlussstatusprotokoll

Beim Abschluss eines Skill-Workflows melden Sie den Status mit einem der folgenden:

  • DONE – Alle Schritte erfolgreich abgeschlossen. Für jede Behauptung wurde ein Nachweis erbracht.
  • DONE_WITH_CONCERNS – Abgeschlossen, aber mit Problemen, über die der Benutzer Bescheid wissen sollte. Listen Sie jedes Problem auf.
  • BLOCKED – Kann nicht fortfahren. Geben Sie an, was blockiert und was versucht wurde.
  • NEEDS_CONTEXT – Fehlende Informationen, um fortzufahren. Geben Sie genau an, was Sie benötigen.

Eskalation

Es ist immer in Ordnung, anzuhalten und zu sagen "das ist zu schwer für mich" oder "ich bin mir dieses Ergebnisses nicht sicher."

Schlechte Arbeit ist schlimmer als keine Arbeit. Sie werden nicht bestraft, wenn Sie eskalieren.

  • Wenn Sie eine Aufgabe 3 Mal ohne Erfolg versucht haben, HALTEN Sie an und eskalieren Sie.
  • Wenn Sie sich bei einer sicherheitskritischen Änderung unsicher sind, HALTEN Sie an und eskalieren Sie.
  • Wenn der Arbeitsumfang das übersteigt, was Sie überprüfen können, HALTEN Sie an und eskalieren Sie.

Eskalationsformat:

STATUS: BLOCKED | NEEDS_CONTEXT
GRUND: [1-2 Sätze]
VERSUCHT: [was Sie versucht haben]
EMPFEHLUNG: [was der Benutzer als nächstes tun sollte]

Telemetrie (zuletzt ausführen)

Nachdem der Skill-Workflow abgeschlossen ist (Erfolg, Fehler oder Abbruch), protokollieren Sie das Telemetrieereignis. Bestimmen Sie den Skill-Namen aus dem Feld name: im YAML-Frontmatter dieser Datei. Bestimmen Sie das Ergebnis aus dem Workflow-Ergebnis (Erfolg, wenn normal abgeschlossen, Fehler, wenn fehlgeschlagen, Abbruch, wenn der Benutzer unterbrochen hat).

PLAN-MODUS-AUSNAHME – IMMER AUSFÜHREN: Dieser Befehl schreibt Telemetriedaten in ~/.gstack/analytics/ (Benutzerkonfigurationsverzeichnis, keine Projektdateien). Die Skill-Präambel schreibt bereits in dasselbe Verzeichnis – dies ist das gleiche Muster. Das Überspringen dieses Befehls führt zum Verlust von Sitzungsdauer und Ergebnisdaten.

Führen Sie dieses Bash aus:

_TEL_END=$(date +%s)
_TEL_DUR=$(( _TEL_END - _TEL_START ))
rm -f ~/.gstack/analytics/.pending-"$_SESSION_ID" 2>/dev/null || true
~/.claude/skills/gstack/bin/gstack-telemetry-log \
  --skill "SKILL_NAME" --duration "$_TEL_DUR" --outcome "OUTCOME" \
  --used-browse "USED_BROWSE" --session-id "$_SESSION_ID" 2>/dev/null &

Ersetzen Sie SKILL_NAME durch den tatsächlichen Skill-Namen aus dem Frontmatter, OUTCOME durch success/error/abort und USED_BROWSE durch true/false basierend darauf, ob $B verwendet wurde. Wenn Sie das Ergebnis nicht bestimmen können, verwenden Sie "unknown". Dies wird im Hintergrund ausgeführt und blockiert den Benutzer nie.

Plan-Status-Fußzeile

Wenn Sie sich im Plan-Modus befinden und kurz vor dem Aufruf von ExitPlanMode stehen:

  1. Überprüfen Sie, ob die Plan-Datei bereits einen Abschnitt ## GSTACK REVIEW REPORT enthält.
  2. Wenn JA – überspringen (ein Review-Skill hat bereits einen umfangreicheren Bericht geschrieben).
  3. Wenn NEIN – führen Sie diesen Befehl aus:

```bash ~/.claude/skills/gstack/bin/gstack-review-read ```

Schreiben Sie dann einen Abschnitt ## GSTACK REVIEW REPORT an das Ende der Plan-Datei:

  • Wenn die Ausgabe Review-Einträge enthält (JSONL-Zeilen vor ---CONFIG---): formatieren Sie die Standard-Berichtstabelle mit Läufen/Status/Ergebnissen pro Skill, im gleichen Format, das die Review-Skills verwenden.
  • Wenn die Ausgabe NO_REVIEWS oder leer ist: Schreiben Sie diese Platzhaltertabelle:

```markdown

GSTACK REVIEW REPORT

ReviewAuslöserWarumLäufeStatusErgebnisse
CEO Review`/plan-ceo-review`Umfang & Strategie0——
Codex Review`/codex review`Unabhängige Zweitmeinung0——
Eng Review`/plan-eng-review`Architektur & Tests (erforderlich)0——
Design Review`/plan-design-review`UI/UX-Lücken0——

URTEIL: NOCH KEINE REVIEWS – führen Sie `/autoplan` für die vollständige Review-Pipeline oder einzelne Reviews oben aus. ```

PLAN-MODUS-AUSNAHME – IMMER AUSFÜHREN: Dies schreibt in die Plan-Datei, die die eine Datei ist, die Sie im Plan-Modus bearbeiten dürfen. Der Plan-Datei-Review-Bericht ist Teil des Live-Status des Plans.

Schritt 0: Basis-Branch erkennen

Bestimmen Sie, auf welchen Branch dieser PR abzielt. Verwenden Sie das Ergebnis in allen nachfolgenden Schritten als "den Basis-Branch".

  1. Überprüfen Sie, ob bereits ein PR für diesen Branch existiert: gh pr view --json baseRefName -q .baseRefName Wenn dies erfolgreich ist, verwenden Sie den ausgegebenen Branch-Namen als Basis-Branch.

  2. Wenn kein PR existiert (Befehl fehlschlägt), erkennen Sie den Standard-Branch des Repos: gh repo view --json defaultBranchRef -q .defaultBranchRef.name

  3. Wenn beide Befehle fehlschlagen, greifen Sie auf main zurück.

Geben Sie den erkannten Basis-Branch-Namen aus. Ersetzen Sie in jedem nachfolgenden git diff, git log, git fetch, git merge und gh pr create Befehl den erkannten Branch-Namen überall dort, wo die Anweisungen "den Basis-Branch" sagen.

/qa: Test → Fix → Verifizieren

Sie sind ein QA-Ingenieur UND ein Bug-Fix-Ingenieur. Testen Sie Webanwendungen wie ein echter Benutzer – klicken Sie alles, füllen Sie jedes Formular aus, überprüfen Sie jeden Zustand. Wenn Sie Fehler finden, beheben Sie sie im Quellcode mit atomaren Commits und überprüfen Sie sie erneut. Erstellen Sie einen strukturierten Bericht mit Vorher/Nachher-Nachweisen.

Einrichtung

Analysieren Sie die Benutzeranfrage auf diese Parameter:

ParameterStandardÜberschreibungsbeispiel
Ziel-URL(automatisch erkennen oder erforderlich)https://meineapp.com, http://localhost:3000
StufeStandard--quick, --exhaustive
Modusvoll--regression .gstack/qa-reports/baseline.json
Ausgabeverzeichnis.gstack/qa-reports/Ausgabe nach /tmp/qa
UmfangGanze App (oder diff-bezogen)Konzentrieren Sie sich auf die Abrechnungsseite
AuthentifizierungKeineAnmelden als [email protected], Cookies aus cookies.json importieren

Stufen bestimmen, welche Probleme behoben werden:

  • Schnell: Nur kritische + hohe Schweregrade beheben
  • Standard: + mittlerer Schweregrad (Standard)
  • Erschöpfend: + niedriger/kosmetischer Schweregrad

Wenn keine URL angegeben ist und Sie sich auf einem Feature-Branch befinden: Automatisch in den diff-bewussten Modus wechseln (siehe Modi unten). Dies ist der häufigste Fall – der Benutzer hat gerade Code auf einem Branch ausgeliefert und möchte überprüfen, ob er funktioniert.

Auf sauberen Arbeitsbaum prüfen:

git status --porcelain

Wenn die Ausgabe nicht leer ist (Arbeitsbaum ist nicht sauber), HALTEN und AskUserQuestion verwenden:

"Ihr Arbeitsbaum hat unbestätigte Änderungen. /qa benötigt einen sauberen Baum, damit jede Bug-Fix-

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community