next-upgrade

Überblick

Was ist next-upgrade?

next-upgrade ist eine spezialisierte Skill, die Frontend-Entwicklern dabei hilft, ihre Next.js-Projekte nahtlos auf die neueste Version zu aktualisieren. Durch die Automatisierung des Prozesses mit offiziellen Migrationsanleitungen und Codemods reduziert next-upgrade den manuellen Aufwand und minimiert Fehler bei großen Versionssprüngen.

Für wen ist next-upgrade geeignet?

Diese Skill ist ideal für React- und Next.js-Entwickler, die produktive Anwendungen pflegen und stets die neuesten Features, Sicherheitsupdates und Performance-Verbesserungen von Next.js nutzen möchten. Besonders nützlich ist sie für Teams, die komplexe Codebasen verwalten oder bewährte Vorgehensweisen bei Framework-Upgrades einhalten müssen.

Probleme, die next-upgrade löst

• Automatisierte Erkennung der aktuellen Next.js-Version und Abhängigkeiten
• Abruf und Anwendung der neuesten offiziellen Migrationsanleitungen
• Ausführung empfohlener Codemods zur Behandlung von Breaking Changes
• Unterstützung bei schrittweisen Upgrades bei großen Versionssprüngen
• Sicherstellung, dass Peer-Abhängigkeiten wie React und React DOM gemeinsam aktualisiert werden

Verwendung

Installationsschritte

1. Fügen Sie die Skill Ihrem Agent hinzu:

   npx skills add https://github.com/vercel-labs/next-skills --skill next-upgrade
   

2. Bereiten Sie Ihr Projekt vor:
   • Stellen Sie sicher, dass Ihr Projekt Next.js verwendet und eine package.json-Datei vorhanden ist.
   • Sichern oder committen Sie Ihren Code, bevor Sie mit dem Upgrade beginnen.

Ausführen von next-upgrade

1. Starten Sie mit der Skill-Dokumentation:
   • Öffnen Sie SKILL.md für eine ausführliche Übersicht und Hinweise zu Argumenten.
2. Erkennen Sie Ihre aktuelle Version:
   • Die Skill liest Ihre package.json, um die aktuelle Next.js- und verwandte Abhängigkeitsversionen zu identifizieren.
3. Abrufen und Überprüfen der Migrationsanleitungen:
   • next-upgrade lädt die neuesten offiziellen Upgrade-Dokumentationen von nextjs.org, einschließlich Codemods und versionsspezifischer Anleitungen.
4. Anwenden von Codemods:
   • Verwenden Sie die empfohlenen Codemods für Ihren Upgrade-Pfad. Zum Beispiel:

     npx @next/codemod@latest <transform> <path>
     

   • Häufige Transforms sind next-async-request-api, next-request-geo-ip und next-dynamic-access-named-export.
5. Aktualisieren der Abhängigkeiten:
   • Aktualisieren Sie Next.js und seine Peer-Abhängigkeiten gemeinsam:

     npm install next@latest react@latest react-dom@latest
     

6. Überprüfen und Testen:
   • Folgen Sie der Migrationsanleitung für manuelle Schritte und Breaking Changes.
   • Testen Sie Ihre Anwendung nach jedem Upgrade-Schritt gründlich.

Empfohlene Dateien zur Überprüfung

• SKILL.md – Hauptanleitung zur Nutzung
• README.md, AGENTS.md und metadata.json – Weitere Kontextinformationen und Konfiguration

FAQ

Was automatisiert next-upgrade?

next-upgrade automatisiert die Versionserkennung, das Abrufen offizieller Migrationsanleitungen und das Ausführen von Codemods für Next.js-Upgrades. Es vereinfacht den Prozess, erfordert aber weiterhin Entwicklerüberprüfung und Tests.

Kann ich next-upgrade für jede Next.js-Version verwenden?

Ja, next-upgrade unterstützt schrittweise Upgrades von älteren Versionen, indem es offiziellen Anleitungen für jede Hauptversion folgt. Bei großen Versionssprüngen wird empfohlen, jeweils eine Hauptversion zu aktualisieren.

Aktualisiert next-upgrade auch React und React DOM?

Ja, die Skill stellt sicher, dass Peer-Abhängigkeiten wie React und React DOM zusammen mit Next.js für die Kompatibilität aktualisiert werden.

Wo finde ich weitere Details oder Hilfe bei Problemen?

Untersuchen Sie die vollständige Dateistruktur im Files-Tab, einschließlich verschachtelter Referenzen und Hilfsskripte. Überprüfen Sie stets die offiziellen Next.js-Migrationsdokumente für die aktuellsten Anleitungen.