介绍把 Skill 发布到千问AI平台技能市场的完整流程,以及发布后的版本管理。
技能市场社区
技能市场是开放的 Skill 共享社区,所有用户都可以发布自己开发的 Skill,供其他人在 Qoder、Claude Code 等支持 Skill 的 Agent 里安装使用。
发布到技能市场和上传到控制台是两条路:
- 发布到技能市场(本页):面向所有用户,分版本管理,受开源协议约束。
- 上传到控制台(自定义 Skill):只挂给你自己的智能体,不进社区,不涉及协议。
发布流程
在技能市场首页点击 Skill 发布 按钮,进入发布流程。
1
登录千问AI平台
未登录时点击 Skill 发布 会先跳转登录组件,登录后自动回到发布入口。
2
设置技能市场个人名称(首次)
首次发布需先设置技能市场个人名称,这是你在技能市场的公开展示名。阅读并同意《千问AI平台技能市场服务协议》后点击保存并继续发布。设置完成后技能市场首页会同时出现 Skill 发布 与 管理 Skills 两个入口。
3
完成实名认证
设置个人名称后,若账号未完成实名认证,页面会跳转实名认证组件,需完成个人认证或企业认证后才能继续上传。
4
上传预检
在发布 Skill页面第一步,选择或拖入单个 ZIP 技能包。系统会做上传预检,校验 ZIP 包内的
SKILL.md 是否包含合法的 frontmatter(name 和 description)。预检通过后点击继续。5
确认资料
第二步填写发布资料,确认后点击提交审核。字段说明见下表。
6
等待审核
提交后该版本进入审核,类型为候选版本、状态为审核中。审核链路详见下节。全部通过后自动上线,在技能市场对其他用户可见、可安装。
审核流程与状态
提交后按下列顺序自动流转,全部通过即发布上线:
安全检测 → 人工审核 → 发布上线
任一环节检测出问题,版本立即进入「待处置」状态,在我的 Skills → 版本管理页可见,需要创作者手动介入才能继续。
安全检测
安全检测按多个维度给出结果:
| 结果 | 处置 |
|---|---|
| 通过 | 无阻塞,自动进入下一环节。 |
| 提醒 / 可疑 | 版本进入待处置状态,需创作者手动选择: - 继续审核:接受当前风险提示,让 Skill 带着该风险展示,继续走人工审核直至上线。 - 修改后重新提交:调整内容后按新版本重新发布。 |
| 危险 | 版本进入待处置状态,不能继续审核,必须修改后重新提交才能进入后续流程。 |
人工审核未通过
人工审核可能发现安全检测漏掉的问题或其他不适合上线的原因。版本被驳回后,进入待处置状态,修改内容重新提交即可。
确认资料字段
| 字段 | 必填 | 说明 |
|---|---|---|
| 英文标识 | 是 | 技能的英文标识,默认取自 SKILL.md 的 name,可修改。系统会自动拼上命名空间前缀(形如 @user_xxx/),完整标识形如 @user_xxx/my-skill。 |
| Skill 名称 | 是 | 技能展示名称。 |
| 图标 | 否 | 技能图标,可选上传。 |
| 简介 | 是 | 默认取自 SKILL.md 的 description,最多 200 字。 |
| 版本 | 是 | 版本号,默认 0.0.1。 |
| 开源协议 | 是 | 只能选 MIT 或 Apache-2.0,选择即同意相关协议。 |
管理 Skills
管理 Skills 入口在设置完技能市场个人名称后即出现。未设置名称时,技能市场首页只有 Skill 发布 一个入口。
https://www.qianwenai.com/hub/skills/manage)管理已发布的技能。
我的 Skills 列表
列表展示你发布的所有 Skill,支持搜索和按最热/最新排序,每行字段:
| 列 | 说明 |
|---|---|
| 技能 | 技能名称和英文标识。 |
| 版本概况 | 该技能的版本总数和已上线数,形如「共 1 个 · 上线 0 个」。 |
| 类型 | 技能类型。 |
| 热度 | 综合浏览次数与安装次数得出的热度值。 |
| 操作 | 版本管理,进入该技能的版本记录页。 |
版本管理
点击某个技能的版本管理,进入该技能的版本记录页:
- 发布新版:上传新的 ZIP 包发布新版本,流程与首次发布一致(上传预检 → 确认资料 → 提交审核)。发布新版时
SKILL.md中的name必须与当前 Skill 一致,英文标识和 Skill 名称沿用当前 Skill 不可修改。 - 版本记录表格,每行字段:
| 列 | 说明 |
|---|---|
| 版本号 | 形如 v0.0.1。 |
| 类型 | 候选版本、历史版本、当前线上等。 |
| 状态 | 只有四种:待处置、审核中、已上线、已下线,详见审核流程与状态。 |
| 提交 / 上线日期 | 未上线时显示提交日期;上线后更新为上线日期。 |
| 安全报告 | 该版本的安全检测报告。 |
| 操作 | 版本相关操作(审核中的版本暂无可用操作)。 |
状态颜色规范
版本管理页各状态使用不同颜色标识:
| 状态 | 颜色 |
|---|---|
| 待处置 | 红色 |
| 审核中 | 紫色 |
| 已上线 | 绿色 |
| 已下线 | 灰色 |
下一步
- 技能市场:技能市场首页结构、技能包、安装方式。
- Skill 简介:Skill 是什么、自定义 Skill 的 ZIP 包规范。
- Agent Skills:在控制台或 API 上传、挂载、管理版本。