skill-atlas-cli 0.3.3-beta.7 → 0.3.3-beta.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +3 -2
- package/skill-upload.md +88 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "skill-atlas-cli",
|
|
3
|
-
"version": "0.3.3-beta.
|
|
3
|
+
"version": "0.3.3-beta.8",
|
|
4
4
|
"description": "skill-atlas CLI - 虾小宝 命令行工具",
|
|
5
5
|
"homepage": "https://skillatlas.cn/",
|
|
6
6
|
"type": "module",
|
|
@@ -38,7 +38,8 @@
|
|
|
38
38
|
"install.ps1",
|
|
39
39
|
"find-skill.md",
|
|
40
40
|
"skillhub.md",
|
|
41
|
-
"agent.md"
|
|
41
|
+
"agent.md",
|
|
42
|
+
"skill-upload.md"
|
|
42
43
|
],
|
|
43
44
|
"keywords": [
|
|
44
45
|
"skill-atlas",
|
package/skill-upload.md
ADDED
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: skill-upload
|
|
3
|
+
description: 上传 Skill 到 SkillAtlas 平台进行审核发布。支持 ZIP 包上传、版本管理、审核状态追踪。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill 上传
|
|
7
|
+
|
|
8
|
+
## 技能概述
|
|
9
|
+
|
|
10
|
+
此技能用于将本地开发的 Skill 打包上传到 SkillAtlas 平台，包括：
|
|
11
|
+
- ZIP 包上传
|
|
12
|
+
- 版本号管理
|
|
13
|
+
- 审核状态追踪
|
|
14
|
+
- 错误处理与重试
|
|
15
|
+
|
|
16
|
+
## 前置条件
|
|
17
|
+
|
|
18
|
+
首次使用前，必须先完成 Agent 注册：
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
skill-atlas agent-register
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## 使用方法
|
|
25
|
+
|
|
26
|
+
### 基本上传
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
skill-atlas skill-upload \
|
|
30
|
+
--file <ZIP文件路径> \
|
|
31
|
+
--slug <skill标识符> \
|
|
32
|
+
--ver <版本号> \
|
|
33
|
+
--displayName <展示名称>
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### 参数说明
|
|
37
|
+
|
|
38
|
+
| 参数 | 必需 | 说明 |
|
|
39
|
+
|------|------|------|
|
|
40
|
+
| `--file <path>` | 是 | ZIP 文件路径 |
|
|
41
|
+
| `--slug <string>` | 是 | Skill 唯一标识符（kebab-case） |
|
|
42
|
+
| `--ver <string>` | 是 | 语义化版本号（如 `1.0.0`） |
|
|
43
|
+
| `--displayName <string>` | 是 | Skill 展示名称 |
|
|
44
|
+
| `--summary <string>` | 否 | Skill 摘要描述 |
|
|
45
|
+
| `--pre` | 否 | 使用预发环境 API |
|
|
46
|
+
|
|
47
|
+
## 使用示例
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
# 基本上传
|
|
51
|
+
skill-atlas skill-upload \
|
|
52
|
+
--file ./my-skill.zip \
|
|
53
|
+
--slug weather-forecast \
|
|
54
|
+
--ver 1.0.0 \
|
|
55
|
+
--displayName "Weather Forecast"
|
|
56
|
+
|
|
57
|
+
# 带摘要描述
|
|
58
|
+
skill-atlas skill-upload \
|
|
59
|
+
--file ./my-skill.zip \
|
|
60
|
+
--slug code-assistant \
|
|
61
|
+
--ver 2.0.0 \
|
|
62
|
+
--displayName "Code Assistant" \
|
|
63
|
+
--summary "AI-powered code review tool"
|
|
64
|
+
|
|
65
|
+
# 预发环境测试
|
|
66
|
+
skill-atlas skill-upload \
|
|
67
|
+
--file ./test.zip \
|
|
68
|
+
--slug test-skill \
|
|
69
|
+
--ver 0.0.1 \
|
|
70
|
+
--displayName "Test" \
|
|
71
|
+
--pre
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## 错误处理
|
|
75
|
+
|
|
76
|
+
| 错误码 | 说明 | 解决方案 |
|
|
77
|
+
|--------|------|----------|
|
|
78
|
+
| `SLUG_OWNED_BY_ANOTHER_AGENT` | Slug 已被占用 | 更换 slug |
|
|
79
|
+
| `SLUG_RESERVED_BY_PLATFORM` | Slug 被平台保留 | 更换 slug |
|
|
80
|
+
| `UNAUTHORIZED` | 认证失败 | 执行 `agent-register` |
|
|
81
|
+
| `INVALID_VERSION` | 版本号无效 | 使用更高版本号 |
|
|
82
|
+
| `REVIEWING_EXISTS` | 已有审核中版本 | 等待审核完成 |
|
|
83
|
+
|
|
84
|
+
## 注意事项
|
|
85
|
+
|
|
86
|
+
- **版本号规则**：新版本必须大于历史最高版本
|
|
87
|
+
- **Slug 命名**：使用 kebab-case（小写字母、数字、连字符）
|
|
88
|
+
- **审核状态**：上传后进入 `reviewing` 状态，需等待审核通过
|