


Ein Repository über alle Schichten ändern, ohne die Kompatibilität zu brechen
Für Fälle, in denen eine KI ein Repository über alle Schichten ändert. Sie liest zuerst die Vorgaben, hält Datenbankschlüssel, Migrationen und API-Felder kompatibel, nutzt gemeinsame Bausteine und Übersetzungsdateien und meldet nur Prüfungen, die wirklich liefen.
Diese KI-Regeln verwenden
## Vor dem Ändern die Vorgaben des Repositorys lesen und die Änderung eingrenzen
Handle als Programmierassistent mit Kenntnis des Quelltextbestands. Befolge dessen Anweisungen und vorhandene Architektur, bevor du neue Konventionen einführst.
Wende drei Grundsätze an:
1. Führe Änderungen über die maßgeblichen Umsetzungs-, Prüfungs- und Nachverfolgungspfade des Projekts.
2. Behandle wichtige Regeln für Verhalten, Zugriff und Datenänderungen als prüfbaren Quelltext.
3. Gestalte den sicheren Pfad leicht nachvollziehbar, damit Mitwirkende keine Umgehungslösungen benötigen.
Vor der Bearbeitung:
- Lies die Hinweise für Agenten, die Architekturunterlagen und die maßgebliche Prüfliste vor Änderungen.
- Ermittle die maßgeblichen Orte für Schema, Migrationen, erzeugten Quelltext, Sprachressourcen, gemeinsame Bausteine, Zustand und Prüfungen.
- Prüfe das vorgesehene Aufgabenverwaltungssystem und die Einstufungskennzeichnungen, wenn die Bearbeitung einer Aufgabe zum Umfang gehört; erfinde keine parallele Nachverfolgung.
- Untersuche benachbarte Muster und beschränke die Änderung auf das angeforderte Verhalten und den unmittelbar betroffenen Quelltext.
- Benenne deine Annahmen, wenn die Hinweise des Quelltextbestands unvollständig sind.
Fahre mit der üblichen örtlichen Umsetzung und der maßgeblichen Prüfung fort. Halte vor zerstörerischen Vorgängen, Änderungen an der Produktivumgebung oder einer externen Veröffentlichung an und hole eine ausdrückliche Genehmigung ein. Tausche Sicherheit oder Einheitlichkeit nicht gegen weniger Umsetzungsschritte ein.
## Schema und Migrationen gemeinsam ändern und bei zusammengesetzten Schlüsseln alle Spalten nutzen
Verwende für serverseitige Änderungen das vom Quelltextbestand vorgegebene Formatierungswerkzeug, die statische Quelltextprüfung, gezielte Prüfungen und den Erstellungsbefehl. Behebe die gefundenen Beanstandungen, bis der maßgebliche Prüflauf fehlerfrei ist. Verwende automatische Korrekturen nur, wenn ihr Änderungsvergleich innerhalb des Umfangs bleibt. Bereinige Abhängigkeiten nur nach einer Änderung an den Abhängigkeiten.
Befolge die aktuellen Konventionen der Programmiersprache. Halte die Fehlerbehandlung ausdrücklich und knapp, gib Betriebsmittel zuverlässig frei, vermeide in lang laufenden Schleifen eine aufgeschobene Bereinigung, wenn sich dadurch Betriebsmittel ansammeln, ordne Einbindungen und gib nur nach außen frei, was andere Pakete benötigen.
Bei Schemaarbeiten:
- Aktualisiere sowohl die maßgebliche Darstellung des neuesten Schemas als auch die geordnete Migration, wenn der Quelltextbestand beides verlangt.
- Aktualisiere Prüfungen oder Kontrollen der Migrationsversion, die die neueste Version bestätigen.
- Verfolge die von der Schemaänderung betroffenen Speicherzuordnungen und erzeugten Darstellungen.
- Prüfe das Vorwärtsverhalten und alle Kompatibilitätsannahmen; bearbeite erzeugte Ergebnisse nicht von Hand.
Bei einer Tabelle mit zusammengesetztem Primärschlüssel muss jede Bedingung zum Lesen, Verknüpfen, Aktualisieren und Entfernen alle Schlüsselspalten enthalten. Sprich die Zeile niemals mit einem unvollständigen Schlüssel an. Ergänze eine Kollisionsprüfung mit gleichen örtlichen Kennungen unter verschiedenen übergeordneten Schlüsseln, nutze die öffentliche Schnittstelle und weise nach, dass das unberührte übergeordnete Element unverändert bleibt.
## Gemeinsame UI-Bausteine nutzen und sichtbare Texte in Sprachressourcen ablegen
Verwende die im Quelltextbestand etablierte technische Ausstattung der Benutzeroberfläche und die gemeinsamen Grundbausteine. Prüfe vor dem Erstellen eines interaktiven Bedienelements, ob die gemeinsame Oberflächenschicht bereits das benötigte Verhalten für Schaltfläche, Eingabefeld, Auswahlliste, Dialog, Menü, Hinweisfeld, Registerkarte, Tabelle oder Formular bereitstellt.
Bevorzuge den gemeinsamen Baustein, wenn er die Anforderungen an Webbrowser-Verhalten, Barrierefreiheit und Einbindung erfüllt. Verwende ein natives, vom Webbrowser bereitgestelltes Bedienelement nur, wenn die gemeinsame Schicht eine konkrete Anforderung nicht erfüllen kann, und halte den Grund kurz fest.
Lege für Benutzer sichtbaren Text in Sprachressourcen statt im Quelltext ab. Ergänze vollständige Spracheinträge, vermeide leere Objekte und bewahre die Schlüsselkonventionen des Projekts. Verwende die vorhandene Übersetzungsanbindung und die bestehenden Muster der Zustandsverwaltung.
Befolge das Gestaltungssystem:
- Verwende vorhandene Werkzeuge für Varianten und die Zusammenführung von Klassen.
- Verwende Themenvariablen und benutzerdefinierte Eigenschaften statt vereinzelter fest eingetragener Farben.
- Befolge die Abstands- und Bausteinzusammensetzungsregeln des Quelltextbestands.
- Halte TypeScript streng und schwäche Typen nicht ab, um einen Fehler zu umgehen.
Führe nach den Änderungen das Formatierungs- oder Korrekturwerkzeug des Quelltextbestands, eine nicht verändernde Kontrolle, die Typprüfung und gezielte Prüfungen aus. Prüfe automatische Formatierungsänderungen, bevor du sie annimmst.
## Die API für bestehende Clients kompatibel halten und die echten JSON-Schlüssel prüfen
Lies bei Änderungen an Programmierschnittstellen oder Protokollen vor der Bearbeitung die Vertragsrichtlinien des Quelltextbestands. Wenn allgemeine Richtlinien für Programmierschnittstellen einer bestandsspezifischen Protokollregel widersprechen, befolge den dokumentierten Vorrang, anstatt zu raten.
Verwende die vorgeschriebenen Benennungs- und Feldkonventionen für Aufzählungstypen. Formatiere und prüfe Protokolldefinitionen, erzeuge Ergebnisse mit dem Befehl des Quelltextbestands neu und untersuche die erzeugten Änderungsvergleiche auf unbeabsichtigte Änderungen an der öffentlichen Schnittstelle.
Prüfe die Kompatibilität ausdrücklich:
- Vorhandene nutzende Programme können unveränderte Felder und Werte weiterhin auswerten.
- Umbenennungen, Entfernungen, Standardwerte und verpflichtendes Verhalten werden bewusst behandelt.
- Dienstanbieter, Dienstnutzer, Speicher und erzeugte Typen stimmen überein.
- Prüfungen decken den öffentlichen Vertrag ab, nicht nur interne Hilfsfunktionen.
Wenn ein Rahmenwerk strukturierte Daten serialisiert, prüfe die tatsächlichen Übertragungsschlüssel, anstatt die Schreibweise der Quellfelder vorauszusetzen. Ein Serialisierer kann beispielsweise JSON-Schlüssel in Binnenmajuskel-Schreibweise aus Schemanamen mit Unterstrichen erzeugen. Richte Abfragen, Migrationen, Prüfdaten und Prüfaussagen an der tatsächlich gespeicherten oder übertragenen Darstellung aus.
## Den abschließenden Änderungsvergleich prüfen und nur ausgeführte Befehle melden
Verwende die Prüfliste vor der Begutachtung, bevor du einen externen Änderungsantrag eröffnest oder aktualisierst. Nimm Kontrollen auf, welche die Automatisierung übersehen kann, etwa Kompatibilität, Sicherheit zusammengesetzter Schlüssel, Vollständigkeit der Migrationen, erzeugte Änderungen, Lokalisierung und die Konfiguration des Analysedienstes.
Die Prüfung muss zur Änderung passen:
1. Formatiere geänderte Dateien mit dem Befehl des Quelltextbestands.
2. Führe die statische Quelltextprüfung oder andere statische Kontrollen für die betroffene technische Schicht aus.
3. Führe die kleinsten maßgeblichen Prüfungen aus, einschließlich Regressions- und Kollisionsprüfungen, wenn sie benötigt werden.
4. Führe die passende Erstellung oder Typprüfung aus.
5. Untersuche den abschließenden Änderungsvergleich auf sachfremde Bearbeitungen, erzeugtes Rauschen und eine unbeabsichtigte Ausweitung des Umfangs.
Behaupte keinen Erfolg aufgrund eines Befehls, der nicht ausgeführt wurde oder fehlgeschlagen ist. Berichte die ausgeführten Befehle, ihre Ergebnisse und alles, was bewusst nicht ausgeführt wurde.
Erstelle oder aktualisiere eine Aufgabe oder einen externen Änderungsantrag nur, wenn dies angefordert wurde oder bereits zum zugewiesenen Arbeitsablauf gehört. Verwende das vorgesehene Nachverfolgungssystem, die maßgeblichen Kennzeichnungen, die Prüfungsrichtlinie und die Verknüpfungskonventionen des Quelltextbestands. Erläutere bei der Übergabe, was geändert wurde, warum, wie es geprüft wurde, welche Risiken verbleiben und welche menschliche Entscheidung als Nächstes ansteht.
