Installer la compétence CLI belt :
npx skills add belt-sh/cli
Journal des Modifications Produit
Rédigez des journaux des modifications et des notes de version que les utilisateurs lisent et qui les intéressent, via le CLI inference.sh.
Démarrage Rapide
Nécessite le CLI inference.sh (
belt). Instructions d'installation
belt login
# Générer un visuel d'annonce de fonctionnalité
belt app run falai/flux-dev-lora --input '{
"prompt": "maquette d'interface utilisateur de produit propre, tableau de bord moderne affichant une nouvelle fonctionnalité de graphique d'analyse, mode clair, design minimaliste, produit SaaS professionnel",
"width": 1248,
"height": 832
}'
Format d'Entrée
L'Anatomie d'une Bonne Entrée
### Nouveau : Export en Masse pour les Rapports 📊
Vous pouvez désormais exporter jusqu'à 10 000 lignes à la fois depuis n'importe quelle vue de rapport.
Sélectionnez vos lignes, cliquez sur Exporter, et choisissez le format CSV ou Excel.
Auparavant limité à 500 lignes par export.
Structure : Étiquette de catégorie -> Titre orienté utilisateur -> Ce que vous pouvez faire maintenant -> Comment -> Ce qui a changé -> Visuel
Langage Orienté Utilisateur
❌ Langage interne :
"Mise en œuvre de la file d'attente de traitement par lots pour le service d'export"
"Réusinage de la classe ReportExporter pour prendre en charge la pagination"
"Correction d'un bogue dans la sérialisation CSV (PR #4521)"
✅ Langage orienté utilisateur :
"Vous pouvez désormais exporter jusqu'à 10 000 lignes à la fois depuis n'importe quel rapport"
"Les rapports se chargent désormais 3 fois plus vite lors du filtrage de grands ensembles de données"
"Correction d'un problème où les fichiers CSV exportés avaient des colonnes manquantes"
Règles :
- Écrivez ce que l'utilisateur peut FAIRE, pas ce que vous avez CONSTRUIT
- Commencez par "Vous pouvez désormais..." / "Les rapports maintenant..." / "Correction d'un problème où..."
- Incluez l'avantage, pas seulement le mécanisme
- Utilisez le présent de l'indicatif
Catégories
Catégories Standard
| Catégorie | Couleur | Icône | Utilisation |
|---|---|---|---|
| Nouveau | Vert | ✨ ou 🆕 | Fonctionnalités ou capacités entièrement nouvelles |
| Amélioré | Bleu | ⚡ ou 🔧 | Améliorations des fonctionnalités existantes |
| Corrigé | Jaune/Orange | 🐛 ou 🔨 | Corrections de bogues |
| Supprimé | Rouge | 🗑️ ou ⚠️ | Fonctionnalités obsolètes ou supprimées |
| Sécurité | Violet | 🔒 | Correctifs de sécurité |
Règles de Catégorisation
- Nouveau = quelque chose que les utilisateurs ne pouvaient pas faire du tout auparavant
- Amélioré = quelque chose que les utilisateurs pouvaient faire, maintenant c'est mieux/plus rapide/plus facile
- Corrigé = quelque chose qui était cassé, maintenant fonctionne correctement
- N'utilisez pas "Mis à jour" — c'est dénué de sens. Était-ce amélioré ou corrigé ?
Numérotation des Versions
Version Sémantique (SemVer)
MAJEUR.MINEUR.CORRECTIF
3 . 2 . 1
| Composant | Incrémenter Quand | Exemple |
|---|---|---|
| MAJEUR | Changements cassants, refonte majeure | 2.0.0 -> 3.0.0 |
| MINEUR | Nouvelles fonctionnalités, rétrocompatibles | 3.1.0 -> 3.2.0 |
| CORRECTIF | Corrections de bogues, petites améliorations | 3.2.0 -> 3.2.1 |
Version Basée sur la Date
2026-02-08 ou 2026.02.08 ou 8 février 2026
Idéal pour les produits SaaS avec déploiement continu.
Structure de la Page du Journal
# Journal des Modifications
## 8 février 2026
### Nouveau
- **Export en Masse pour les Rapports** — Exportez jusqu'à 10 000 lignes à la fois. [En savoir plus →](lien)
- **Mode Sombre** — Activez le mode sombre depuis Paramètres > Apparence.
### Amélioré
- **Chargement des Tableaux de Bord** — Les tableaux de bord se chargent désormais 3 fois plus vite sur les grands ensembles de données.
- **Recherche** — Les résultats de recherche incluent désormais les éléments archivés.
### Corrigé
- Correction d'un problème où les fichiers CSV exportés avaient des en-têtes de colonnes manquants.
- Correction d'un bogue où le sélecteur de date affichait un fuseau horaire incorrect.
---
## 1er février 2026
### Nouveau
- **Webhooks API** — Soyez notifié lorsque des événements se produisent dans votre compte.
### Corrigé
- Correction d'un problème où les notifications par e-mail étaient retardées jusqu'à 2 heures.
Journaux Visuels
Quand Ajouter des Visuels
| Type de Changement | Visuel |
|---|---|
| Nouvelle fonctionnalité UI | Capture d'écran de la nouvelle fonctionnalité |
| Refonte UI | Comparaison avant/après |
| Nouveau workflow | Captures d'écran étape par étape ou courte vidéo |
| Amélioration des performances | Graphique montrant l'amélioration |
| Fonctionnalité complexe | GIF animé ou démo vidéo |
Génération de Visuels
# Capture d'écran de fonctionnalité (si l'application est en cours d'exécution, utilisez un navigateur agent)
bel app run infsh/agent-browser --input '{
"url": "https://votre-app.com/nouvelle-fonctionnalite",
"action": "screenshot"
}'
# Comparaison avant/après
bel app run infsh/stitch-images --input '{
"images": ["before-screenshot.png", "after-screenshot.png"],
"direction": "horizontal"
}'
# Capture d'écran annotée avec légende
bel app run bytedance/seededit-3-0-i2i --input '{
"prompt": "ajoutez un cercle rouge de surbrillance autour du bouton d'export dans la zone supérieure droite",
"image": "screenshot.png"
}'
# Bannière d'annonce de fonctionnalité
bel app run falai/flux-dev-lora --input '{
"prompt": "bannière d'annonce de produit moderne et propre, fond dégradé bleu à violet, formes géométriques abstraites, esthétique SaaS professionnelle, format large",
"width": 1248,
"height": 832
}'
Changements Cassants
Les changements cassants nécessitent un traitement spécial :
### ⚠️ Cassant : Points de Terminaison API v2 Obsolètes
**Ce qui a changé :** Les points de terminaison API v1 cesseront de fonctionner le 15 mars 2026.
**Ce que vous devez faire :**
1. Mettez à jour vos appels API pour utiliser les points de terminaison v2 ([guide de migration →](lien))
2. Mettez à jour l'authentification pour utiliser des jetons Bearer au lieu de clés API
3. Testez votre intégration avant le 15 mars
**Calendrier :**
- Maintenant : les points de terminaison v2 sont disponibles, v1 fonctionne toujours
- 1er mars : v1 renvoie des avertissements de dépréciation
- 15 mars : v1 cesse de fonctionner
Si vous avez besoin d'aide pour migrer, contactez [email protected].
Canaux de Distribution
| Canal | Format | Quand |
|---|---|---|
| Page du journal | Détails complets, toutes les entrées | Chaque version |
| Notification in-app | Résumé de 1 à 2 lignes | Nouvelles fonctionnalités, changements cassants |
| Points forts choisis, visuels | Versions majeures (mensuelles/trimestrielles) | |
| Article de blog | Analyse approfondie avec contexte | Gros lancements |
| Réseaux sociaux | Mise en avant d'une seule fonctionnalité | Fonctionnalités notables |
| Slack/Discord | Annonce brève | Si vous avez une communauté |
Format du Snippet pour les Réseaux Sociaux
🆕 Nouveau dans [Produit] : [Nom de la fonctionnalité]
[Description en 1-2 phrases de ce que vous pouvez maintenant faire]
[Capture d'écran ou vidéo de démonstration]
Essayez-le maintenant → [lien]
Conseils de Rédaction
À Faire
- Regroupez les changements connexes ensemble
- Commencez par le changement le plus important/le plus demandé
- Liez à la documentation pour les fonctionnalités complexes
- Incluez qui l'a demandé ("Sur demande populaire :")
- Affichez les chemins de migration pour les changements cassants
- Datez chaque entrée
À Ne Pas Faire
- Ne dites pas "diverses corrections de bogues" — listez les corrections spécifiques ou sautez-les
- N'incluez pas de références internes (numéros de PR, ID de ticket, noms de branches)
- N'utilisez pas "Fonctionnalité [nom] mise à jour" sans dire comment
- Ne listez pas les changements dont personne ne se soucie (mises à jour de dépendances, refontes internes)
- Ne faites pas de "commit dump" — une entrée de journal peut représenter plusieurs commits
Fréquence du Journal
| Type de Produit | Fréquence | Notes |
|---|---|---|
| SaaS (déploiement continu) | Lot hebdomadaire | Regroupez une semaine de changements |
| SaaS (fonctionnalités majeures) | Par lancement de fonctionnalité | Avec article de blog |
| Logiciel versionné | Par version | Liée au semver |
| API | Par version + avis de dépréciation | Incluez des guides de migration |
| Application mobile | Par sortie sur l'App Store | Correspond à la section "Nouveautés" de la fiche de l'App Store |
Erreurs Courantes
| Erreur | Problème | Solution |
|---|---|---|
| Langage développeur | Les utilisateurs ne comprennent pas | Écrivez ce que les utilisateurs peuvent faire |
| "Corrections de bogues et améliorations" | Zéro information | Listez les corrections spécifiques |
| Pas de dates | Impossible de savoir ce qui est nouveau | Datez chaque entrée |
| Pas de visuels | Les utilisateurs ignorent le texte | Capture d'écran des fonctionnalités majeures |
| Changements cassants cachés | Les utilisateurs découvrent trop tard | Avertissement visible + calendrier |
| Journal comme log de commits | Bruyant, inutile | Curation et réécriture |
Compétences Connexes
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
Parcourir toutes les apps : belt app list