技能

技能是织信 AI 可以调用的、可复用的能力单元。它既可以是一套明确的业务处理规范，也可以包含脚本、模板和工具调用说明。创建后，技能可以直接用于智能体会话，也可以绑定到专家，再由定时任务或自动化间接调用。

如果把 AI 看作一名员工，可以这样理解几种资源的分工：

资源	主要解决的问题	例子
技能	“具体应该怎样做”	按统一规则给客户反馈分类并判断优先级
知识库	“回答时可以查哪些资料”	客户反馈处理规范、产品手册、FAQ
专家	“由谁来做、职责和边界是什么”	客户服务专家：接待用户、按需分诊、查规则并组织回复
定时任务	“什么时候自动做”	每个工作日 09:00 生成反馈巡检清单

谁能创建和使用技能

技能是团队资源，并不是团队中的每个人都能创建、修改或使用。管理员需要先在「团队设置 → 角色权限」中完成两层授权：

需要完成的操作	角色需要的权限
创建、导入、安装、编辑、升级、启用、停用或删除技能	「基础信息」中的「技能管理」
在智能体会话、专家或定时任务中实际使用技能	「AI 权限」中的「允许使用 AI 智能体」，并把「可使用技能」设为「全部」或在「仅指定」中勾选该技能

「可使用技能」的范围含义如下：

• 全部：可以使用团队中当前和以后新建的全部已启用技能；
• 仅指定：只能使用角色中明确勾选的已启用技能，新技能创建后需要管理员再次授权；
• 禁用：不能使用任何团队技能。

管理和使用是相互独立的。只负责维护技能的管理员可以拥有「技能管理」，但不必获得全部技能的运行权限；业务成员可以使用“客户反馈分诊”技能，但没有权限编辑、升级或删除它。需要创建后立即开启会话测试的人员，则应同时拥有「技能管理」、AI 对话权限和该技能的使用权限。

技能被绑定到专家，并不代表所有能使用该专家的人都会自动获得该技能。运行时还会检查实际执行账号的技能使用范围、技能状态、会话或任务权限模式以及数据和外部系统权限。只有这些条件同时满足，技能才能真正执行。

入口不可见或找不到技能

先检查团队是否启用了相应 AI 功能，再检查当前账号的角色。没有「技能管理」时，成员不能维护团队技能；技能未启用、角色的「可使用技能」为「禁用」，或「仅指定」中没有勾选目标技能时，成员也无法在运行时使用它。

完整的角色配置方式和界面截图，请参见AI 资源的管理权限与使用范围。

适用场景

技能特别适合沉淀以下能力：

• 标准业务流程：线索清洗、客户反馈分诊、合同要点检查、工单归类。
• 固定输出规范：生成日报、会议纪要、Excel 报告或结构化 JSON。
• 工具调用方法：告诉 AI 何时查询某张表、调用哪个接口、生成什么文件。
• 团队最佳实践：把已经验证有效的提示、步骤和检查清单共享给其他成员。
• 专家能力拆分：将一个复杂专家拆成多个职责单一、可分别维护的技能。

以下情况通常不需要单独创建技能：

• 只进行一次、没有复用价值的临时问答。
• 只是补充背景资料，更适合放入知识库。
• 需要定义完整角色、欢迎语和快捷问题，更适合创建专家。
• 任务主要依赖人工判断，且没有可说明、可验证的处理规则。

创建前的准备

创建技能前，建议先回答四个问题：

1. 什么情况下应该调用这个技能？
2. 调用技能时必须提供哪些输入？
3. 技能应按什么步骤处理？
4. 输出必须包含什么，哪些事情禁止执行？

本页以“客户反馈分诊”技能为例。它接收一段客户反馈，返回反馈分类、优先级、摘要和是否需要人工复核。后续既可以把它绑定给“客户服务专家”，由专家在完整沟通过程中按需调用，也可以用于边界明确的定时任务。

创建技能的三种方式

进入工作台，在左侧导航选择「技能」，然后点击右上角「新建技能」。系统提供以下入口。

手动创建（导入 ZIP 包）

