「技能」功能详解

什么是「技能」？

「技能」本身不是模型，也不等于一个外部工具，它更像一份交给「千问办公」使用的“专业工作说明书”，能让「千问办公」多次稳定地按照同一套标准工作流完成任务。

「千问办公」内置了以下技能：

什么时候用？

「技能」适合在以下场景中使用。

什么时候不适合用？

• 只执行一次的简单任务
• 没有明确步骤和验收标准的探索性任务
• 需求经常变化、暂时无法形成稳定流程的任务

如何获取「技能」？

你可以通过以下方式获取「技能」。

从技能广场安装

1. 在左侧导航栏，点击扩展 > 技能，进入技能广场。

2. 选择需要的技能，点击安装。

上传本地技能

1. 准备一个包含根级 skill.md 或者 .zip 。
2. 在左侧导航栏，点击 扩展 > 技能 > ➕ 添加 > 上传技能。

3. 「千问办公」会解析并安装该技能，安装完成后即可启用。

如何使用「技能」？

你可以按照以下方式使用「技能」。

自动触发

当你的任务需求与已有技能匹配，「千问办公」会自动判断、识别并使用技能。例如，一个“简历优化”技能的触发条件是“用户请求优化简历”，那么你输入提示词“帮我优化这个简历”，「千问办公」可能会自动调用该技能。

手动调用

• 在对话输入框中输入 / ，「千问办公」会弹出已安装的技能列表，选择即可调用。
• 直接在对话输入框中指定，例如，“用简历优化技能帮我优化简历”
• 在技能管理中心的“已安装”页面，打开技能，点击使用。

如何创建「技能」？

创建技能前，先选一个真实、重复发生的任务。不要一开始追求覆盖所有场景。

「千问办公」帮你写

你可以让「千问办公」帮你创建技能，点击 技能 > + 添加 > 通过「千问办公」创建，按照提示完成剩下步骤。

你也可以先与「千问办公」共同完成一次任务，再要求它总结流程，例如：

把刚才生成周报的流程沉淀为一个“项目周报技能”。以后调用时，先汇总指定时间范围内的钉钉消息、待办和项目文档，再按照“本周进展、关键成果、风险问题、下周计划”输出。信息不足时先向我确认，不要编造内容。

自己写

一个技能必须包含 skill.md 文件，高级技能还可以包括示例、目标、脚本和参考资源。

推荐目录结构：

skill-name/
├── SKILL.md              # 必填：技能说明与执行规则
├── examples/             # 可选：输入输出样例
│   ├── input.md
│   └── output.md
├── templates/            # 可选：可复用模板
│   └── report.md
├── scripts/              # 可选：自动化脚本
│   └── run.py
└── references/           # 可选：背景资料或规范文档
    └── style-guide.md

skill.md 通常包括以下信息：

---
name: 技能名称
description: 用一句话说明这个技能解决什么问题、适合什么场景
---

# 技能名称

## 适用场景
说明用户在什么情况下应该使用这个技能。

## 能力边界
说明这个技能能做什么，不能做什么。

## 执行流程
按步骤说明智能体应该如何完成任务。

## 输入要求
说明用户需要提供哪些信息、文件或参数。

## 输出要求
说明最终应该交付什么结果、格式或文件。

## 示例
提供一个典型输入和期望输出，帮助智能体理解标准。

常见问题

「技能」和提示词的区别是什么？

提示词是当前任务，「技能」适合反复使用的任务。

「技能」是不是越多越好？

不是。功能重复、描述模糊的「技能」会增加选择难度。

为什么「技能」没有被调用？

检查使用场景和触发条件是否描述清楚，也可能是当前任务与「技能」不匹配。

「技能」能直接访问钉钉和本地文件吗？

取决于产品支持范围和用户授权，调用前应确认数据及权限。

「技能」可以代替人工审核吗？

不能完全代替。涉及对外发布、审批、敏感数据和重要决策时，应保留人工确认。

团队可以共同使用「技能」吗？

如果产品支持团队共享，可将成熟 SOP 和模板沉淀为团队「技能」。