Installiere den belt CLI Skill:
npx skills add belt-sh/cli
Produkt-Changelog
Schreibe Changelogs und Release Notes, die Nutzer lesen und schätzen – über die inference.sh CLI.
Schnellstart
Erfordert die inference.sh CLI (
belt). Installationsanleitung
belt login
# Generiere eine visuelle Feature-Ankündigung
belt app run falai/flux-dev-lora --input '{
"prompt": "clean product UI screenshot mockup, modern dashboard interface showing a new analytics chart feature, light mode, minimal design, professional SaaS product",
"width": 1248,
"height": 832
}'
Eintragsformat
Die Anatomie eines guten Eintrags
### Neu: Bulk-Export für Berichte 📊
Sie können jetzt bis zu 10.000 Zeilen auf einmal aus jeder Berichtsansicht exportieren.
Wählen Sie Ihre Zeilen aus, klicken Sie auf Exportieren und wählen Sie CSV- oder Excel-Format.
Zuvor war der Export auf 500 Zeilen pro Export beschränkt.
Struktur: Kategorie-Bezeichnung -> Benutzergerichteter Titel -> Was Sie jetzt tun können -> Wie -> Was hat sich geändert -> Visuelles
Benutzernahe Sprache
❌ Interne Sprache:
"Implementierte Batch-Verarbeitungswarteschlange für den Exportdienst"
"Refactorierte die ReportExporter-Klasse für Paginierung"
"Fehler in der CSV-Serialisierung behoben (PR #4521)"
✅ Benutzernahe Sprache:
"Sie können jetzt bis zu 10.000 Zeilen auf einmal aus jedem Bericht exportieren"
"Berichte werden jetzt 3x schneller geladen, wenn große Datensätze gefiltert werden"
"Ein Problem behoben, bei dem exportierte CSV-Dateien fehlende Spalten hatten"
Regeln:
- Schreiben Sie, was der Nutzer TUN kann, nicht was Sie GEBAUT haben
- Beginnen Sie mit „Sie können jetzt...“ / „Berichte jetzt...“ / „Problem behoben, bei dem...“
- Nennen Sie den Nutzen, nicht nur den Mechanismus
- Verwenden Sie die Gegenwartsform
Kategorien
Standardkategorien
| Kategorie | Farbe | Symbol | Verwendung für |
|---|---|---|---|
| Neu | Grün | ✨ oder 🆕 | Völlig neue Funktionen oder Fähigkeiten |
| Verbessert | Blau | ⚡ oder 🔧 | Verbesserungen bestehender Funktionen |
| Behoben | Gelb/Orange | 🐛 oder 🔨 | Fehlerbehebungen |
| Entfernt | Rot | 🗑️ oder ⚠️ | Veraltete oder entfernte Funktionen |
| Sicherheit | Violett | 🔒 | Sicherheitsupdates |
Kategorisierungsregeln
- Neu = etwas, das Nutzer vorher gar nicht konnten
- Verbessert = etwas, das Nutzer schon konnten, jetzt besser/schneller/einfacher
- Behoben = etwas, das kaputt war, funktioniert jetzt korrekt
- Verwenden Sie nicht „Aktualisiert“ – es ist nichtssagend. War es verbessert oder behoben?
Versionierung
Semantische Versionierung (SemVer)
MAJOR.MINOR.PATCH
3 . 2 . 1
| Komponente | Erhöhen wenn | Beispiel |
|---|---|---|
| MAJOR | Breaking Changes, großes Redesign | 2.0.0 -> 3.0.0 |
| MINOR | Neue Funktionen, abwärtskompatibel | 3.1.0 -> 3.2.0 |
| PATCH | Fehlerbehebungen, kleine Verbesserungen | 3.2.0 -> 3.2.1 |
Datumsbasierte Versionierung
2026-02-08 oder 2026.02.08 oder 8. Februar 2026
Am besten geeignet für SaaS-Produkte mit kontinuierlicher Bereitstellung.
Changelog-Seitenstruktur
# Changelog
## 8. Februar 2026
### Neu
- **Bulk-Export für Berichte** — Exportieren Sie bis zu 10.000 Zeilen auf einmal. [Mehr erfahren →](link)
- **Dark Mode** — Dunkelmodus unter Einstellungen > Darstellung umschalten.
### Verbessert
- **Dashboard-Ladezeit** — Dashboards werden jetzt 3x schneller bei großen Datensätzen geladen.
- **Suche** — Suchergebnisse enthalten jetzt archivierte Elemente.
### Behoben
- Problem behoben, bei dem exportierte CSV-Dateien fehlende Spaltenüberschriften hatten.
- Fehler behoben, bei dem die Datumsauswahl die falsche Zeitzone anzeigte.
---
## 1. Februar 2026
### Neu
- **API-Webhooks** — Werden Sie benachrichtigt, wenn Ereignisse in Ihrem Konto auftreten.
### Behoben
- Problem behoben, bei dem E-Mail-Benachrichtigungen um bis zu 2 Stunden verzögert wurden.
Visuelle Changelogs
Wann visuelle Elemente hinzufügen
| Änderungstyp | Visuelles Element |
|---|---|
| Neue UI-Funktion | Screenshot der neuen Funktion |
| UI-Redesign | Vorher/Nachher-Vergleich |
| Neuer Workflow | Schritt-für-Schritt-Screenshots oder kurzes Video |
| Leistungsverbesserung | Diagramm mit der Verbesserung |
| Komplexe Funktion | Animiertes GIF oder Video-Demo |
Visuelle Elemente generieren
# Funktions-Screenshot (wenn die App läuft, Agent-Browser verwenden)
belt app run infsh/agent-browser --input '{
"url": "https://deine-app.com/neue-funktion",
"action": "screenshot"
}'
# Vorher/Nachher-Vergleich
belt app run infsh/stitch-images --input '{
"images": ["vorher-screenshot.png", "nachher-screenshot.png"],
"direction": "horizontal"
}'
# Annotierter Screenshot mit Hervorhebung
belt app run bytedance/seededit-3-0-i2i --input '{
"prompt": "add a red circle highlight around the export button in the top right area",
"image": "screenshot.png"
}'
# Feature-Ankündigungs-Banner
belt app run falai/flux-dev-lora --input '{
"prompt": "clean modern product announcement banner, gradient blue to purple background, abstract geometric shapes, professional SaaS aesthetic, wide format",
"width": 1248,
"height": 832
}'
Breaking Changes
Breaking Changes benötigen eine besondere Behandlung:
### ⚠️ Breaking: API v2 Endpunkte veraltet
**Was hat sich geändert:** API v1-Endpunkte werden am 15. März 2026 nicht mehr funktionieren.
**Was Sie tun müssen:**
1. Aktualisieren Sie Ihre API-Aufrufe auf v2-Endpunkte ([Migrationsleitfaden →](link))
2. Aktualisieren Sie die Authentifizierung auf Bearer-Tokens anstelle von API-Keys
3. Testen Sie Ihre Integration vor dem 15. März
**Zeitplan:**
- Jetzt: v2-Endpunkte verfügbar, v1 funktioniert noch
- 1. März: v1 gibt Veraltungswarnungen zurück
- 15. März: v1 funktioniert nicht mehr
Wenn Sie Hilfe bei der Migration benötigen, wenden Sie sich an [email protected].
Verteilungskanäle
| Kanal | Format | Wann |
|---|---|---|
| Changelog-Seite | Volle Details, alle Einträge | Bei jedem Release |
| In-App-Benachrichtigung | 1-2-zeilige Zusammenfassung | Neue Funktionen, Breaking Changes |
| Kuratierte Highlights, visuelle Elemente | Große Releases (monatlich/vierteljährlich) | |
| Blogbeitrag | Tiefergehende Erklärung mit Kontext | Große Veröffentlichungen |
| Soziale Medien | Einzelnes Feature-Highlight | Bemerkenswerte Funktionen |
| Slack/Discord | Kurze Ankündigung | Wenn Sie eine Community haben |
Format für Social-Media-Snippets
🆕 Neu in [Produkt]: [Funktionsname]
[1-2-Satz-Beschreibung dessen, was Sie jetzt tun können]
[Screenshot oder Demo-Video]
Jetzt ausprobieren → [link]
Schreibtipps
Do
- Gruppieren Sie zusammenhängende Änderungen zusammen
- Beginnen Sie mit der größten/am meisten gewünschten Änderung
- Verlinken Sie zur Dokumentation für komplexe Funktionen
- Geben Sie an, wer es gewünscht hat („Auf vielfachen Wunsch:“)
- Zeigen Sie Migrationspfade für Breaking Changes auf
- Datieren Sie jeden Eintrag
Don't
- Sagen Sie nicht „verschiedene Fehlerbehebungen“ – listen Sie spezifische Behebungen auf oder lassen Sie sie weg
- Fügen Sie keine internen Referenzen ein (PR-Nummern, Ticket-IDs, Branchnamen)
- Verwenden Sie nicht „[Funktion] aktualisiert“, ohne zu sagen wie
- Listen Sie keine Änderungen auf, die niemanden interessieren (Abhängigkeits-Updates, interne Refactorings)
- Führen Sie keinen Commit-Dump durch – ein Changelog-Eintrag kann viele Commits repräsentieren
Changelog-Frequenz
| Produkttyp | Frequenz | Hinweise |
|---|---|---|
| SaaS (kontinuierliche Bereitstellung) | Wöchentlich gebündelt | Eine Woche Änderungen gruppieren |
| SaaS (große Funktionen) | Pro Feature-Launch | Mit Blogbeitrag |
| Versionierte Software | Pro Version | Verknüpft mit SemVer |
| API | Pro Version + Veraltungshinweise | Migrationsleitfäden einfügen |
| Mobile App | Pro App-Store-Release | Mit Store-Listung „Neuerungen“ abgleichen |
Häufige Fehler
| Fehler | Problem | Lösung |
|---|---|---|
| Entwicklersprache | Nutzer verstehen es nicht | Schreiben, was Nutzer tun können |
| „Fehlerbehebungen und Verbesserungen“ | Null Information | Spezifische Behebungen auflisten |
| Keine Daten | Nicht erkennbar, was neu ist | Jeden Eintrag datieren |
| Keine visuellen Elemente | Nutzer überspringen Text | Screenshot wichtiger Funktionen |
| Breaking Changes versteckt | Nutzer entdecken sie zu spät | Deutliche Warnung + Zeitplan |
| Commit-Log als Changelog | Laut, nicht hilfreich | Kuratieren und umschreiben |
Verwandte Skills
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
Alle Apps durchsuchen: belt app list