手动创建适合已经在本地编写、测试过的技能。这里的“创建”不是只填写一条技能名称，而是导入一个完整技能包。

技能包必须是 .zip 文件，根目录必须包含 SKILL.md。一个最小技能包的结构如下：

customer-feedback-triage.zip
└── SKILL.md

如果技能还需要脚本、模板或示例文件，可以继续放在 ZIP 包中，并在 SKILL.md 中说明其用途和相对路径。

点击「手动创建」后，系统会打开「导入技能包」窗口：

导入过程会完成三类检查：

1. 格式校验：检查 ZIP 包结构，以及根目录是否包含 SKILL.md。
2. YAML 校验：解析 SKILL.md 顶部的元数据，检查必要字段是否完整。
3. 安全扫描：检查包内脚本、依赖和潜在风险，再进入保存流程。

WARNING

技能包建议不超过 10 MB。不要在技能包中保存密码、API Key、访问令牌或生产数据；敏感配置应由平台的安全配置方式提供。

编写 SKILL.md

SKILL.md 是技能最重要的说明文件。文件开头使用 YAML 元数据声明名称和说明，正文描述何时使用、怎样执行以及怎样输出。

下面是本例的简化内容：

---
name: 客户反馈分诊
description: 对客户反馈进行分类、优先级判断、摘要整理和人工复核建议。
---

# 客户反馈分诊

根据用户提供的客户反馈完成分诊，不得虚构反馈中未出现的信息。

## 分类

- 产品缺陷：已有功能不能正常使用
- 使用咨询：用户询问如何操作
- 功能建议：希望增加或改进功能
- 投诉：表达明显不满，或涉及退款、赔偿和服务态度
- 其他：无法归入上述类型

## 优先级

- P0：核心业务完全中断，且没有替代方案
- P1：严重影响使用，但存在临时替代方案
- P2：一般问题，不影响核心业务连续性
- P3：低影响建议或体验优化

## 人工复核

涉及退款、赔偿、敏感信息，或依据不足时，必须建议人工复核。

写作时应尽量把规则写成可检查的条件，避免只写“请专业地处理”“根据情况判断”一类含糊描述。

填写导入信息

上传 ZIP 包并通过解析后，补充技能的管理信息：

配置项	作用	建议
技能标识	技能在系统中的唯一调用身份	使用稳定的英文、数字和下划线组合，例如 customer_feedback_triage
显示名称	成员在技能列表和选择器中看到的名称	使用清晰的业务名称，例如“客户反馈分诊”
简介	说明技能的能力、适用场景和主要输出	一句话讲清“输入—处理—输出”
版本号	标记当前技能包版本	建议采用 1.0.0 这类语义化版本号
类型	用于列表筛选和团队治理	选择最接近实际用途的分类
图标 / 颜色	技能在列表、专家配置和会话中的视觉标识	同类技能可以使用统一风格

标识符和显示名称不是一回事

显示名称可以面向业务人员使用中文；标识符是运行时身份，应保持稳定。升级技能或在提示中明确指定技能时，应以标识符为准。随意修改或重复使用标识符，可能导致专家、会话或自动化无法找到预期技能。

检查右侧预览无误后，点击「确定提交导入」。

通过 AI 创建

如果还没有现成的技能包，可以选择「通过 AI 创建」，用自然语言说明目标、输入、处理步骤、输出和限制，让 AI 协助生成技能。

适合的描述方式如下：

创建一个“客户反馈分诊”技能。
输入是一段客户反馈；输出必须包含分类、P0-P3 优先级、50 字以内摘要、
是否人工复核和判断依据。不得虚构影响范围；涉及退款或赔偿必须人工复核。

生成后仍应检查 SKILL.md 和包内文件。AI 创建只是提高编写效率，不代表规则已经经过业务验证。页面右上角「创建历史」可用于查看 AI 创建过程和历史会话。

安装已有技能

「安装技能」用于从技能市场或团队技能库中选择已有技能。安装前应重点检查：

• 技能标识、版本、来源和适用范围；
• SKILL.md 中声明的工具、数据和外部访问要求；
• 是否与当前团队已有技能重复；
• 是否需要在安装后修改配置或完成额外授权。

