Gestion des versions et itération des Skills

Les compétences évoluent à mesure que les exigences changent. Une bonne gestion des versions vous permet de conserver le travail existant lors des modifications et de revenir rapidement en arrière en cas d'erreur.

Conventions de numérotation des versions

Les compétences utilisent le versionnage sémantique, avec le format :MAJOR.MINOR.PATCH。

Segment de version Quand incrémenter Exemple
MAJOR Changements majeurs incompatibles (par exemple, modifications du format d'entrée) 1.0.0 → 2.0.0
MINEUR Nouvelles fonctionnalités, mais rétrocompatibles 1.0.0 → 1.1.0
PATCH Corrections de bugs, sans impact fonctionnel 1.0.0 → 1.0.1

Déclarer la version dans SKILL.md

Exemple

---
name: csv-analyzer
version: 1.2.0
description: Analyse des fichiers CSV et produit un résumé statistique.
---

Gestion des versions de Skill avec Git

Git est le meilleur outil pour gérer les versions de Skill ; chaque modification produit un historique clair.

Exemple

# Initialiser le dépôt Git
cd my-skill/
git init
git add .
git commit -m "feat: version initiale v1.0.0"

# Commiter une nouvelle version après avoir modifié le Skill
git add SKILL.md
git commit -m "fix: corriger le problème d'espace dans le traitement des chemins de fichiers"

# Étiqueter une version stable
git tag v1.0.1
git tag v1.1.0 -m "Ajouter la fonctionnalité de traitement par lots de plusieurs fichiers"

Format recommandé des messages de commit

Préfixe Signification Exemple
feat: Nouvelle fonctionnalité feat: ajouter la prise en charge de la sortie Excel
fix: Correction de bug fix: corriger le plantage sur les fichiers vides
docs: Mise à jour de la documentation docs: ajouter des descriptions de paramètres
refactor: Refactorisation du code (aucun changement fonctionnel) refactor: extraire la logique de nettoyage dans une fonction séparée
perf: Optimisation des performances perf: accélération 3x pour le traitement de fichiers volumineux

Tenir un CHANGELOG dans SKILL.md

Pour les Skills qui seront utilisés par d'autres, joindre un journal des modifications à la fin de SKILL.md aide les utilisateurs à comprendre les changements de chaque version.

## 版本历史

### v1.2.0（2026-05-18）
- 新增：支持 .xlsx 输入格式
- 优化：大文件（>10MB）处理速度提升 40%

### v1.1.0（2026-04-10）
- 新增：--col 参数，支持只分析指定列
- 修复：列名包含空格时的解析错误

### v1.0.0（2026-03-01）
- 初始版本：支持 CSV 文件的基础统计分析

Migration de version : gérer les changements incompatibles

Lorsqu'un Skill subit des changements incompatibles (par exemple, modification du format d'entrée ou suppression de fonctionnalité), vous devez fournir des indications de migration claires aux utilisateurs existants.

## 迁移指南：从 v1.x 升级到 v2.0

### 主要变化

v2.0 修改了输出文件的命名规则，由原来的 `output.xlsx` 改为带日期的 `output_YYYYMMDD.xlsx`。

### 受影响场景

如果你的工作流依赖固定的输出文件名，需要在使用时重命名文件，或使用 `--output` 参数指定文件名。

### 迁移步骤

1. 更新 Skill 到 v2.0
2. 检查是否有依赖固定文件名的脚本或工作流
3. 如有，添加 `--output output.xlsx` 参数保持旧行为

Les changements incompatibles doivent faire l'objet d'une évaluation complète de leur impact avant la publication. Si de nombreux utilisateurs sont concernés, envisagez de conserver l'ancien paramètre et de le marquer comme "deprecated" afin de laisser aux utilisateurs une période de transition, plutôt que de le supprimer purement et simplement.

Revenir à une version précédente

Exemple

# Afficher tous les commits historiques
git log --oneline

# Afficher tous les tags de version
git tag

# Revenir au tag de version spécifié
git checkout v1.1.0

# Ou revenir à un commit spécifique (via le hash du commit)
git checkout a3f7b2c

# Si vous devez poursuivre le développement à partir de la version restaurée en tant que nouvelle branche
git checkout -b hotfix/v1.1.1 v1.1.0
Autres extensions