CommunityCodierung & Entwicklunggithub.com

sk-react

Erstellen und reparieren Sie React- und TypeScript-Komponenten, inklusive State-Platzierung, Effekt-Abhängigkeiten, Datenabruf, Listendarstellung und die Re-Render-Fallen, die zu veralteten oder endlosen Schleifen in der UI führen. Verwenden Sie dies beim Schreiben oder Ändern einer React-Komponente oder eines Hooks, beim Debuggen von veralteten Daten, einer unendlichen Render-Schleife oder einem verlorenen Input oder beim Überprüfen von Frontend-Code.

Was ist sk-react?

Diese Skill-Anleitung bietet einen umfassenden Leitfaden zum effektiven Umgang mit React und TypeScript. Sie deckt zentrale Konzepte wie die zentrale Platzierung von State ab, bei der jeder Wert genau einen Besitzer haben sollte und abgeleitete Werte nicht in `useState` gespiegelt werden sollten. Sie erklärt die korrekte Nutzung von Effekten, einschließlich der korrekten Abhängigkeitsarrays, Cleanup-Funktionen und der Vermeidung von asynchronen Funktionen als Effektkörper. Die Anleitung behandelt Best Practices für das Datenabrufen, wobei sie die Verwendung von Projekt-Bibliotheken bevorzugt und die vier Zustände (Laden, Leer, Fehler, Erfolg) sowie das Abbrechen von Requests im Cleanup betont. Weiterhin werden wichtige Render-Prinzipien wie stabile Schlüssel für Listen, der gezielte Einsatz von `memo`/`useMemo`/`useCallback`, und das Vermeiden von bedingten Hooks beschrieben. Die TypeScript-Richtlinien warnen vor der Verwendung von `any` und Type Assertions, empfehlen `unknown` und die Validierung von Daten an Grenzflächen. Die Anleitung schließt mit dem Hinweis, dass ein erfolgreicher Build nicht ausreicht und die Komponente selbst getestet werden sollte, auch unter verschiedenen Zuständen. Die Anleitung ist plattformunabhängig und gilt für alle React-Umgebungen.

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

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

React und TypeScript

State an einem Ort ablegen

Jeder Wert sollte genau einen Besitzer haben. Die meisten React-Fehler entstehen, wenn zwei Kopien derselben Tatsache nicht übereinstimmen.

Leite Werte ab, anstatt sie zu speichern. Wenn ein Wert während des Renderings aus Props und State berechnet werden kann, berechne ihn – spiegele ihn nicht in useState, denn die Kopie wird veraltet, sobald sich seine Quelle ändert. const total = items.reduce(...) benötigt keinen State und kann niemals falsch sein.

State, der von einem Prop kopiert wird, ist derselbe Fehler mit einer längeren Zündschnur: Der Anfangswert von useState wird einmal gelesen und danach für immer ignoriert. Wenn die Komponente zurückgesetzt werden muss, wenn sich ein Prop ändert, gib ihr einen key und lass React sie neu mounten.

Hebe State nur so weit hoch, wie der nächste gemeinsame Elternteil, der ihn benötigt. Weiteres Hochheben führt dazu, dass alle Geschwister bei jedem Tastendruck neu rendern.

Effekte

Ein Effekt synchronisiert mit etwas außerhalb von React: einem Abonnement, einem Timer, dem Dokument, einer imperativen Bibliothek. Er ist nicht der Ort, um Werte zu berechnen oder auf einen Klick zu reagieren – dafür ist der Event-Handler zuständig.

Das Abhängigkeitsarray muss alles auflisten, was der Effekt liest. Das Weglassen eines Werts, um eine Schleife zu stoppen, friert ihn auf seinem ersten Wert ein und erzeugt den Stale-Closure-Fehler. Wenn der Effekt eine Schleife verursacht, weil eine Abhängigkeit ein Objekt oder eine Funktion ist, die bei jedem Rendern neu erstellt wird, behebe die Abhängigkeit – useCallback, useMemo, oder verschiebe sie aus der Komponente heraus – anstatt sie aus dem Array zu löschen.

