Skill-Versionsverwaltung und Iteration

Skills entwickeln sich mit sich ändernden Anforderungen weiter. Eine ordnungsgemäße Versionsverwaltung ermöglicht es Ihnen, vorhandene Arbeit bei Änderungen zu erhalten und bei Fehlern schnell zurückzurollen.


Konventionen für Versionsnummern

Skills verwenden Semantic Versioning mit dem Format:MAJOR.MINOR.PATCH。

Versionssegment Wann inkrementiert werden soll Beispiel
MAJOR Inkompatible Major-Änderungen (z. B. Änderungen am Eingabeformat) 1.0.0 → 2.0.0
MINOR Neue Funktionen, aber abwärtskompatibel 1.0.0 → 1.1.0
PATCH Fehlerbehebungen, keine funktionalen Auswirkungen 1.0.0 → 1.0.1

Deklarieren der Version in SKILL.md

Beispiel

---
name
: csv-analyzer
version
: 1.2.0
description
: Analysiert CSV-Dateien und gibt eine statistische Zusammenfassung aus.
---

Verwalten von Skill-Versionen mit Git

Git ist das beste Werkzeug zum Verwalten von Skill-Versionen; jede Änderung erzeugt einen klaren Verlaufseintrag.

Beispiel

# Git-Repository initialisieren
cd my-skill/
git init
git add .
git commit -m "feat: initiale Version v1.0.0"

# Eine neue Version nach dem Ändern des Skills committen
git add SKILL.md
git commit -m "fix: Behebe das Leerzeichenproblem bei der Dateipfadverarbeitung"

# Eine stabile Version taggen
git tag v1.0.1
git tag v1.1.0 -m "Funktionalität für die Stapelverarbeitung mehrerer Dateien hinzufügen"

Empfohlenes Format für Commit-Nachrichten

Präfix Bedeutung Beispiel
feat: Neue Funktion feat: Unterstützung für Excel-Ausgabe hinzufügen
fix: Fehlerbehebung fix: Absturz bei leeren Dateien beheben
docs: Dokumentations-Update docs: Parameterbeschreibungen hinzufügen
refactor: Code-Refactoring (keine funktionale Änderung) refactor: Bereinigungslogik in eine separate Funktion auslagern
perf: Leistungsoptimierung perf: 3x Geschwindigkeitssteigerung bei der Verarbeitung großer Dateien

Ein CHANGELOG in SKILL.md pflegen

Bei Skills, die von anderen verwendet werden, hilft ein Änderungsprotokoll am Ende von SKILL.md den Nutzern, die Änderungen in jeder Version zu verstehen.

## 版本历史

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

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

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

Versionsmigration: Umgang mit Breaking Changes

Wenn ein Skill Breaking Changes erfährt (z. B. Änderungen des Eingabeformats oder Entfernen von Funktionen), müssen Sie bestehenden Nutzern eine klare Migrationsanleitung bieten.

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

### 主要变化

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

### 受影响场景

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

### 迁移步骤

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

Breaking Changes sollten vor der Veröffentlichung vollständig auf ihre Auswirkungen hin bewertet werden. Wenn viele Nutzer betroffen sind, sollten Sie erwägen, den alten Parameter beizubehalten und ihn als "deprecated" zu kennzeichnen, um Nutzern eine Übergangszeit zu geben, anstatt ihn einfach zu löschen.


Zurückrollen auf eine vorherige Version

Beispiel

# Alle historischen Commits anzeigen
git log --oneline

# Alle Versions-Tags anzeigen
git tag

# Zum angegebenen Versions-Tag zurückrollen
git checkout v1.1.0

# Oder zu einem bestimmten Commit zurückrollen (über den Commit-Hash)
git checkout a3f7b2c

# Wenn Sie die Entwicklung von der zurückgesetzten Version als neuen Branch fortsetzen müssen
git checkout -b hotfix/v1.1.1 v1.1.0
Andere Erweiterungen