Compétences changelog-automation
📦

changelog-automation

Sûr

Automatiser la génération de changelogs et les workflows de publication

La gestion manuelle des changelogs est sujette aux erreurs et prend du temps. Cette skill fournit des modèles et des outils pour automatiser la génération de changelogs, les notes de version et la gestion des versions selon les normes industrielles comme Keep a Changelog et Conventional Commits.

Prend en charge: Claude Codex Code(CC)
📊 69 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "changelog-automation". Montrez-moi un modèle de base Keep a Changelog

Résultat attendu:

Un modèle markdown avec des sections pour Unreleased, Added, Changed, Deprecated, Removed, Fixed et Security, suivant la spécification keepachangelog.com avec des liens de versionnage sémantique appropriés.

Utilisation de "changelog-automation". Quels sont les types de commits conventionnels que je devrais utiliser ?

Résultat attendu:

  • feat: Nouvelles fonctionnalités (déclenche une mise à jour MINOR)
  • fix: Corrections de bugs (déclenche une mise à jour PATCH)
  • docs: Modifications de documentation (pas de mise à jour de version)
  • refactor: Restructuration du code (mapped vers la section Changed)
  • perf: Améliorations de performance (mapped vers la section Changed)
  • test: Ajouts de tests (pas de mise à jour de version)
  • chore: Tâches de maintenance (pas de mise à jour de version)

Utilisation de "changelog-automation". Configurer git-cliff pour mon projet Rust

Résultat attendu:

Un fichier de configuration cliff.toml complet avec analyse des commits conventionnels, intégration GitHub et sections de changelog formatées selon les normes Keep a Changelog.

Audit de sécurité

Sûr
v5 • 1/21/2026

This skill contains documentation and configuration templates for changelog automation tools. All static findings are false positives: network URLs are documentation references to keepachangelog.com and semver.org, backtick patterns are code examples in markdown format, and env_access references are configuration samples for GitHub Actions workflows. No executable code or security risks detected.

2
Fichiers analysés
1,378
Lignes analysées
0
résultats
5
Total des audits
Aucun problème de sécurité trouvé
Audité par: claude Voir l’historique des audits →

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
22
Communauté
100
Sécurité
87
Conformité aux spécifications

Ce que vous pouvez construire

Configuration de publication pour un nouveau projet

Configurer la génération de changelog automatisée pour un nouveau projet Node.js utilisant standard-version, commitlint et GitHub Actions pour des workflows de publication cohérents.

Migration vers les commits conventionnels

Migrer un projet existant vers la norme Conventional Commits avec validation, versionnage automatisé et génération de changelog pour améliorer la cohérence des publications.

Automatisation de publication multi-langages

Configurer l'automatisation du changelog pour des projets dans différents langages en utilisant les outils appropriés comme semantic-release pour Node.js ou commitizen pour Python.

Essayez ces prompts

Configuration de base du changelog 
Aidez-moi à configurer un fichier CHANGELOG.md au format Keep a Changelog pour mon projet
Configurer les commits conventionnels 
Configurer commitlint et husky pour appliquer les commits conventionnels dans mon projet Node.js
Automatiser le workflow de publication 
Créer un workflow GitHub Actions qui génère automatiquement des changelogs et crée des publications avec semantic-release
Configuration de publication personnalisée 
Configurer standard-version avec des types de commit personnalisés et des sections de changelog spécifiques à la structure de mon projet

Bonnes pratiques

  • Utiliser commitlint avec husky pour valider les messages de commit avant leur création, évitant ainsi que des commits invalides n'entrent dans le dépôt
  • Configurer des workflows séparés pour les publications manuelles et automatiques pour supporter à la fois les publications planifiées et les hotfixes d'urgence
  • Définir des conventions claires de types de commit dans la documentation de l'équipe et configurer les parseurs pour correspondre à vos besoins spécifiques de workflow

Éviter

  • Ne pas modifier manuellement les fichiers CHANGELOG.md générés car les modifications seront écrasées lors de la prochaine publication automatisée
  • Éviter de mixer plusieurs modifications non liées dans un seul commit, ce qui rend la catégorisation automatisée inexacte
  • Ne pas sauter la validation commitlint pendant le développement car cela conduit à des changelogs incohérents et une automatisation rompue

Foire aux questions

Quelle est la différence entre standard-version et semantic-release ?
standard-version nécessite un déclenchement manuel et vous donne le contrôle sur le moment des publications, tandis que semantic-release automatise complètement les publications basées sur les messages de commit dans CI/CD. Utilisez standard-version pour l'approbation manuelle des publications, semantic-release pour une automatisation complète.
Comment gérer les breaking changes dans mes commits ?
Ajoutez un point d'exclamation après le type (feat!) ou incluez BREAKING CHANGE: dans le pied de page du commit. Cela déclenche une mise à jour MAJOR et met en évidence le changement de manière proéminente dans le changelog.
Puis-je personnaliser quels types de commits apparaissent dans le changelog ?
Oui, tous les outils supportent la personnalisation. Dans standard-version utilisez .versionrc.js, dans semantic-release utilisez les options de commit-analyzer, et dans git-cliff utilisez commit_parsers dans cliff.toml. Définissez hidden: true ou skip: true pour exclure des types.
Quel outil dois-je utiliser pour un projet Python ?
Utilisez commitizen pour les projets Python. Il s'intègre avec pyproject.toml, supporte les commits interactifs et peut mettre à jour les fichiers de version dans les packages Python automatiquement.
Comment migrer un projet existant vers les commits conventionnels ?
Commencez par ajouter la configuration commitlint et les hooks husky, puis utilisez changelog_start_rev pour commencer le suivi à partir d'une version spécifique. Les commits précédents peuvent rester dans l'ancien format tandis que les nouveaux suivent la convention.
Quelles autorisations les GitHub Actions necesitan-ils pour les publications automatisées ?
Le workflow a besoin de l'autorisation contents: write pour créer des publications et des commits, et peut avoir besoin de pull-requests: write pour les PR de publication. Utilisez GITHUB_TOKEN pour les opérations de base et NPM_TOKEN uniquement si vous publiez sur le registre npm.

Détails du développeur

Auteur

wshobson

Licence

MIT

Dépôt

https://github.com/wshobson/agents/tree/main/plugins/documentation-generation/skills/changelog-automation

Réf

main

Structure de fichiers

📄 SKILL.md