Seitenteil bearbeiten
Ziel
Eine gezielte Verbesserung an einem Teil einer bestehenden statischen Website vornehmen, während der Rest der Website erhalten bleibt.
Dieser Skill ist für die iterative Verfeinerung gedacht, nachdem eine Seite bereits existiert. Es soll sich wie eine sorgfältige lokale Bearbeitung anfühlen, nicht wie ein neuer Generierungsdurchlauf.
Vertrag
Eingaben:
- Vorhandener statischer Site-Ordner, Zielseite, Screenshot/lokale URL oder natürlichsprachliche Beschreibung des Zielbereichs.
EDITING.mdund relevante HTML/CSS/JS-Dateien.- Gewünschte Vorher/Nachher-Text-, Stil-, Responsive- oder kleine Interaktionsänderung.
Ausgaben:
- Eine fokussierte Bearbeitung des betroffenen Seitenabschnitts, der Komponente, des Textblocks, der Stilregel oder der kleinen Interaktion.
- Aktualisierte
EDITING.mdnur, wenn sich die Anweisungen für zukünftige Änderungen ändern müssen. - Kurzer Bericht darüber, wo die Änderung vorgenommen wurde, welche Dateien geändert wurden und welche Validierung durchgeführt wurde.
Grenzen:
- Baue die gesamte Seite nicht neu, ändere nicht die Theme-Richtung, importiere keine Beiträge, personalisiere nicht viele Felder und veröffentliche nicht.
- Berühre keine nicht verwandten Seiten/Assets.
- Führe keine Abhängigkeiten, Build-Schritte oder root-absolute site-lokale Pfade ein.
Erfolgskriterium:
- Die angeforderte lokale Änderung ist im selben Browserbereich sichtbar, der vor der Bearbeitung bestätigt wurde.
- Desktop/Mobil oder Interaktionsprüfungen für die betroffene Oberfläche bestehen.
- Es wurden keine nicht verwandten Layout- oder Navigationsänderungen eingeführt.
Wenn das Kriterium nicht erfüllt ist:
- Ordne den Browserbereich der Quelle neu zu und nimm die kleinste korrigierende Änderung vor.
- Führe
review-static-siteaus oder schlage es vor, wenn das Problem die gemeinsame Navigation, viele Seiten, Assets, Kodierung oder die Veröffentlichungsbereitschaft betrifft.
Verwende dies, wenn
Verwende diesen Skill, wenn der Benutzer darum bittet:
- Einen Abschnitt, eine Karte, einen Block, eine Komponente oder einen Seitenbereich zu ändern.
- Ein visuelles Detail kleiner, ruhiger, dichter, sauberer, verspielter, technischer oder weniger ablenkend zu machen.
- Ein mobiles Layoutproblem, Textüberlauf, Abstandsproblem oder eine ungünstige Ausrichtung zu beheben.
- Eine kleine Interaktion anzupassen, wie Hover, Theme-Umschalter, Menüverhalten, Kopier-Button, Filter, Tab oder Animation.
- Einen bestimmten sichtbaren Text umzuschreiben oder zu kürzen.
- Einen Screenshot oder Benutzerkommentar für einen lokalisierten Bereich zu treffen.
Verwende diesen Skill nicht für die vollständige Seitengenerierung, Themensuche, detailgetreue Nachbildung einer neuen Referenzseite, großen Austausch von persönlichen Inhalten, Artikelmigration, Deployment oder Framework-Konvertierung.
Eingaben
Verwende, was der Benutzer bereitstellt:
- Site-Root-Ordner und Zielseite.
- Einen Screenshot, eine Browseransicht, eine lokale URL oder eine natürlichsprachliche Beschreibung des Problems.
- Den genauen Text, Abschnittsnamen, Klassennamen oder den visuellen Bereich, der geändert werden soll.
EDITING.md, falls vorhanden.- Vorhandene HTML/CSS/JS-Dateien.
- Jegliche gewünschte Vorher/Nachher-Formulierung oder Stilrichtung.
Wenn der Zielbereich mehrdeutig ist, inspiziere die Seite und treffe die kleinste sinnvolle Interpretation. Frage nur dann nach einer kurzen Klärung, wenn mehrere plausible Änderungen zu sehr unterschiedlichen Ergebnissen führen würden.
Arbeitsablauf
- Vor der Bearbeitung den Zielbereich im Browser bestätigen.
EDITING.mdlesen, falls vorhanden, dann das relevante HTML/CSS/JS inspizieren.- Suche verwenden, um passende sichtbare Texte, IDs, Klassen, Datenblöcke oder komponentenähnliches Markup zu finden.
- Den bestätigten Browserbereich den relevanten Quelldateien, Selektoren, Datenblöcken oder Event-Handlern zuordnen.
- Die kleinste kohärente Änderung vornehmen, die die Anfrage erfüllt.
- Die vorhandene Designsprache beibehalten, es sei denn, der Benutzer bittet ausdrücklich darum, sie zu ändern.
- Nach der Bearbeitung zur selben Seite und demselben Bereich im Browser zurückkehren und die Änderung dort überprüfen.
- Berichten, was geändert wurde, und auf erforderliche Nachfolgevalidierung hinweisen.
Umfangskontrolle
Halte die Änderung lokal.
- Bevorzuge die Bearbeitung des vorhandenen Abschnitts, der Klasse oder des Datenobjekts anstatt ein paralleles Duplikat zu erstellen.
- Vermeide es, die gesamte Seite neu zu schreiben, wenn eine Änderung auf Abschnittsebene ausreicht.
- Vermeide es, gemeinsame CSS-Variablen zu ändern, es sei denn, der Benutzer wünscht eine seitenweite Stiländerung.
- Vermeide es, nicht verwandte Seiten, Assets oder Inhalte zu berühren.
- Bewahre Navigation, Seitenübersicht, Platzhalterstrategie und
EDITING.md-Konventionen. - Bewahre die Pfadstrategie der Seite; führe während einer lokalen Änderung keine root-absoluten site-lokalen Pfade wie
/assets/...,/posts/...,/images/...oder/data/...ein. - Wenn eine kleine Anfrage ein größeres strukturelles Problem offenbart, erkläre den Kompromiss, bevor du weitreichende Änderungen vornimmst.
Wenn der Benutzer eine breite visuelle Verschiebung über mehrere Seiten hinweg wünscht, schlage stattdessen einen Skill zur größeren Generierung oder Neugestaltung vor.
Die richtige Stelle finden
Verwende eine schichtweise Suche:
- Suche nach dem sichtbaren Text oder nahegelegenen Beschriftungen.
- Durchsuche
EDITING.mdnach der Abschnitts-/Seitenübersicht. - Inspiziere Navigationslinks und Dateinamen der Seiten.
- Inspiziere semantische Tags wie
header,main,section,article,asideundfooter. - Inspiziere CSS-Selektoren und JavaScript-Event-Hooks.
- Verwende Browser-Entwicklertools oder Screenshots, wenn die Quellposition nicht offensichtlich ist.
Wenn wiederholter Inhalt aus Daten gerendert wird, bearbeite die Quelldaten anstatt nur das generierte Markup.
Design bewahren
Füge die Änderung in die aktuelle Seite ein.
- Verwende vorhandene Abstände, Typografie, Farben, Rahmen, Schatten, Symbole und Bewegungsmuster wieder.
- Halte den Text innerhalb seines Containers auf Desktop und Mobilgeräten.
- Vermeide, dass dekorative Effekte das Lesen beeinträchtigen.
- Respektiere
prefers-reduced-motionbeim Ändern von Animationen. - Halte Artikel/Detailseiten ruhiger als stark gestaltete Startseiten, es sei denn, der Benutzer bittet anders.
- Füge einer persönlichen Website oder einem Blog keinen Marketing-Hero oder nicht verwandten dekorativen Abschnitt hinzu.
Beim Ändern von Text, passe die vorhandene Stimme und die Sprache des Benutzers an.
Interaktionsänderungen
Für JavaScript- oder Interaktionsänderungen:
- Finde vorhandene Event-Listener und Statuskonventionen, bevor du neue hinzufügst.
- Behalte Vanilla-JavaScript bei, wenn die Seite statisch ist.
- Vermeide das Einführen von Abhängigkeiten oder Build-Schritten.
- Verwende beim Generieren von Links, Suchergebnissen, Bild-URLs oder Navigationselementen in JavaScript seitenrelative Pfade, die aus der Tiefe der betroffenen Seite funktionieren.
- Teste Klick-, Tastatur-, Mobil- und wiederholte Nutzungszustände, wenn relevant.
- Bewahre grundlegende Barrierefreiheit wie Fokus, Labels und Reduced-Motion-Verhalten.
Responsive-Fixes
Für Layout- oder Mobilprobleme:
- Überprüfe sowohl Desktop- als auch Mobilbreiten.
- Bevorzuge CSS-Änderungen, die das Desktop-Layout bewahren, während schmale Bildschirme repariert werden.
- Verwende stabile Abmessungen, Umbrechen, Min-/Max-Breiten, Grid/Flex-Anpassungen und Überlaufkontrolle.
- Verstecke keine wichtigen Inhalte auf Mobilgeräten, nur um das Layout zu reparieren.
Bearbeitungsanleitung
Wenn die Änderung beeinflusst, wie zukünftige Änderungen vorgenommen werden sollten, aktualisiere EDITING.md.
Aktualisiere sie, wenn:
- Ein neuer Abschnitt, eine neue Klasse, ein neues Datenfeld oder ein neues Interaktionsmuster eingeführt wird.
- Die Speicherung von Inhalten in eine neue Datei oder ein neues Datenobjekt verlagert wird.
- Der Benutzer eine Änderung angefordert hat, die zukünftige Agenten möglicherweise beibehalten müssen.
Aktualisiere EDITING.md nicht für winzige Text- oder Abstandsänderungen, es sei denn, die Anleitung wäre sonst irreführend.
Validierung
Validiere die betroffene Oberfläche, nicht unbedingt die gesamte Seite.
Verwende ein tatsächlich verfügbares interaktives Browser-Tool vor der Bearbeitung, um die Zielseite und den Zielbereich zu bestätigen. „Verfügbar" bedeutet, dass es in der aktuellen Runde in der aufrufbaren Tool-Liste enthalten ist. In Codex kann dies das Browser/in-app Browser-Plugin sein, wenn es in die Runde geroutet wird; in anderen Agenten kann es ein gleichwertiger sichtbarer Browser, ein Browser-Use-Tool oder ein devtools-gestützter Browser sein. Kehre nach der Bearbeitung zu derselben Seite und demselben Bereich im interaktiven Browser zurück, um das Ergebnis zu überprüfen.
Wenn kein interaktives Browser-Tool aufrufbar ist, tue nicht so, als hätte die Vorher/Nachher-Browserbestätigung stattgefunden. Bitte den Benutzer, das Browser-Tool zu aktivieren oder aufzurufen, wenn die Änderung von der visuellen Bereichszuordnung abhängt; für Codex kann dies bedeuten, eine Anfrage zu senden, die explizit @browser erwähnt. Wenn der Benutzer nicht umleitet oder der Client kein solches Tool hat, greife auf Playwright, Screenshots oder Quelltextinspektion zurück und gib die Einschränkung an.
Standardmäßig nicht auf Playwright, Screenshot-only-Validierung oder alleinige Quelltextinspektion zurückgreifen, wenn ein interaktives Browser-Tool tatsächlich aufrufbar ist. Verwende Playwright nur als Fallback, wenn kein interaktives Browser-Tool aufrufbar ist, wenn der Benutzer explizit danach fragt oder wenn eine wiederholbare, skriptbasierte Regression speziell benötigt wird.
Für visuelle, responsive oder interaktive Änderungen überprüfe den geänderten Bereich in den relevanten Desktop-/Mobil-Viewports und übe die geänderte Interaktion aus.
Führe review-static-site nur aus oder schlage es vor, wenn die Änderung die gemeinsame Navigation, das globale Layout, viele Seiten, Asset-Pfade, Quellkodierung oder die Veröffentlichungsbereitschaft betrifft.
Wenn die Änderung href, src, CSS url(...), Bilder, Schriftarten, Favicons, Datendateien oder JavaScript-generierte URLs berührt, überprüfe, ob die betroffene Seite immer noch mit seitenrelativen Pfaden funktioniert und dass das direkte Öffnen der statischen Datei nicht zu einem Verlust von CSS, JS oder Bildern führt.
Ausgabe
Berichte für lokale Änderungen nur:
- Wo die Änderung vorgenommen wurde.
- Welche Dateien geändert wurden.
- Welche Validierung durchgeführt wurde.
Erwähne eine breitere review-static-site-Validierung nur, wenn sie tatsächlich empfohlen wird. Wiederhole den Bericht nicht und erkläre nicht die gesamte Codebasis übermäßig.