跳转到主要内容
Skill

发布和管理 Skill

介绍把 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(namedescription)。预检通过后点击继续
5

确认资料

第二步填写发布资料,确认后点击提交审核。字段说明见下表。
6

等待审核

提交后该版本进入审核,类型为候选版本、状态为审核中。审核链路详见下节。全部通过后自动上线,在技能市场对其他用户可见、可安装。

审核流程与状态

提交后按下列顺序自动流转,全部通过即发布上线: 安全检测 → 人工审核 → 发布上线 任一环节检测出问题,版本立即进入「待处置」状态,在我的 Skills → 版本管理页可见,需要创作者手动介入才能继续。

安全检测

安全检测按多个维度给出结果:
结果处置
通过无阻塞,自动进入下一环节。
提醒 / 可疑版本进入待处置状态,需创作者手动选择:
- 继续审核:接受当前风险提示,让 Skill 带着该风险展示,继续走人工审核直至上线。
- 修改后重新提交:调整内容后按新版本重新发布。
危险版本进入待处置状态,不能继续审核,必须修改后重新提交才能进入后续流程。
安全检测结果记录在版本的安全报告中,可在版本管理页查看。

人工审核未通过

人工审核可能发现安全检测漏掉的问题或其他不适合上线的原因。版本被驳回后,进入待处置状态,修改内容重新提交即可。

确认资料字段

字段必填说明
英文标识技能的英文标识,默认取自 SKILL.mdname,可修改。系统会自动拼上命名空间前缀(形如 @user_xxx/),完整标识形如 @user_xxx/my-skill
Skill 名称技能展示名称。
图标技能图标,可选上传。
简介默认取自 SKILL.mddescription,最多 200 字。
版本版本号,默认 0.0.1
开源协议只能选 MITApache-2.0,选择即同意相关协议。

管理 Skills

管理 Skills 入口在设置完技能市场个人名称后即出现。未设置名称时,技能市场首页只有 Skill 发布 一个入口。
进入我的 Skillshttps://www.qianwenai.com/hub/skills/manage)管理已发布的技能。

我的 Skills 列表

列表展示你发布的所有 Skill,支持搜索和按最热/最新排序,每行字段:
说明
技能技能名称和英文标识。
版本概况该技能的版本总数和已上线数,形如「共 1 个 · 上线 0 个」。
类型技能类型。
热度综合浏览次数与安装次数得出的热度值。
操作版本管理,进入该技能的版本记录页。
页面右上角有发布 Skills按钮,可继续发布新技能。

版本管理

点击某个技能的版本管理,进入该技能的版本记录页:
  • 发布新版:上传新的 ZIP 包发布新版本,流程与首次发布一致(上传预检 → 确认资料 → 提交审核)。发布新版时 SKILL.md 中的 name 必须与当前 Skill 一致,英文标识和 Skill 名称沿用当前 Skill 不可修改。
  • 版本记录表格,每行字段:
说明
版本号形如 v0.0.1
类型候选版本、历史版本、当前线上等。
状态只有四种:待处置审核中已上线已下线,详见审核流程与状态
提交 / 上线日期未上线时显示提交日期;上线后更新为上线日期。
安全报告该版本的安全检测报告。
操作版本相关操作(审核中的版本暂无可用操作)。

状态颜色规范

版本管理页各状态使用不同颜色标识:
状态颜色
待处置红色
审核中紫色
已上线绿色
已下线灰色
我的 Skills 列表页,同一技能存在多个版本时按以下优先级展示颜色:待处置 > 审核中 > 已上线 > 已下线

下一步

  • 技能市场:技能市场首页结构、技能包、安装方式。
  • Skill 简介:Skill 是什么、自定义 Skill 的 ZIP 包规范。
  • Agent Skills:在控制台或 API 上传、挂载、管理版本。