run-acceptance-tests
von hashicorpLeitfaden für das Skill `run-acceptance-tests` zum Akzeptanztest von Terraform-Providern. Er hilft dabei, gezielt `TestAcc`-Tests auszuführen, erforderliche Umgebungsvariablen sicher zu handhaben und Fehler mit einem klaren Schritt-für-Schritt-Workflow zu analysieren.
Dieses Skill erzielt 78/100 und ist damit ein solides, aber klar fokussiertes Angebot für Verzeichnisnutzer: Es liefert genug konkrete Workflow-Anleitung, um Akzeptanztest-Läufe korrekt zu starten und Rätselraten zu reduzieren, ist jedoch kein breit angelegter oder besonders ausgefeilter Betriebsleitfaden.
- Klare Triggerbarkeit für Terraform-Akzeptanztests, einschließlich des Präfixes `TestAcc` und der Anforderung `TF_ACC=1`.
- Konkreter Ablauf zum Ausführen und Eingrenzen von Problemen: erneut mit `-count=1`, dann `-v`, dann `TF_LOG=debug` und bei Bedarf mit persistierendem Workspace.
- Hilfreiche Hinweise zur Behebung fehlender provider-spezifischer Umgebungsvariablen, damit Agents häufige Ausführungsfehler abfangen können.
- Ein klarer Zweck und recht eng zugeschnitten: geeignet für Terraform-Provider-Akzeptanztests, nicht für allgemeine Testautomatisierung.
- Keine unterstützenden Skripte, Referenzen oder Beispiele im Repository-Baum, daher müssen Agents sich auf die Prosa-Anweisungen verlassen.
Überblick über die run-acceptance-tests-Skill
Was diese Skill macht
Die run-acceptance-tests-Skill hilft dir dabei, Terraform-Provider-Akzeptanztests korrekt auszuführen, insbesondere Tests mit dem Präfix TestAcc. Sie ist für den Workflow rund um run-acceptance-tests im Acceptance Testing gedacht, bei dem es nicht nur darum geht, „einen Test zu starten“, sondern ihn mit der richtigen Umgebung auszuführen, Fehler richtig zu deuten und zu wissen, wann provider-spezifische Zusatzkonfiguration nötig ist.
Für wen sie gedacht ist
Nutze die run-acceptance-tests-Skill, wenn du an einem Terraform Provider arbeitest und eine praktische run-acceptance-tests-Anleitung für lokale Validierung, CI-Fehlersuche oder das Reproduzieren eines instabilen Ergebnisses brauchst. Sie ist besonders nützlich, wenn du bereits einen konkreten Akzeptanztest im Blick hast und ihn zuverlässig ausführen willst, ohne bei Flags oder Umgebungsvariablen zu raten.
Was sie unterscheidet
Diese Skill ist bewusst meinungsstark bei der Reihenfolge, die zählt: Beginne mit einem gezielten go test -run=...-Aufruf, und ergänze -count=1, -v, TF_LOG=debug und die Persistenz des Workspaces erst dann, wenn der erste Lauf nicht ausreicht. Dadurch ist die run-acceptance-tests-Skill besser als ein generischer Prompt, weil sie eine klare Diagnoseleiter abbildet, statt dich zum Improvisieren aufzufordern.
run-acceptance-tests-Skill verwenden
Skill installieren
Installiere die run-acceptance-tests-Skill mit:
npx skills add hashicorp/agent-skills --skill run-acceptance-tests
Wenn du die Installation von run-acceptance-tests für einen Terraform-Provider-Workflow evaluierst, stelle sicher, dass deine Umgebung Go-Tests ausführen kann und dass du Provider-Zugangsdaten bei Bedarf sicher setzen kannst. Die Skill setzt einen Acceptance-Testing-Kontext voraus, kein eigenständiges Demo-Projekt.
Gib der Skill ein präzises Testziel
Die beste Eingabe ist ein konkreter TestAcc-Name, nicht eine vage Anfrage wie „prüf die Provider-Tests“. Frage zum Beispiel nach etwas wie: „Führe TestAccFeatureHappyPath aus und analysiere fehlende Env Vars.“ Die Skill funktioniert am besten, wenn Testname, Provider und erwartetes Verhalten eindeutig benannt sind.
Starte mit den richtigen Dateien und Signalen
Beginne mit SKILL.md und prüfe dann die README.md, AGENTS.md, metadata.json des Repositories sowie vorhandene unterstützende rules/, resources/, references/- oder scripts/-Ordner. In diesem Repository steckt die zentrale Anleitung in SKILL.md, deshalb ist die Inspektion der Dateistruktur weniger wichtig als bei größeren Skills, aber es lohnt sich trotzdem zu prüfen, ob es versteckte Hilfsdateien gibt.
Folge der Ausführungs- und Debugging-Leiter
Für einen normalen Lauf verwende TF_ACC=1 go test -run=TestAccFeatureHappyPath und halte die Ausgabe zunächst nicht-verbose. Wenn der Test fehlschlägt, wiederhole ihn mit -count=1, um gecachte Ergebnisse zu vermeiden, füge dann -v hinzu, anschließend TF_LOG=debug, und ziehe erst danach TF_ACC_WORKING_DIR_PERSIST=1 in Betracht, um den Terraform-State zwischen den Schritten zu inspizieren. Dieser gestufte Ablauf ist der Kern des run-acceptance-tests-Nutzungsmusters.
FAQ zur run-acceptance-tests-Skill
Ist das nur für Terraform-Provider-Akzeptanztests?
Ja. Die run-acceptance-tests-Skill ist auf Terraform-Provider-Akzeptanztests zugeschnitten, insbesondere auf Go-Tests mit der Namenskonvention TestAcc. Sie ist nicht für Unit-Tests, allgemeine Go-Test-Suites oder andere Infrastrukturprüfungen gedacht.
Was, wenn der Test zusätzliche Umgebungsvariablen braucht?
Das ist zu erwarten. Die Skill geht ausdrücklich davon aus, dass manche Provider zusätzliche Umgebungsvariablen benötigen, und zeigt dir, dass du fehlende Variablen aus der Testausgabe ableiten und sicher setzen sollst. Wenn Zugangsdaten oder Endpunkte fehlen, behandle das als Teil der run-acceptance-tests-Anleitung und nicht als Fehler der Skill selbst.
Brauche ich das statt eines normalen Prompts?
Nutze die Skill, wenn du ein reproduzierbares Verfahren willst und nicht nur eine einmalige Antwort. Ein normaler Prompt kann dir sagen, dass du einen Test ausführen sollst; die run-acceptance-tests-Skill sagt dir, welche Flags, Umgebungsvariablen und Eskalationsschritte du verwenden solltest, wenn der erste Versuch scheitert oder wenn ein bestandener Test trotzdem noch verifiziert werden muss.
Ist sie anfängerfreundlich?
Ja, sofern du bereits Go-Befehle ausführen kannst und grundlegende Umgebungsvariablen verstehst. Die Skill reduziert das Rätselraten für Einsteiger, indem sie mit einem fokussierten Befehl und einer klaren Debug-Eskalation beginnt, erwartet aber trotzdem, dass du provider-spezifische Zugangsdaten, Terraform-Verhalten und Testnamenskonventionen erkennst.
run-acceptance-tests-Skill verbessern
Liefere stärkeren Testkontext
Am hilfreichsten sind der exakte Testname, das Provider-Paket und das Symptom, das du reproduzieren willst. „Acceptance Tests ausführen“ ist zu breit; „Führe TestAccResourceBasic im Paket internal/provider aus und untersuche einen fehlenden TF_LOG-Hinweis“ gibt der Skill genug Kontext, um schnell den richtigen Weg zu wählen.
Teile Fehlerinformationen, nicht nur den Fehlstatus
Wenn der erste Lauf fehlschlägt, füge die vollständige Testausgabe, Meldungen über fehlende Variablen und die Frage hinzu, ob sich das Ergebnis nach -count=1 oder -v geändert hat. Die run-acceptance-tests-Skill wird besser, wenn du ihr die konkrete Form des Fehlers gibst, denn Provider-Akzeptanztests scheitern oft aus unterschiedlichen Gründen: Authentifizierung, fehlende Bereitschaft der Remote-API, State-Drift oder Test-Flakiness.
Nutze die Debug-Optionen in der richtigen Reihenfolge
Bitte zuerst um die minimal notwendige Eskalation und erweitere erst dann, wenn die Belege es verlangen. Bei der run-acceptance-tests-Nutzung bedeutet das meist: mit einem einzelnen fokussierten TestAcc-Namen starten und erst danach verbose Ausgabe, Debug-Logs oder Workspace-Persistenz hinzufügen, wenn klar ist, was du untersuchen musst.
Iteriere am Test, nicht nur am Befehl
Wenn du bestätigen willst, dass ein bestandener Test wirklich aussagekräftig ist, ändere eine Prüfung oder einen Schritt und führe den Test erneut aus, statt nur denselben Befehl zu wiederholen. Dadurch wird die run-acceptance-tests-Skill für Acceptance Testing wertvoller, weil sie dir hilft, einen echten Erfolg von einem falschen Negativ zu unterscheiden und das Signal des Tests mit der Zeit zu schärfen.