Gib eine Cleanup-Funktion zurück, wann immer der Effekt etwas startet, das ihn überleben kann. Abonnements, Timer und laufende Anfragen müssen alle gestoppt werden, wenn die Komponente unmountet oder sich die Abhängigkeiten ändern, und unter StrictMode in der Entwicklung wird der Effekt zweimal ausgeführt, um genau eine fehlende Bereinigung aufzudecken.

Eine async-Funktion kann kein Effektkörper sein – sie gibt ein Promise zurück, und React erwartet eine Cleanup-Funktion. Deklariere die asynchrone Arbeit im Inneren und rufe sie auf.

Daten abrufen

Bevorzuge die Datenbibliothek des Projekts gegenüber dem manuellen Abrufen in einem Effekt; sie löst bereits Caching, Deduplizierung, Wiederholungsversuche und das Wettrennen, das du gleich schreiben wirst.

Wenn du manuell abrufst, behandle alle vier Zustände – Laden, Leer, Fehler, Erfolg – und brich die Anfrage im Cleanup ab. Zwei in Reihe gestartete Anfragen können immer noch in falscher Reihenfolge aufgelöst werden, also brich entweder die vorherige ab oder ignoriere eine Antwort, die nicht mehr aktuell ist.

Schlucke niemals eine Zurückweisung. Eine nicht behandelte Zurückweisung in einem Handler oder Effekt schlägt stillschweigend fehl, und die UI hört einfach auf, sich zu aktualisieren.

Rendern

Schlüssele Listen mit einer stabilen Identität aus den Daten. Index-Schlüssel sind nur für eine Liste korrekt, die nie neu geordnet, eingefügt oder gelöscht wird; wenn dies geschieht, verwendet React den falschen DOM-Knoten wieder und Eingaben behalten den Wert der vorherigen Zeile.

Greife zu memo, useMemo und useCallback, nachdem du mit dem Profiler gemessen hast. Standardmäßig überall angewendet, fügen sie Allokationen und Abhängigkeitsarrays hinzu, die schiefgehen können, und sie lösen nichts, wenn die eigentliche Kosten ein Elternteil ist, das den gesamten Baum neu rendert.

Rufe niemals einen Hook bedingt, in einer Schleife oder nach einer frühen Rückkehr auf. Die Reihenfolge muss bei jedem Rendern identisch sein.

TypeScript

Behandle any und eine Typ-Assertion als eine ungelöste Frage, nicht als eine Lösung. Beide bringen den Compiler genau an der Stelle zum Schweigen, an der er etwas Nützliches zu sagen hatte. Wenn ein Typ wirklich unbekannt ist, verwende unknown und grenze ihn ein.

Typisiere, was eine Grenze überschreitet: API-Antworten, Formularwerte, URL-Parameter. Daten aus dem Netzwerk sind nicht der Typ, den du deklariert hast, bis etwas sie überprüft – validiere also an der Grenze und lass den Rest der App dem Ergebnis vertrauen.

Überprüfen

Ein grüner Build beweist weniger, als es scheint. Viele Projekte konfigurieren das Framework so, dass Lint- und Typfehler während des Builds ignoriert werden – überprüfe daher die Konfiguration, bevor du den Build als Beweis betrachtest, und führe die Typprüfung und den Linter explizit aus.

Dann verwende die Komponente: den leeren Zustand, den Fehlerzustand, ein langsames Netzwerk und eine zweite schnelle Interaktion, bevor die erste abgeschlossen ist.

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-go-service

Implement, extend or debug a handler, service or repository in a Go backend service, covering context propagation, error wrapping, transaction boundaries, tenancy scoping and table-driven tests. Use when writing or changing Go server code, adding an endpoint or gRPC method, touching a repository query, or diagnosing a panic, leak or flaky test in a Go service.

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-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