cat > /mnt/user-data/outputs/2026-05-18/skills-ecosystem.html << 'HTMLEOF'

Настройка экосистемы пользовательских Skills

После того как команда накопила несколько Skills, ключевой задачей при построении «приватной экосистемы Skill» становится их единообразная организация, управление и распространение.

Три уровня экосистемы

УровеньСодержаниеЦель
Библиотека навыковGit-репозиторий, централизованно управляющий всеми навыкамиКонтроль версий, прослеживаемость
Механизм распространенияКанал хранения и распространения файлов пакетов .skillПозволяет участникам команды быстро устанавливать
Центр документацииИнструкции по использованию и сценарии применения для каждого навыкаСнижает затраты на обучение

Единая структура репозитория

Рекомендуется размещать все навыки команды в одном Git-репозитории, используя каталоги для разделения разных навыков.

skills-repo/
├── README.md                  # 仓库总览，列出所有 Skill
├── .github/
│   └── workflows/
│       └── package.yml        # CI：自动打包 .skill 文件
├── skills/
│   ├── data-analyzer/         # Skill 1
│   │   ├── SKILL.md
│   │   └── scripts/
│   ├── doc-generator/         # Skill 2
│   │   ├── SKILL.md
│   │   └── scripts/
│   └── code-reviewer/         # Skill 3
│       ├── SKILL.md
│       └── scripts/
├── dist/                      # 打包好的 .skill 文件
│   ├── data-analyzer.skill
│   ├── doc-generator.skill
│   └── code-reviewer.skill
└── tools/
    └── build_all.sh           # 批量打包脚本

Скрипт пакетной упаковки

Пример

#!/bin/bash
# Путь к файлу: tools/build_all.sh
# Упаковать все Skills в .skill-файлы, вывод в каталог dist/

set -e  # Немедленно выйти при ошибке

SKILLS_DIR="skills"
DIST_DIR="dist"
mkdir -p "$DIST_DIR"

echo "Начало упаковки всех Skills..."

for skill_dir in "$SKILLS_DIR"/*/; do
    skill_name=$(basename "$skill_dir")
    echo " Упаковка:$skill_name"

    python -m scripts.package_skill "$skill_dir" \
      --output "$DIST_DIR/${skill_name}.skill"

    echo " Завершено:$DIST_DIR/${skill_name}.skill"
done

echo ""
echo "Упаковка полностью завершена, всего$(ls $DIST_DIR/*.skill | wc -l)навыков."
开始打包所有 Skill...
  正在打包：data-analyzer
  完成：dist/data-analyzer.skill
  正在打包：doc-generator
  完成：dist/doc-generator.skill
  正在打包：code-reviewer
  完成：dist/code-reviewer.skill

全部打包完成，共 3 个 Skill.

Автоматизированная упаковка в GitHub Actions

При каждом коммите кода в ветку main автоматически упаковывайте все навыки и публикуйте их как вложения к релизу.

Пример

# Путь к файлу: .github/workflows/package.yml
name: Упаковка и публикация навыков

на:
  push:
    branches: [main]      # Запускается при отправке в ветку main
  освободить:
    types: [created]       # Также запускается при создании релиза

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Получение кода
        uses: actions/checkout@v4

      - name: Установка Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - name: Установка зависимостей инструмента упаковки
        run: pip install -r tools/requirements.txt

      - name: Пакетная упаковка навыков
        run: bash tools/build_all.sh

      - name: Загрузить файлы .skill как артефакты сборки
        uses: actions/upload-artifact@v4
        with:
          name: skill-packages
          path: dist/*.skill
          retention-days: 30   # Хранить в течение 30 дней

Реестр навыков

Когда количество навыков увеличивается, используйте JSON-реестр для управления метаданными всех навыков, чтобы было легко искать и устанавливать по требованию.

Пример

{
  "registry_version": "1.0",
  "updated_at": "2026-05-18",
  "skills": [
    {
      "name":        "data-analyzer",
      "version":     "1.2.0",
      "description": "Анализ данных Excel/CSV и генерация статистических отчётов",
      "tags":        ["Данные", "Excel", "CSV", "Статистика"],
      "file":        "dist/data-analyzer.skill",
      "requires":    ["python>=3.8", "pandas>=2.0"]
    },
    {
      "name":        "doc-generator",
      "version":     "2.0.1",
      "description": "Генерация документов Word/PDF из шаблонов",
      "tags":        ["Документ", "Word", "PDF", "Шаблон"],
      "file":        "dist/doc-generator.skill",
      "requires":    ["python>=3.8", "python-docx>=1.0"]
    }
  ]
}

Чек-лист распределения навыков в команде

Подготовьте чек-лист по установке навыков для новых членов команды, чтобы они могли быстро настроить все часто используемые навыки.

# 团队 Skills 安装指南

## 必装 Skills（所有成员）

| Skill | 用途 | 下载地址 |
|-------|------|---------|
| data-analyzer | 数据分析与报表 | dist/data-analyzer.skill |
| doc-generator | 文档自动生成 | dist/doc-generator.skill |

## 按需安装

| Skill | 适合角色 | 下载地址 |
|-------|---------|---------|
| code-reviewer | 开发人员 | dist/code-reviewer.skill |

## 安装方式
1. 下载 .skill 文件
2. 在 Claude.ai 的 Settings → Skills 中上传文件
3. 安装完成后重新开始对话即可生效
Другие расширения