cat > /mnt/user-data/outputs/2026-05-18/skills-ecosystem.html << 'HTMLEOF'
自定义 Skills 生态系统搭建
当团队积累了多个 Skill 后，如何统一组织、管理和分发，是构建"私有 Skill 生态"的核心问题。
生态系统的三个层次
| 层次 | 内容 | 目标 |
|---|---|---|
| Skill 库 | 统一管理所有 Skill 的 Git 仓库 | 版本控制、可追溯 |
| 分发机制 | .skill 打包文件的存储与分发渠道 | 让团队成员能快速安装 |
| 文档中心 | 每个 Skill 的使用说明、适用场景 | 降低学习成本 |
统一仓库结构
推荐将所有团队 Skill 放在同一个 Git 仓库中，用目录隔离不同 Skill。
bash
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 # 批量打包脚本批量打包脚本
实例
bash
#!/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。"bash
开始打包所有 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 附件。
实例
bash
# 文件路径：.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 的元信息，方便检索和按需安装。
实例
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"]
}
]
}团队 Skill 分发清单
为团队新成员准备一份 Skill 安装清单，让他们能快速配置好所有常用 Skill。
bash
# 团队 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. 安装完成后重新开始对话即可生效AI 思考中...