CommunityCodierung & Entwicklunggithub.com

sk-go-service

Implementiere, erweitere oder debugge einen Handler, Service oder Repository in einem Go-Backend-Service, inklusive Kontextweitergabe, Fehlerverpackung, Transaktionsgrenzen, Mandantentrennung und tabellengesteuerten Tests. Verwende dies beim Schreiben oder Ändern von Go-Servercode, beim Hinzufügen eines Endpunkts oder einer gRPC-Methode, beim Berühren einer Repository-Abfrage oder beim Diagnostizieren eines Panics, Lecks oder flaky Tests in einem Go-Service.

Was ist sk-go-service?

Dieser Skill definiert bewährte Konventionen für die Arbeit mit mehrschichtigen Go-Backend-Diensten unter Berücksichtigung von Nebenläufigkeit und Multi-Tenancy. Er behandelt die korrekte Weitergabe von Kontexten (context.Context), das Verpacken von Fehlern mit %w und die Verwendung von errors.Is/As, um eine saubere Fehlerbehandlung über Schichten hinweg zu gewährleisten. Darüber hinaus werden Richtlinien für Transaktionen (Transaktionen auf Service-Ebene öffnen, nicht im Repository) und die Durchsetzung von Mandanten-IDs in jeder Abfrage für Multi-Tenant-Dienste festgelegt. Der Skill betont auch den sicheren Umgang mit Goroutinen (bekannte Lebensdauer und Eigentümer) und die strukturierte Testmethodik mit tabellengesteuerten Tests, Timeout und Race-Detector.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vanhuydotcom/sk-skills/tree/HEAD/skills/sk-go-service

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Go-Service-Arbeit

Konventionen, die einen mehrschichtigen Go-Service unter Nebenläufigkeit und Multi-Tenancy korrekt halten. Lies zuerst das umgebende Paket – ein lokales Muster, das konsistent angewendet wird, hat Vorrang vor allem hier.

Bevor du Code schreibst

Überprüfe die Toolchain. go.mod entscheidet, welche Standardbibliothek und Sprachfeatures verfügbar sind, und Services im selben Workspace befinden sich häufig auf unterschiedlichen Versionen. Ein Loop-Variable-Capture ist ein echter Bug unter Go 1.22 und kein Problem darüber; errors.Join, slices und maps benötigen 1.21. Lies die Version, anstatt die neueste anzunehmen.

Finde dann die Schicht, die die Entscheidung besitzt, die du gerade ändern willst. Handler übersetzen Transport in Domäne und sonst nichts. Services treffen die Entscheidung. Repositories führen die Abfrage aus. Eine Validierung, die im Handler hinzugefügt wird, ist für jeden anderen Aufrufer des Service unsichtbar.

Kontext

Der Kontext gehört zur Anfrage und stirbt mit ihr.

  • Übergib ctx als ersten Parameter, bis zum Datenbankaufruf. Eine Funktion, die keinen Kontext entgegennimmt, kann nicht abgebrochen werden und kann keine Deadline tragen.
  • Speichere niemals ein context.Context in einem Struct-Feld.
  • Gib einen Anforderungskontext niemals an eine Goroutine weiter, die den Handler überlebt. Abgekoppelte Hintergrundarbeit benötigt einen eigenen Kontext mit eigenem Timeout und die benötigten Werte müssen explizit kopiert werden, bevor der Handler zurückkehrt.
  • Gleiches gilt für jedes aus der Anfrage abgeleitete Handle – eine Transaktion, eine Verbindung, ein anforderungsspezifischer Datenbankzugriff. Die Verwendung nach der Rückkehr des Handlers ist ein Use-After-Free mit einer freundlicheren Fehlermeldung.

Fehler

  • Wickle mit %w und füge hinzu, was der Aufrufer nicht bereits weiß: die Kennung, die Operation. fmt.Errorf("Lade Bestellung %d: %w", id, err). Füge den Funktionsnamen nicht als Präfix hinzu; ein Stapel davon liest sich wie Rauschen.
  • Vergleiche mit errors.Is und errors.As. Ein direkter ==-Vergleich bricht, sobald jemand den Fehler verpackt.
  • Übersetze in einen Transportstatus an genau einer Stelle, an der Handler-Grenze. Ein Repository, das einen HTTP-Code zurückgibt, hat zwei Schichten undicht gemacht.
  • sql.ErrNoRows ist ein Domänenergebnis, kein Fehler. Bilde es am Rand des Repository auf das „nicht gefunden“ der Domäne ab, sodass der Service niemals database/sql importiert.
  • Verwerfe niemals einen Fehler, um den Compiler zufriedenzustellen. Wenn er wirklich ignorierbar ist, weise ihn mit _ zu und kommentiere, warum.

Transaktionen

