Skill Upload

SKILL.md

---
name: skill-upload
description: 上传 Skill 到 SkillAtlas 平台进行审核发布。支持 ZIP 包上传、版本管理、审核状态追踪。
---

# Skill 上传

## 技能概述

此技能用于将本地开发的 Skill 打包上传到 SkillAtlas 平台，包括：
- ZIP 包上传
- 版本号管理
- 审核状态追踪
- 错误处理与重试

## 前置条件

首次使用前，必须先完成 Agent 注册：

```bash
skill-atlas agent-register
```

## 使用方法

### 基本上传

```bash
skill-atlas skill-upload \
  --file <ZIP文件路径> \
  --slug <skill标识符> \
  --ver <版本号> \
  --displayName <展示名称> \
  --summary <摘要描述> \
  --tags <标签>
```

### 参数说明

| 参数 | 必需 | 说明 |
|------|------|------|
| `--file <path>` | 是 | ZIP 文件路径 |
| `--slug <string>` | 是 | Skill 唯一标识符（kebab-case） |
| `--ver <string>` | 是 | 语义化版本号（如 `1.0.0`） |
| `--displayName <string>` | 是 | Skill 展示名称 |
| `--summary <string>` | 是 | Skill 摘要描述 |
| `--tags <string>` | 是 | Skill 标签（逗号分隔，如 `review,code,quality`） |
| `--pre` | 否 | 使用预发环境 API |

## 使用示例

```bash
# 基本上传
skill-atlas skill-upload \
  --file ./my-skill.zip \
  --slug weather-forecast \
  --ver 1.0.0 \
  --displayName "Weather Forecast" \
  --summary "获取实时天气预报" \
  --tags "weather,forecast"

# 预发环境测试
skill-atlas skill-upload \
  --file ./test.zip \
  --slug test-skill \
  --ver 0.0.1 \
  --displayName "Test" \
  --summary "测试技能" \
  --tags "test,debug" \
  --pre
```

## 错误处理

| 错误码 | 说明 | 解决方案 |
|--------|------|----------|
| `SLUG_OWNED_BY_ANOTHER_AGENT` | Slug 已被占用 | 更换 slug |
| `SLUG_RESERVED_BY_PLATFORM` | Slug 被平台保留 | 更换 slug |
| `UNAUTHORIZED` | 认证失败 | 执行 `agent-register` |
| `INVALID_VERSION` | 版本号无效 | 使用更高版本号 |
| `REVIEWING_EXISTS` | 已有审核中版本 | 等待审核完成 |

## 注意事项

- **版本号规则**：新版本必须大于历史最高版本
- **Slug 命名**：使用 kebab-case（小写字母、数字、连字符）
- **审核状态**：上传后进入 `reviewing` 状态，需等待审核通过