AgentSkillsCN

gen-release-notes

生成面向最终用户的 HTML 发布说明。将技术性的提交信息转化为通俗易懂、无需专业术语的描述。

SKILL.md
--- frontmatter
name: gen-release-notes
description: >
  Génère des notes de release HTML orientées utilisateurs finaux.
  Transforme les commits techniques en descriptions accessibles sans jargon.
allowed-tools: [Bash, Read, Write, Grep, Glob, AskUserQuestion]
model: sonnet

Gen Release Notes Skill

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

Usage

code
/git:gen-release-notes <branche-source> <branche-cible> [nom-release]

Si arguments manquants : AskUserQuestion pour demander.

Workflow

Initialisation

Créer les tâches du workflow :

Utiliser TaskCreate pour chaque étape :

code
TaskCreate #1: Parser et valider arguments (branches source/cible)
TaskCreate #2: Collecter commits via git log
TaskCreate #3: Catégoriser par impact utilisateur
TaskCreate #4: Rédiger descriptions sans jargon
TaskCreate #5: Générer HTML dans .claude/reports/

Important :

  • •Utiliser activeForm (ex: "Validant les arguments", "Collectant les commits")
  • •Chaque tâche doit être marquée in_progress puis completed

Pattern d'exécution pour chaque étape :

  1. •TaskUpdate → tâche en in_progress
  2. •Exécuter l'étape
  3. •TaskUpdate → tâche en completed

Étapes

  1. •Parser et valider arguments (branches source/cible)
  2. •Collecter commits via git log
  3. •Catégoriser par impact utilisateur
  4. •Rédiger descriptions sans jargon
  5. •Générer HTML dans .claude/reports/

Catégories

CatégorieIcôneMots-clés
Nouveautés⭐feat, ✨, 🚀
Améliorations📈improve, ⚡, perf
Corrections✅fix, 🐛
Sécurité🔒security

Commits ignorés

  • •refactor:, test:, chore:, ci:, docs:, style:
  • •Commits de merge
  • •Mises à jour de dépendances

Règles de rédaction

  1. •ZÉRO jargon - Pas de API, SQL, cache, endpoint, refactoring
  2. •Bénéfice utilisateur - "L'application est plus rapide" vs "Optimisation SQL"
  3. •Verbes d'action - Vous pouvez maintenant..., Nous avons corrigé...
  4. •Phrases courtes - Max 1-2 phrases par item

Exemples

CommitNote utilisateur
feat: implémenter cache RedisL'affichage est plus rapide
fix: corriger validation emailCertaines adresses email sont maintenant acceptées

Output

{REPORT_PATH}/release_notes_{RELEASE_NAME}.html

Task Management

Progression du workflow :

  • •5 tâches créées à l'initialisation
  • •Chaque étape suit le pattern : in_progress → exécution → completed
  • •Utiliser TaskList pour voir la progression
  • •Les tâches permettent à l'utilisateur de suivre la génération des release notes

References