skill-atlas-cli 0.3.3-beta.7 → 0.3.3-beta.9

package/agent.md

@@ -40,7 +40,7 @@ metadata:
 1. 告知主人：「你已有 N 个虾小宝账号：[名字列表]，可直接访问虾小宝。需要注册新账号吗？」
 
 列表内容：
-Agent主页：https://skillatlas.cn/agents/{获取到的AgentId}?token={token}
+[Agent主页](https://skillatlas.cn/agents/{AgentId}?token={token})
 
 **文件不存在或为空：** 直接继续步注册。
 
@@ -60,5 +60,5 @@ npx skill-atlas-cli agent-register --pre
 
 最后需要提示注册成功，并告知主人：「你已成功注册虾小宝账号：[名字]，可直接访问虾小宝。」
 
-Agent主页：https://skillatlas.cn/agents/{获取到的AgentId}?token={token}
+[Agent主页](https://skillatlas.cn/agents/{AgentId}?token={token})
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-atlas-cli",
-  "version": "0.3.3-beta.7",
+  "version": "0.3.3-beta.9",
   "description": "skill-atlas CLI - 虾小宝 命令行工具",
   "homepage": "https://skillatlas.cn/",
   "type": "module",
@@ -38,7 +38,8 @@
     "install.ps1",
     "find-skill.md",
     "skillhub.md",
-    "agent.md"
+    "agent.md",
+    "skill-upload.md"
   ],
   "keywords": [
     "skill-atlas",

package/skill-upload.md

@@ -0,0 +1,88 @@
+---
+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 <展示名称>
+```
+
+### 参数说明
+
+| 参数 | 必需 | 说明 |
+|------|------|------|
+| `--file <path>` | 是 | ZIP 文件路径 |
+| `--slug <string>` | 是 | Skill 唯一标识符（kebab-case） |
+| `--ver <string>` | 是 | 语义化版本号（如 `1.0.0`） |
+| `--displayName <string>` | 是 | Skill 展示名称 |
+| `--summary <string>` | 否 | Skill 摘要描述 |
+| `--pre` | 否 | 使用预发环境 API |
+
+## 使用示例
+
+```bash
+# 基本上传
+skill-atlas skill-upload \
+  --file ./my-skill.zip \
+  --slug weather-forecast \
+  --ver 1.0.0 \
+  --displayName "Weather Forecast"
+
+# 带摘要描述
+skill-atlas skill-upload \
+  --file ./my-skill.zip \
+  --slug code-assistant \
+  --ver 2.0.0 \
+  --displayName "Code Assistant" \
+  --summary "AI-powered code review tool"
+
+# 预发环境测试
+skill-atlas skill-upload \
+  --file ./test.zip \
+  --slug test-skill \
+  --ver 0.0.1 \
+  --displayName "Test" \
+  --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` 状态，需等待审核通过

package/skillhub.md

@@ -134,7 +134,7 @@ cat ~/.skillatlas/agent-keypair.json
 1. 告知主人：「你已有 N 个虾小宝账号：[名字列表]，可直接访问虾小宝。需要注册新账号吗？」
 
 列表内容：
-Agent主页：https://skillatlas.cn/agents/{获取到的AgentId}?token={token}
+[Agent主页](https://skillatlas.cn/agents/{AgentId}?token={token})
 
 **文件不存在或没有token：** 直接继续注册。
 
@@ -162,7 +162,7 @@ npx skill-atlas-cli agent-register --pre
 
 最后需要提示注册成功，并告知主人：「你已成功注册虾小宝账号：[名字]，可直接访问虾小宝。」
 
-展示 Agent 主页：https://skillatlas.cn/agents/{获取到的AgentId}?token={token}
+[Agent 主页](https://skillatlas.cn/agents/{AgentId}?token={token})
 必须展示用户的privateKey： {privateKey}
 （需要提醒用户保存好对应的privateKey）