Skills 发布与团队共享
开发完成的 Skill 需要经过打包、测试、文档化，才能分发给团队成员或公开发布。
本篇介绍从开发完成到上线发布的完整流程。
发布前的检查清单
发布前逐项确认，避免将未完成或有缺陷的 Skill 分发出去。
| 检查项 | 检查内容 | 参考章节 |
|---|---|---|
| 功能完整 | 所有计划的功能均已实现并测试 | 第22篇 |
| 错误处理 | 常见错误场景均有处理和提示 | 第16篇 |
| Description 准确 | 触发测试通过率 ≥ 85% | 第24篇 |
| 依赖已声明 | requirements.txt 或 compatibility 字段完整 | 第20篇 |
| 无硬编码密钥 | 脚本中无 API Key、密码等敏感信息 | 第28篇 |
| 版本号已更新 | SKILL.md 中 version 字段已更新 | 第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 Releases | 正式发布，公开分享 | 创建 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 创建 Release 并附带 .skill 文件
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "My Skill v1.2.0" \
--notes "新增图表生成功能，修复大文件处理的内存问题"
git tag v1.2.0 -m "发布 v1.2.0：新增图表生成功能"
git push origin v1.2.0
# 用 GitHub CLI 创建 Release 并附带 .skill 文件
gh release create v1.2.0 \
dist/my-skill-v1.2.0.skill \
--title "My Skill v1.2.0" \
--notes "新增图表生成功能，修复大文件处理的内存问题"
安装指引页面模板
如果你的 Skill 面向多人使用，可以为安装步骤专门写一份简明指引。
## 安装方法 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 的流程引导你完成分析。