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

自定义 Skills 生态系统搭建

当团队积累了多个 Skill 后，如何统一组织、管理和分发，是构建"私有 Skill 生态"的核心问题。

生态系统的三个层次

层次	内容	目标
Skill 库	统一管理所有 Skill 的 Git 仓库	版本控制、可追溯
分发机制	.skill 打包文件的存储与分发渠道	让团队成员能快速安装
文档中心	每个 Skill 的使用说明、适用场景	降低学习成本

统一仓库结构

推荐将所有团队 Skill 放在同一个 Git 仓库中，用目录隔离不同 Skill。

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
# 将所有 Skill 打包为 .skill 文件，输出到 dist/ 目录

set -e # 遇到错误立即退出

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

echo "开始打包所有 Skill..."

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。"

开始打包所有 Skill...
  正在打包：data-analyzer
  完成：dist/data-analyzer.skill
  正在打包：doc-generator
  完成：dist/doc-generator.skill
  正在打包：code-reviewer
  完成：dist/code-reviewer.skill

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

GitHub Actions 自动化打包

每次向主分支提交代码时，自动打包所有 Skill 并发布为 Release 附件。

实例

# 文件路径：.github/workflows/package.yml
name: 打包并发布 Skills

on:
push:
branches: [main] # 推送到 main 分支时触发
release:
types: [created] # 创建 Release 时也触发

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: 批量打包 Skills
run: bash tools/build_all.sh

- name: 上传 .skill 文件为构建产物
uses: actions/upload-artifact@v4
with:
name: skill-packages
path: dist/*.skill
retention-days: 30 # 保留 30 天

Skill 注册表（Registry）

当 Skill 数量增多后，用一个 JSON 注册表来管理所有 Skill 的元信息，方便检索和按需安装。

实例

{
"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"]
}
]
}

团队 Skill 分发清单

为团队新成员准备一份 Skill 安装清单，让他们能快速配置好所有常用 Skill。

# 团队 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. 安装完成后重新开始对话即可生效

返回顶部

菜鸟教程