Öffne die Transaktion auf der Schicht, die die Invariante besitzt – normalerweise der Service, niemals das Repository, weil ein Repository, das seine eigene Transaktion öffnet, nicht in eine größere zusammengesetzt werden kann. Gib das Transaktions-Handle nach unten weiter.

Führe Commit und Rollback auf jedem Pfad aus, einschließlich Panic. Der Rollback nach einem erfolgreichen Commit muss harmlos sein; das macht defer tx.Rollback() sicher.

Führe kein I/O innerhalb einer Transaktion durch, das nicht atomar mit ihr sein muss. Ein HTTP-Aufruf an einen Zahlungsanbieter innerhalb einer offenen Transaktion hält Datenbanksperren für die Dauer eines Ausfalls eines anderen.

Mandantenfähigkeit

Wenn der Service mandantenfähig ist, wird die Mandantenkennung im Code durchgesetzt, nicht in der Datenbank. Jede Repository-Abfrage – Lesen und Schreiben – trägt das Mandanten-Prädikat. Eine Abfrage, die nur nach dem Primärschlüssel filtert, gibt freudig die Zeile eines anderen Mandanten zurück. Leite die Kennung von dem im Code bereits verwendeten Anforderungskontext-Zugriff ab und prüfe, welcher Zugriff korrekt ist: Ein Service, der im Namen eines Untermandanten handelt, hat normalerweise zwei, und der offensichtliche ist oft der falsche.

Goroutinen

Jede Goroutine benötigt eine bekannte Lebensdauer und einen bekannten Eigentümer. Bevor du go schreibst, beantworte: Wer wartet auf sie, wie hört sie auf und wohin geht ihr Fehler? Eine Goroutine, deren Fehler verworfen wird, ist ein stiller Fehler.

Verwende errgroup, wenn der Aufrufer wartet. Verwende ein explizites sync.WaitGroup plus einen gesammelten Fehlerkanal, wenn es nicht passt. Ein bloßes go f() in der Anforderungsbearbeitung ist fast immer ein Fehler.

Tests

Tabellengesteuert, ein t.Run pro Fall, benannt nach dem Verhalten, nicht nach der Eingabe. Jeder Fall gibt seine Eingabe, seine Erwartung und nichts weiter an; Setup, das von jedem Fall gemeinsam genutzt wird, gehört oberhalb der Tabelle.

Übergib immer ein Timeout, wenn du sie ausführst:

go test -count=1 -timeout 60s ./...

-count=1 deaktiviert den Ergebniscache, der sonst ein Bestehen für Code meldet, den du gerade geändert hast. Das Timeout ist wichtiger, als es aussieht: Ein festgefahrener Test ohne Timeout verbraucht Speicher, bis die Maschine stehen bleibt.

Teste das exportierte Verhalten des Pakets. Ein Test, der in nicht exportierte Interna eindringt, fixiert die Implementierung und schlägt bei jedem ehrlichen Refactoring fehl.

Wenn ein Test flaky ist, meldet er meistens einen echten Race-Condition. Führe ihn unter -race aus, bevor du etwas anderes annimmst, und behebe ihn niemals durch Hinzufügen eines Sleeps.

Bevor du es als erledigt betrachtest

Führe den engsten Test aus, der die Änderung abdeckt, und erweitere dann, wenn sich ein gemeinsamer Vertrag geändert hat. Führe golangci-lint run im Service aus, nicht über ein Make-Ziel, das den Exit-Code verschlucken kann. Melde Fehler mit ihrer Ausgabe, anstatt den Test abzuschwächen.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

sk-api

Design and change API contracts (REST, gRPC, protobuf, events) so existing callers keep working, covering resource and method shape, error models, pagination, versioning and the deploy order a breaking change requires. Use when adding or altering an endpoint, message or event, or when judging whether a proposed change breaks a consumer.

sk-code-review

Shows an agent how to design, debug, or review "sk code review" so the concrete output is a code change with a check. The procedure moves through Code review, Establish the diff first, What to look for, in priority order. Use it when a new assignment calls for this craft.

sk-python

Write and debug Python with attention to the traps that produce silent wrong behaviour — mutable defaults, late-binding closures, shallow copies, swallowed exceptions — plus typing, environment and packaging with uv or venv, and pytest structure. Use when writing a Python script, service or library, setting up a Python project, or debugging behaviour that looks impossible.

sk-react

Build and fix React and TypeScript components, covering state placement, effect dependencies, data fetching, list rendering and the re-render traps that cause stale or looping UI. Use when writing or changing a React component or hook, debugging stale data, an infinite render loop or a lost input, or reviewing frontend code.

sk-system-design

Design or evaluate a distributed system from its constraints — service boundaries, synchronous versus event-driven communication, consistency, failure behaviour and capacity — and state the trade-off each choice buys. Use when splitting or merging services, choosing between a call and an event, deciding where data lives, reviewing an architecture proposal, or answering a system design question.

Verwandte Skills