Skills: Veröffentlichung und Team-Sharing
Ein entwickelter Skill muss Paketierung, Tests und Dokumentation durchlaufen, bevor er an Teammitglieder verteilt oder öffentlich veröffentlicht werden kann.
Dieser Artikel stellt den vollständigen Prozess von der Fertigstellung der Entwicklung bis zur Veröffentlichung vor.
Checkliste vor der Veröffentlichung
Bestätigen Sie jeden Punkt vor der Veröffentlichung, um die Verteilung unvollständiger oder fehlerhafter Skills zu vermeiden.
| Prüfpunkt | Inhalt prüfen | Referenzabschnitt |
|---|---|---|
| Vollständige Funktionalität | Alle geplanten Funktionen sind implementiert und getestet | Artikel 22 |
| Fehlerbehandlung | Häufige Fehlerszenarien haben Handhabung und Eingabeaufforderungen | Artikel 16 |
| Genaue Beschreibung | Bestehensquote des Trigger-Tests ≥ 85% | Artikel 24 |
| Abhängigkeiten deklariert | requirements.txt oder Kompatibilitätsfeld ist vollständig | Artikel 20 |
| Keine hartcodierten Geheimnisse | Keine sensiblen Informationen wie API-Schlüssel oder Passwörter in Skripten | Artikel 28 |
| Versionsnummer aktualisiert | Das Versionsfeld in SKILL.md wurde aktualisiert | Artikel 21 |
| CHANGELOG aktualisiert | Diese Änderung wurde aufgezeichnet | Artikel 21 |
| Debugging-Code entfernt | Keine temporären Print-Anweisungen, Debug-Checkpoints oder TODOs | Artikel 23 |
Verpackung als .skill-Datei
Vor der Veröffentlichung das Skill-Verzeichnis in eine.skillDatei packen, die das standardmäßige verteilbare Format ist.
Beispiel
# Grundlegender Verpackungsbefehl
python -m scripts.package_skill my-skill/
# Ausgabepfad und Versionsnummer angeben
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# Nach dem Verpacken überprüfen, ob die Datei vollständig ist (Dateien im Paket auflisten)
python -m scripts.package_skill --list dist/my-skill-v1.2.0.skill
python -m scripts.package_skill my-skill/
# Ausgabepfad und Versionsnummer angeben
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# Nach dem Verpacken überprüfen, ob die Datei vollständig ist (Dateien im Paket auflisten)
python -m scripts.package_skill --list dist/my-skill-v1.2.0.skill
打包完成：dist/my-skill-v1.2.0.skill（共 8 个文件，42KB） 包含： SKILL.md scripts/process.py scripts/requirements.txt assets/template.xlsx
Benutzerdokumentation schreiben
Vollständige Benutzeranweisungen am Ende von SKILL.md oder in einer separaten README.md bereitstellen.
# 数据分析助手 v1.2.0 ## 这个 Skill 能做什么 上传 CSV oder Excel 文件后，自动完成以下工作： - 统计各列的行数、均值、最大/最小值、空值比例 - 生成数据质量报告，标注需要清理的问题列 - 输出带统计图表的 Excel 报告文件 ## 快速开始 1. 在对话中上传你的数据文件（.csv oder .xlsx） 2. 说："帮我分析这份数据" oder "生成统计报告" 3. 等待分析完成，下载生成的 Excel 报告 ## 系统要求 - Python 3.8+ - pandas >= 2.0（首次运行时自动安装） ## 常见问题 **Q：文件太大怎么办？** 建议文件不超过 50MB。更大的文件请先筛选或抽样后上传。 **Q：支持哪些编码？** 支持 UTF-8 和 GBK。若文件乱码，请另存为 UTF-8 后重新上传。
Verteilungskanäle
| Kanal | Geeignete Szenarien | Vorgehensweise |
|---|---|---|
| Direkte Dateiübertragung | Interne Weitergabe innerhalb eines kleinen Teams | Die .skill-Datei senden, der Empfänger lädt sie bei Claude hoch |
| Git-Repository | Teamzusammenarbeit, erfordert Versionsverwaltung | In privates/öffentliches Repository committen, aus dist/ herunterladen |
| GitHub Releases | Formelle Veröffentlichung, öffentliche Weitergabe | Ein Release erstellen, die .skill-Datei anhängen |
| Interne CI/CD | Automatisierte Verteilung innerhalb eines Unternehmens | CI paketiert und pusht auf einen internen Dateiserver |
Veröffentlichung über GitHub Releases
Beispiel
# Git-Tag erstellen und pushen
git tag v1.2.0 -m "Release v1.2.0: Diagrammgenerierungsfunktion hinzugefügt"
git push origin v1.2.0
# Ein Release mit GitHub CLI erstellen und die .skill-Datei anhängen
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "Mein Skill v1.2.0" \
--notes "Diagrammgenerierungsfunktion hinzugefügt, Speicherproblem bei der Verarbeitung großer Dateien behoben"
git tag v1.2.0 -m "Release v1.2.0: Diagrammgenerierungsfunktion hinzugefügt"
git push origin v1.2.0
# Ein Release mit GitHub CLI erstellen und die .skill-Datei anhängen
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "Mein Skill v1.2.0" \
--notes "Diagrammgenerierungsfunktion hinzugefügt, Speicherproblem bei der Verarbeitung großer Dateien behoben"
Vorlage für Installationsanleitungsseite
Wenn dein Skill für mehrere Benutzer gedacht ist, kannst du eine kurze Anleitung für die Installationsschritte schreiben.
## 安装方法 1. 前往 [Release 页面](https://github.com/yourname/skills/releases/latest) 2. 下载 `my-skill-v1.2.0.skill` 文件 3. 打开 Claude.ai → Settings（设置）→ Skills 4. 点击"上传 Skill"，选择下载的 .skill 文件 5. 安装完成后，开始新对话即可使用 安装后，在对话中发送以下内容可以验证安装成功： > "我上传了一个 CSV 文件，请帮我做数据统计分析" 若 Skill 正常工作，Claude 会按照 Skill 的流程引导你完成分析。Andere Erweiterungen