Публикация навыков и обмен в команде
Разработанный навык должен пройти упаковку, тестирование и документирование, прежде чем его можно будет распространить среди членов команды или публично выпустить.
В этой статье описан полный процесс от завершения разработки до выпуска.
Контрольный список перед выпуском
Проверьте каждый пункт перед выпуском, чтобы не распространять неполные или дефектные навыки.
| Пункт проверки | Проверить содержимое | Справочный раздел |
|---|---|---|
| Полная функциональность | Все запланированные функции реализованы и протестированы | Статья 22 |
| Обработка ошибок | Для типовых сценариев ошибок предусмотрены обработка и подсказки | Статья 16 |
| Точное описание | Процент прохождения теста триггеров ≥ 85% | Статья 24 |
| Зависимости объявлены | requirements.txt или поле совместимости заполнено | Статья 20 |
| Нет жёстко заданных секретов | В скриптах нет конфиденциальной информации, такой как ключи API или пароли | Статья 28 |
| Номер версии обновлён | Поле version в SKILL.md обновлено | Статья 21 |
| CHANGELOG обновлён | Это изменение зафиксировано | Статья 21 |
| Отладочный код удалён | Никаких временных операторов print, отладочных контрольных точек или TODO | Статья 23 |
Упаковка в виде файла .skill
Перед выпуском упакуйте каталог Skill в файл.skill, который является стандартным форматом для распространения.
Пример
# Команда базовой упаковки
python -m scripts.package_skill my-skill/
# Укажите выходной путь и номер версии
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# После упаковки проверьте целостность файла (вывести список файлов в пакете)
python -m scripts.package_skill --list dist/my-skill-v1.2.0.skill
python -m scripts.package_skill my-skill/
# Укажите выходной путь и номер версии
python -m scripts.package_skill my-skill/ \
--output dist/my-skill-v1.2.0.skill \
--version 1.2.0
# После упаковки проверьте целостность файла (вывести список файлов в пакете)
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
Написание документации для пользователей
Приведите полные инструкции для пользователя в конце SKILL.md или в отдельном README.md.
# 数据分析助手 v1.2.0 ## 这个 Skill 能做什么 上传 CSV или Excel 文件后，自动完成以下工作： - 统计各列的行数、均值、最大/最小值、空值比例 - 生成数据质量报告，标注需要清理的问题列 - 输出带统计图表的 Excel 报告文件 ## 快速开始 1. 在对话中上传你的数据文件（.csv или .xlsx） 2. 说："帮我分析这份数据" или "生成统计报告" 3. 等待分析完成，下载生成的 Excel 报告 ## 系统要求 - Python 3.8+ - pandas >= 2.0（首次运行时自动安装） ## 常见问题 **Q：文件太大怎么办？** 建议文件不超过 50MB。更大的文件请先筛选或抽样后上传。 **Q：支持哪些编码？** 支持 UTF-8 和 GBK。若文件乱码，请另存为 UTF-8 后重新上传。
Каналы распространения
| Канал | Применимые сценарии | Способ выполнения |
|---|---|---|
| Прямая передача файла | Внутренний обмен в небольшой команде | Отправьте файл .skill, получатель загружает его в Claude |
| Репозиторий Git | Командная работа, требуется управление версиями | Коммит в приватный/публичный репозиторий, скачивание из dist/ |
| Релизы GitHub | Официальный релиз, публичное распространение | Создайте Release, прикрепите файл .skill |
| Внутренний CI/CD | Автоматизированное распространение внутри предприятия | CI упаковывает и отправляет на внутренний файловый сервер |
Публикация через GitHub Releases
Пример
# Создайте тег Git и отправьте
git tag v1.2.0 -m "Релиз v1.2.0: Добавлена функция генерации диаграмм"
git push origin v1.2.0
# Создайте релиз с помощью GitHub CLI и прикрепите файл .skill
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "Мой навык v1.2.0" \
--notes "Добавлена функция генерации диаграмм, исправлена проблема с памятью при обработке больших файлов"
git tag v1.2.0 -m "Релиз v1.2.0: Добавлена функция генерации диаграмм"
git push origin v1.2.0
# Создайте релиз с помощью GitHub CLI и прикрепите файл .skill
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "Мой навык v1.2.0" \
--notes "Добавлена функция генерации диаграмм, исправлена проблема с памятью при обработке больших файлов"
Шаблон страницы руководства по установке
Если ваш навык предназначен для нескольких пользователей, вы можете написать краткое руководство по шагам установки.
## 安装方法 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 的流程引导你完成分析。Другие расширения