Abhängigkeits-Upgrade-Planer

Erstellt einen sicheren, geordneten Plan zum Upgrade von Projektabhängigkeiten, gruppiert Breaking Changes und kennzeichnet Risiken, bevor etwas geändert wird. Verwenden Sie dies, wenn der Benutzer darum bittet, Abhängigkeiten zu aktualisieren, Pakete zu aktualisieren, eine Hauptversion zu erhöhen, veraltete oder anfällige Pakete zu beheben oder eine Framework-Migration zu planen. Nicht verwenden zum Schreiben von Anwendungsfunktionen oder zum Beheben von Anwendungsfehlern.

Was ist Abhängigkeits-Upgrade-Planer?

Dieses Skill erstellt einen schrittweisen, sicheren Upgrade-Plan für die Abhängigkeiten eines Projekts, ohne sofort Änderungen vorzunehmen. Es erkennt das Ökosystem (npm, pip, Go, Rust, Ruby usw.), liest aktuelle Versionen aus Manifest- und Lockdateien und findet mit den nativen Werkzeugen des Ökosystems verfügbare Versionen. Der Kernwert liegt in der Klassifizierung veralteter Pakete in Patch/Minor, Major und Sicherheitsupdates, die dann in Batches mit Priorität gruppiert werden: Sicherheitsfixes zuerst, dann Patch/Minor, gefolgt von unabhängigen Major-Upgrades und schließlich Major-Upgrades, die zusammen verschoben werden müssen. Das Skill gibt einen klaren, tabellenbasierten Plan mit Versionsänderungen, Breaking Changes, Verifikationsbefehlen und Rollback-Schritten pro Batch aus. Es ist für Claude Code, Cursor, Codex und andere KI-Agenten in Entwicklungsumgebungen geeignet. Wichtig: Das Skill ändert niemals die Manifestdatei während der Planung – der Benutzer muss den Plan genehmigen, bevor die Änderungen umgesetzt werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/teejayfpi/agensi-skills/tree/add-agensi-skills/repo-maintenance-pack/skills/dependency-upgrade-planner

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Abhängigkeits-Upgrade-Planer?

Erstellen Sie einen Plan. Führen Sie kein Upgrade durch, bis der Benutzer den Plan genehmigt hat.

Vorgehen

  1. Erkennen Sie das Ökosystem aus dem Manifest: package.json, requirements.txt oder pyproject.toml, go.mod, Cargo.toml, Gemfile, pom.xml. Wenn mehrere vorhanden sind, fragen Sie, welches geplant werden soll, oder planen Sie sie getrennt.
  2. Lesen Sie die aktuellen Versionen aus dem Manifest und der Lockdatei (package-lock.json, poetry.lock, go.sum, Cargo.lock, Gemfile.lock).
  3. Finden Sie verfügbare Versionen mit dem eigenen Tool des Ökosystems und melden Sie die tatsächlich erhaltene Ausgabe:
    • npm: npm outdated
    • Python: pip list --outdated oder uv pip list --outdated
    • Go: go list -u -m all
    • Rust: cargo outdated
    • Ruby: bundle outdated Wenn das Tool nicht verfügbar ist, sagen Sie dies und arbeiten Sie vom Manifest aus, wobei Sie Versionen als unverifiziert markieren.
  4. Klassifizieren Sie jedes veraltete Paket:
    • Patch / Minor – normalerweise sicher.
    • Major – lesen Sie das Changelog oder die Versionshinweise auf Breaking Changes, bevor Sie es planen.
    • Sicherheit – alles, was von npm audit, pip-audit, govulncheck, cargo audit oder bundle audit gemeldet wird. Diese haben Vorrang.
  5. Ordnen Sie die Arbeit in Batches:
    • Batch 0: Sicherheitsfixes, auch wenn es sich um Major-Versionen handelt.
    • Batch 1: Patch- und Minor-Upgrades, gruppiert nach Bereich.
    • Batch 2: Major-Upgrades ohne Abhängigkeit untereinander, einer pro Commit.
    • Batch 3: Major-Upgrades, die zusammen verschoben werden müssen (z. B. ein Framework und seine Plugins).
  6. Geben Sie für jeden Batch an: die Pakete, die Von-/Nach-Versionen, die zutreffenden Breaking Changes, den Code oder die Konfiguration, die geändert werden müssen, und wie überprüft werden kann.

Ausgabevorlage

## Upgrade-Plan

Ökosystem: <npm / pip / go / cargo / ...>
Manifest: <Pfad>

### Batch 0 – Sicherheit
| Paket | Von | Nach | Grund | Breaking? |
| --- | --- | --- | --- | --- |

### Batch 1 – Patch und Minor
...

### Batch 2 – Major, unabhängig
...

### Batch 3 – Major, müssen zusammen verschoben werden
...

### Verifikation

Nach jedem Batch: <der genaue Befehl, der beweist, dass nichts zurückgegangen ist>

### Rollback

Pro Batch: <wie zurückgesetzt wird, z. B. git revert des Batch-Commits>

### Zurückgestellt

<Pakete, die absichtlich nicht aktualisiert wurden, und warum>

Regeln

  • Bearbeiten Sie das Manifest während der Planung niemals. Geben Sie den Plan aus und stoppen Sie dann.
  • Lesen Sie das tatsächliche Changelog für eine Major-Erhöhung, wenn eines verfügbar ist; gehen Sie nicht davon aus, dass eine Version Breaking Changes enthält, nur weil die Hauptnummer geändert wurde.
  • Nennen Sie immer den Verifikationsbefehl. „Führen Sie die Tests aus“ ist kein Befehl; npm test ist es.
  • Geben Sie den Grund für die Zurückstellung an, wenn Sie ein Paket auslassen – z. B. eine Major-Version, deren Versionshinweise Sie nicht lesen konnten.
  • Führen Sie keine Installations-, Upgrade- oder Audit-Befehle aus, die den Quellbaum verändern. npm outdated, npm audit und ihre Äquivalente sind schreibgeschützt und in Ordnung.

Unterstützende Datei

references/upgrade-strategy.md erklärt Batch-Verarbeitung, Semver-Grenzfälle und den Umgang mit einem Paket, das zurückgehalten werden muss.

Individual skills in this repo

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

Verwandte Skills