当来源技能发布了更高版本时，应先阅读变更内容并在测试环境验证，再升级正在使用的版本。

查看和维护技能

创建成功后，可以打开技能详情查看完整的 SKILL.md，也可以下载原始 ZIP 包留档或用于其他环境。

列表中常用操作包括：

操作	说明
使用技能	以该技能为上下文开启智能体会话，适合快速验证
查看详情	查看标识、版本、状态和完整 SKILL.md
编辑	修改技能的管理信息
上传新版本	用新的技能包更新能力内容
启用 / 禁用	控制技能是否可以在新会话和资源选择器中使用
下载 ZIP 包	下载当前技能包，用于审查、备份或迁移
删除	删除不再需要的技能；执行前应先检查专家和业务配置中的引用

升级技能

升级前建议执行以下流程：

1. 提升版本号，并记录修改内容。
2. 使用典型输入、边界输入和错误输入进行测试。
3. 检查输出结构是否与旧版本兼容。
4. 检查绑定该技能的专家和定时任务。
5. 在新会话中重新验证，不要只依赖已经打开的旧会话。

TIP

会话通常在创建时装载可用资源。技能刚刚启用、升级或重新绑定后，建议新建会话再测试，避免旧会话仍使用先前的上下文。

绑定到专家

创建技能后，可以在「专家」的新建或编辑窗口中勾选它。专家只会获得被绑定且当前账号有权使用的技能。

绑定时遵循“最小够用”原则：

• 一个专家只绑定完成其职责必需的技能；
• 查询类专家不要无故绑定写入、删除或管理类技能；
• 高风险技能要在职责说明中明确前置确认条件；
• 技能被禁用后，应重新测试相关专家和定时任务。

权限与安全边界

技能不会绕过平台权限。实际可用能力由多个边界共同决定：

1. 技能是否已经启用；
2. 当前账号是否允许使用 AI，且角色的技能范围为「全部」或明确包含该技能；
3. 专家是否绑定该技能；
4. 当前会话或定时任务选择的权限模式；
5. 技能内部调用的数据、应用和外部系统是否允许当前身份访问。

即使技能写明“修改某张表”，当账号没有对应数据权限或会话处于只读模式时，也不应获得写入能力。

编写建议

一份稳定的技能说明通常包含以下内容：

• 触发条件：什么时候应该使用，什么时候不应该使用；
• 输入要求：必填信息、格式、数据范围和缺失信息处理方式；
• 执行步骤：按顺序列出查询、判断、调用和生成步骤；
• 输出要求：字段、格式、长度、文件类型或示例；
• 权限要求：读取、写入、外网、通知或管理能力；
• 异常处理：无法查询、信息不足、调用失败时怎样返回；
• 人工确认点：删除、批量写入、发送消息等操作何时必须确认。

不要把以下内容写进技能：

• 真实账号密码、Token、密钥和连接串；
• 只对某一条测试数据有效的记录 ID；
• 未经验证的表名、字段名或接口参数；
• 让 AI 无条件忽略权限、跳过确认或隐藏错误的指令。

常见问题

提示“ZIP 包根目录缺少 SKILL.md”

检查压缩包结构。SKILL.md 必须直接位于 ZIP 根目录，不能只存在于多套一层的文件夹中。

提示 YAML 校验失败

检查文件顶部的 --- 分隔符、缩进、冒号和必填字段。YAML 中含有特殊字符的内容可以使用引号包裹。

专家提示找不到技能

依次检查技能是否启用、专家是否保存了绑定、当前账号是否有权限，以及提示中是否误用了显示名称代替技能标识。修改后新建会话再验证。

技能可以选择，但执行结果不稳定

优先检查 SKILL.md 是否缺少明确的输入、步骤、输出格式和禁止事项。对关键业务规则补充正例、反例和人工复核条件，并使用固定测试集回归验证。

上传新版本后旧流程异常

比较新旧版本的输入输出约定。如果字段名、文件路径或工具名称发生变化，应同步检查专家职责、快捷提示、定时任务指令和自动化解析逻辑。