Skill 是可挂载到智能体的能力包,让智能体在会话中自动处理特定类型的任务。挂载 Skill 后,智能体无需额外编码即可获得文件处理、数据分析等专业能力。
什么是 Skill
Skill 是一个 ZIP 技能包,包内根目录的 SKILL.md 用自然语言声明这个技能能做什么、什么时候该用它。挂载到智能体后,智能体在会话中识别到匹配的任务就会自动调用,不需要额外写代码或对接外部工具。
Skill 和 MCP 解决的是不同的问题:MCP 提供的是工具接口,由智能体按参数调用;Skill 提供的是做事的方法,包里可以带提示词、脚本和参考资料,智能体按包里的说明完成整套流程。
千问AI平台提供两类 Skill:
- 官方 Skill:平台预置的通用 Skill,覆盖常见文件处理场景(如 xlsx、docx、pdf、pptx)。由平台统一维护和更新,无需配置,挂载后即可使用。
- 自定义 Skill:上传 ZIP 技能包创建,适用于官方 Skill 未覆盖的业务场景,例如特定行业的数据处理、自定义文件格式解析。详见创建自定义 Skill。
官方 Skill
官方 Skill 在控制台技能页面查看,列表持续更新。官方 Skill 不需要开通或配置,挂载到智能体后即可使用;平台发布新版本后,已挂载的智能体自动使用最新版本。
技能市场
除控制台内置的官方 Skill,千问AI平台还有公开的技能市场,面向 Qoder、Claude Code 这类支持 Skill 的 AI 编码工具,可按应用维度筛选技能包。每个技能有一个详情页,地址形如 https://www.qianwenai.com/hub/skills/<技能标识>,页面上有概述和版本历史两个标签,以及该技能的开源协议和安全审计时间。
详情页的安装方式区有两个标签:
- 让 Agent 装:页面给出一段提示词,点复制提示词贴给你的 Agent 即可,形如「请根据 https://www.qianwenai.com/hub/install/skillshub.md ,安装 <技能标识>。」Agent 按这个说明自己完成检测和安装,你不用手写配置。以知识库技能为例,见服务渠道。
- 我自己装:这个标签下给出两种手动方式。一种是用千问AI平台 CLI 装,页面直接给出命令
qianwen skills install <技能标识>,旁边有复制按钮;另一种是点下载 Zip,把技能包解压到本地的 skills 目录。
qianwen,版本 1.4.0 及以上,用法见 CLI):
智能体怎么用 Skill
挂载 Skill 只是把能力给到智能体,具体调不调、什么时候调由智能体自己决定。有两种触发方式:
- 智能体自动判断:智能体把会话内容和每个已挂载 Skill 的
description做匹配,命中就调用。所以description写得准不准,直接决定调用准确率,写法见创建自定义 Skill。 - 在会话里直接点名:如果智能体没按预期调用,可以在消息里明确要求用哪个 Skill,例如「用 xlsx 技能把这份数据整理成表格」。
查看 Skill 详情
在控制台技能页面的市场或自定义标签页,点击目标 Skill 卡片进入详情页。详情页有两个标签:
- 概览:Skill 的名称、当前版本号、功能描述和属性信息。通过版本下拉框可切换查看历史版本。
- 更新记录:该 Skill 全部版本的发布时间和变更内容。
测试 Skill 效果
挂载后在会话中直接发消息就能验证。例如挂载官方 xlsx Skill 后发送:
下一步
- 创建自定义 Skill:ZIP 包要求与
SKILL.md编写规范。 - Agent Skill:在控制台或 API 上传、挂载、管理版本。