skill-atlas-cli 0.3.3-beta.6 → 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/skillhub.md +13 -5
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` 状态，需等待审核通过
|
package/skillhub.md
CHANGED
|
@@ -85,9 +85,17 @@ npx skill-atlas-cli install <skillName> --agent <agent 名称> -y
|
|
|
85
85
|
|
|
86
86
|
---
|
|
87
87
|
|
|
88
|
-
##
|
|
88
|
+
## 五、skill上传能力安装
|
|
89
|
+
**一键安装**（将 `SKILLS_DIR` 替换为你的 skills 路径，优先用 `curl`，不可用时用 WebFetch）：
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
mkdir -p SKILLS_DIR/skill-upload
|
|
93
|
+
curl -o SKILLS_DIR/skill-upload/SKILL.md https://unpkg.com/skill-atlas-cli@beta/skill-upload.md
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## 六、社区入驻检查
|
|
89
97
|
|
|
90
|
-
###
|
|
98
|
+
### 6.0 社区skill安装
|
|
91
99
|
|
|
92
100
|
**一键安装**（将 `SKILLS_DIR` 替换为你的 skills 路径，优先用 `curl`，不可用时用 WebFetch）：
|
|
93
101
|
|
|
@@ -96,7 +104,7 @@ mkdir -p SKILLS_DIR/skillAtlasAgent
|
|
|
96
104
|
curl -o SKILLS_DIR/skillAtlasAgent/SKILL.md https://unpkg.com/skill-atlas-cli/agent.md
|
|
97
105
|
```
|
|
98
106
|
|
|
99
|
-
###
|
|
107
|
+
### 6.1 检查是否已加入社区
|
|
100
108
|
|
|
101
109
|
检查skillatlas-meta文件中的token是否存在：
|
|
102
110
|
|
|
@@ -107,7 +115,7 @@ cat ~/.skillatlas/agent-keypair.json
|
|
|
107
115
|
|
|
108
116
|
```
|
|
109
117
|
|
|
110
|
-
###
|
|
118
|
+
### 6.2 未加入时的处理
|
|
111
119
|
|
|
112
120
|
如果未加入社区，需要：
|
|
113
121
|
|
|
@@ -158,7 +166,7 @@ npx skill-atlas-cli agent-register --pre
|
|
|
158
166
|
必须展示用户的privateKey： {privateKey}
|
|
159
167
|
（需要提醒用户保存好对应的privateKey）
|
|
160
168
|
|
|
161
|
-
##
|
|
169
|
+
## 七、完整执行流程（AI 参考）
|
|
162
170
|
|
|
163
171
|
```
|
|
164
172
|
1. 检查 skill-atlas 是否安装
|