Publication et partage en équipe des compétences
Une compétence développée doit passer par l'empaquetage, les tests et la documentation avant de pouvoir être distribuée aux membres de l'équipe ou publiée publiquement.
Cet article présente le processus complet, de l'achèvement du développement à la publication.
Liste de contrôle avant publication
Confirmez chaque élément avant la publication pour éviter de distribuer des compétences incomplètes ou défectueuses.
| Élément à vérifier | Vérification du contenu | Section de référence |
|---|---|---|
| Fonctionnalités complètes | Toutes les fonctionnalités prévues sont implémentées et testées | Article 22 |
| Gestion des erreurs | Les scénarios d'erreur courants disposent d'une gestion et d'invites. | Article 16 |
| Description précise | Taux de réussite des tests de déclenchement ≥ 85% | Article 24 |
| Dépendances déclarées | requirements.txt ou le champ de compatibilité est complet | Article 20 |
| Aucun secret en dur | Aucune information sensible telle que des clés API ou des mots de passe dans les scripts | Article 28 |
| Numéro de version mis à jour | Le champ version dans SKILL.md a été mis à jour | Article 21 |
| CHANGELOG mis à jour | Ce changement a été enregistré | Article 21 |
| Code de débogage supprimé | Aucune instruction print temporaire, aucun point de contrôle de débogage, ni TODO | Article 23 |
Empaquetage en tant que fichier .skill
Avant la publication, empaquetez le répertoire Skill dans un fichier.skill, qui est le format distribuable standard.
Exemple
# Commande d'empaquetage de base
python -m scripts.package_skill my-skill/
# Spécifier le chemin de sortie et le numéro de version
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# Après l'empaquetage, vérifiez que le fichier est complet (listez les fichiers dans le paquet)
python -m scripts.package_skill --list dist/my-skill-v1.2.0.skill
python -m scripts.package_skill my-skill/
# Spécifier le chemin de sortie et le numéro de version
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# Après l'empaquetage, vérifiez que le fichier est complet (listez les fichiers dans le paquet)
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
Rédaction de la documentation utilisateur
Fournissez des instructions utilisateur complètes à la fin de SKILL.md ou dans un README.md séparé.
# 数据分析助手 v1.2.0 ## 这个 Skill 能做什么 上传 CSV ou Excel 文件后，自动完成以下工作： - 统计各列的行数、均值、最大/最小值、空值比例 - 生成数据质量报告，标注需要清理的问题列 - 输出带统计图表的 Excel 报告文件 ## 快速开始 1. 在对话中上传你的数据文件（.csv ou .xlsx） 2. 说："帮我分析这份数据" ou "生成统计报告" 3. 等待分析完成，下载生成的 Excel 报告 ## 系统要求 - Python 3.8+ - pandas >= 2.0（首次运行时自动安装） ## 常见问题 **Q：文件太大怎么办？** 建议文件不超过 50MB。更大的文件请先筛选或抽样后上传。 **Q：支持哪些编码？** 支持 UTF-8 和 GBK。若文件乱码，请另存为 UTF-8 后重新上传。
Canaux de distribution
| Canal | Scénarios applicables | Mode opératoire |
|---|---|---|
| Transfert direct de fichier | Partage interne au sein d'une petite équipe | Envoyez le fichier .skill, le destinataire le téléverse dans Claude |
| Dépôt Git | Collaboration d'équipe, nécessite une gestion de versions | Commit vers un dépôt privé/public, télécharger depuis dist/ |
| GitHub Releases | Publication officielle, partage public | Créez une Release, joignez le fichier .skill |
| CI/CD interne | Distribution automatisée au sein d'une entreprise | La CI empaquette et pousse vers le serveur de fichiers interne |
Publication via GitHub Releases
Exemple
# Créer un tag Git et pousser
git tag v1.2.0 -m "Version v1.2.0 : Ajout de la fonctionnalité de génération de graphiques"
git push origin v1.2.0
# Créer une Release avec GitHub CLI et joindre le fichier .skill
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "My Skill v1.2.0" \
--notes "Ajout de la fonctionnalité de génération de graphiques, correction d'un problème de mémoire dans le traitement de fichiers volumineux"
git tag v1.2.0 -m "Version v1.2.0 : Ajout de la fonctionnalité de génération de graphiques"
git push origin v1.2.0
# Créer une Release avec GitHub CLI et joindre le fichier .skill
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "My Skill v1.2.0" \
--notes "Ajout de la fonctionnalité de génération de graphiques, correction d'un problème de mémoire dans le traitement de fichiers volumineux"
Modèle de page de guide d'installation
Si votre Skill est destiné à plusieurs utilisateurs, vous pouvez rédiger un guide concis pour les étapes d'installation.
## 安装方法 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 的流程引导你完成分析。Autres extensions