企业 Skill 统一下发:上传、分类与策略配置
Enterprise | 更新于 2026-10-18
本篇涵盖的知识重点
- Skill 是可复用的能力扩展单元,封装特定领域的指令、工具和知识
- 企业 Skill 管理采用双层策略:Skill 下发策略与成员自定义 Skill 策略,两者相互独立
- 上传入口为 AI 资源管理 > Skill 管理 > Skill 列表,Skill 包仅支持 .zip 格式
- Skill 包必含 SKILL.md 与 manifest.yaml,scripts、references、assets 为可选目录
- 分类管理可新建分类,分类名称限 1-20 个字符,描述最大 500 字符
- 下发策略分白名单与黑名单,优先级为黑名单 > 白名单 > 默认允许
- 删除分类不会删除 Skill,仅解除关联关系,Skill 变为未分类状态
- 成员自定义 Skill 功能默认关闭,且仅对上传者本人可见,不会在企业内自动共享
Skill 管理路径导览
共 8 步,按编号顺序阅读
Skill 治理要点解读
1上传企业 Skill 包
作用企业自建 Skill 是企业专属能力的载体,上传后才能被统一下发和管理。
操作在企业控制台进入 AI 资源管理 > Skill 管理 > Skill 列表,单击右上角「+ 上传 Skill」,填写 Skill 基本信息,并单击或拖拽上传本地 Skill 包文件(支持 .zip 格式)。必填项有 Skill 标识(用于显示的唯一标识)、显示名称(客户端显示的名称)、分类(选择或新建归属分类);选填项有版本与描述。配置完成后单击保存并启用即可。
注意上传前请确认来源可靠,Skill 包中的 scripts 脚本将在客户端沙箱中执行。
Skill 包的标准结构
- SKILL.md:必填,承载名称、描述与使用说明,是成员理解该 Skill 的第一入口
- manifest.yaml:必填,承载版本、依赖与元数据
- scripts/:可选,存放可执行脚本,会在客户端沙箱中执行,来源必须可信
- references/:可选,存放参考文档
- assets/:可选,存放图标、模板等资源
manifest.yaml 的最小示例字段
- name:Skill 名称,例如 my-enterprise-skill
- version:版本号,例如 1.0.0
- description:一句话说明用途
- category:归属分类,例如 data-processing
- author:作者标识,例如 enterprise-admin
图:在 AI 资源管理 > Skill 管理 > Skill 列表,单击右上角上传 Skill
图:填写标识、显示名称、分类等信息并上传 .zip 格式的 Skill 包
2看清三个特征与两种来源
作用先知道这套机制能做什么、Skill 从哪来,才能判断哪些操作对你有效。
操作在 Skill 管理下按需切换标签页:Skill 列表负责增删改查,分类管理负责归类,Skill 下发策略负责权限,成员自定义 Skill 负责是否开放自上传。
注意内置 Skill 无需管理员操作即可供成员使用,但无法由企业端修改或删除;自定义 Skill 需通过审核和策略配置后生效。
企业 Skill 管理的三个特征
- 可发现性:成员可在客户端按分类浏览和使用已授权的 Skill
- 可管控性:管理员可控制每个 Skill 的可见范围和使用权限
- 可扩展性:支持企业统一下发和成员自定义两种来源
内置 Skill 与自定义 Skill 的关键区分
- 内置 Skill:系统预置的能力,无需管理员操作即可供成员使用
- 自定义 Skill:企业管理员或成员上传的组织专属能力,需通过审核和策略配置后生效
3建立分类并组织 Skill
作用Skill 一多就会陷入找不到,按业务领域分组是提升可发现性的关键。
操作切换到「分类管理」标签页,单击「+ 新增分类」,填写分类名称(必填,1-20 个字符)、分类描述(选填,最大 500 字符)与排序位置(追加到末尾或置顶到首位),单击保存完成创建。
注意删除分类不会删除 Skill,仅解除关联关系,分类下的 Skill 会变为未分类状态;分类命名建议与部门业务对齐,避免过度泛化。
新建分类的字段与约束
- 分类名称:必填,1-20 个字符,是客户端显示的类别名,例如「代码审查」、「数据分析」
- 分类描述:选填,最大 500 字符,是辅助理解的文字说明,例如「用于自动化代码质量检测」
- 排序位置:选填,可设置追加到末尾或置顶到首位,决定客户端展示顺序
分类管理解决的两个核心问题
- Skill 过多导致查找困难:按业务领域分组,客户端以树形结构呈现
- 不同部门关注点不同:可按部门需求定制可见分类
已有分类支持的操作
- 排序:单击向上或向下箭头修改排序
- 重命名:单击重命名按钮修改分类名称
- 删除:单击操作中的删除按钮,分类下的 Skill 变为未分类状态
图:在分类管理中新增分类,可设置名称、描述与排序位置
图:对已有分类可用箭头调整排序,也可重命名或删除
4决定用白名单还是黑名单
作用两种策略方向相反,选错会把该用的人挡在外面,或把不该用的人放进来。
操作进入「Skill 下发策略」标签页,先想清楚目的是「只给少数人」还是「只挡少数人」,再据此选择策略类型:白名单表示指定成员仅能使用列表中的 Skill,黑名单表示禁止指定成员使用列表中的 Skill。
注意优先级规则为黑名单 > 白名单 > 默认允许;下发策略与客户端上传策略相互独立,改一个不会影响另一个。
白名单策略的定义与适用场景
- 定义:指定成员仅能使用列表中的 Skill,适合先把能力收敛到小范围
- 新员工入职,仅开放基础能力
- 外包人员访问受限 Skill 集
- 合规要求限定可用工具范围
黑名单策略的定义与适用场景
- 定义:禁止指定成员使用列表中的 Skill,适合绝大多数人都可放开、只堵少数风险点
- 高风险 Skill 需要限制访问
- 敏感操作仅限核心人员
- 试用期限制部分功能
5新建下发策略并保存
作用把选好的方向落到具体成员和 Skill 上,策略才会真正生效。
操作在新建策略表单中填写策略名称、策略类型(白名单或黑名单)、目标 Skill(搜索并选择需要限制的 Skill)与作用范围(选择策略生效的成员或部门),单击保存后策略即时生效。
注意保存即生效,配置前先确认作用范围没有意外覆盖到不该被影响的人;含敏感操作的 Skill 建议配白名单。
策略支持的属性
- 策略类型:枚举,全部 / 白名单 / 黑名单
- 策略名称:管理标识,便于检索
- 作用范围:复合类型,支持指定成员、部门或角色
- 关联 Skill:策略涉及的 Skill 集合
- 修改时间:最近一次更新时间的时间戳,可作为季度复核的抓手
策略管理支持的操作
- 新建策略:单击「+ 新建策略」,选择类型后填写表单
- 权限查询:输入成员名称,查询其被哪些策略覆盖及最终生效结果
- 编辑/删除:对已有策略进行调整或移除
双层策略架构的两个维度
- Skill 下发策略:控制成员能使用哪些 Skill,典型场景如仅允许研发团队使用代码审查 Skill
- 成员自定义 Skill:控制成员能否自行上传 Skill,用于开放或限制成员创建个人 Skill 的权限
图:新建下发策略时需配置类型、目标 Skill 与作用范围
6设置成员自定义 Skill 策略
作用开放自上传能激发活力,不受控则会带来质量与安全风险,需要显式选择模式。
操作进入「成员自定义 Skill」标签页查看当前策略状态,单击「修改策略」按钮,在弹窗中选择新的策略模式并确认保存。
注意该功能默认关闭,如需开放建议使用白名单模式仅授权特定成员;成员自定义 Skill 仅对上传者本人可见,不会在企业内自动共享。
四种策略模式的效果
- 允许所有用户:所有成员均可上传个人 Skill,管控最松
- 白名单模式:仅名单中的人可操作,其他人禁止,适合小范围试点
- 黑名单模式:名单中的人禁止,其他人正常,适合只堵少数风险点
- 禁止所有用户:所有成员均禁止操作,是最严格的默认收口
图:在成员自定义 Skill 标签页单击修改策略,选择白名单、黑名单等模式
7在 Skill 列表中盘点与检索
作用上线只是开始,定期盘点才能知道哪些 Skill 真的在用。
操作在 Skill 列表页用搜索框按 Skill 名称模糊搜索,用来源筛选切换查看自定义或内置 Skill;单击 Skill 名称可查看详情。
注意批量操作(启用、停用、删除)前确认选中范围,避免误操作影响生产环境中的成员使用。
Skill 列表的数据列
- Skill:显示名称,单击可查看详情
- 分类:归属的分类名称
- 类型:枚举,内置或自定义
- VER:当前发布版本,如 v1.2.0
- 状态:枚举,已启用或已停用
- 可见范围:当前 Skill 的可见成员或部门范围
- 操作:编辑、停用、删除、查看权限四个按钮
列表页的检索功能
- 搜索框:按 Skill 名称模糊搜索
- 来源筛选:切换查看自定义或内置 Skill
8定期审查与下线清理
作用Skill 会随时间膨胀,不及时清理会让成员在选择器里迷失,也留下安全隐患。
操作按季度审查 Skill 列表与下发策略:对长期无人使用的 Skill 先停用观察,确认无影响后再删除,并同步清理关联的下发策略。
注意不再使用的 Skill 请及时停用或删除,并同步清理关联的下发策略;删除前先用权限查询确认影响面。
功能涉及的信息收集项
- 企业账号信息(登录凭据):必要,用于登录企业管理后台进行 Skill 的上传、配置和管理
- Skill 包文件内容(SKILL.md、manifest.yaml、脚本、参考文档等):必要,构建企业 Skill 的定义、指令和行为能力
- 分类名称与描述:必要,用于客户端展示 Skill,帮助成员按领域查找
- 下发策略配置(成员、部门、角色选择):必要,控制 Skill 的可见范围和使用权限
- 成员自定义 Skill 上传行为和内容:非必要,仅在开启成员自定义 Skill 策略且成员主动上传个人 Skill 时涉及
权限与安全提示
- 优先级规则为:黑名单 > 白名单 > 默认允许;「下发策略」与「客户端上传策略」相互独立,改一个不会影响另一个。
- 成员自定义 Skill 仅对上传者本人可见,不会在企业内自动共享。
- 分类管理独立于 Skill 数据,删除分类不会删除 Skill,仅解除关联,Skill 变为未分类状态。
- Skill 的浏览、上传和管理不消耗积分;成员在客户端中调用 Skill 执行任务时,由客户端根据任务内容消耗相应积分。
- 企业自建 Skill 的内容由企业管理和控制,不会共享给平台外第三方;内置 Skill 由平台提供和维护,遵循平台的数据管理策略。
- 企业自建 Skill 的内容准确性和安全性由上传者负责;内置 Skill 的可用性和准确性取决于平台更新策略。
治理与分发训练
训练1:打包一个符合规范的企业 Skill
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
我要为企业上传一个自定义 Skill,请帮我产出包内容。
必须遵守的目录结构规范(不要改动结构):
my-enterprise-skill/
├── SKILL.md # [必填] 名称 + 描述 + 使用说明
├── manifest.yaml # [必填] 版本、依赖、元数据
├── scripts/ # [可选] 可执行脚本
├── references/ # [可选] 参考文档
└── assets/ # [可选] 图标、模板等资源
manifest.yaml 最小示例字段:name、version、description、category、author。
Skill 用途假设:一个「接口变更影响面检查」Skill,输入是一次接口改动描述,输出是可能受影响的调用方清单与检查建议。
请输出:
1. 一份完整的 SKILL.md 内容(包含名称、描述、使用说明三段,使用说明中写清触发时机、输入、输出);
2. 一份符合示例字段的 manifest.yaml;
3. 一段上传前自检清单,至少 6 项,并明确提醒脚本会在客户端沙箱中执行、需确认来源可靠。
```
预期结果
得到 SKILL.md 与 manifest.yaml 的可直接打包内容,以及一份含安全提醒的上传前自检清单。
训练2:设计一套 Skill 下发策略组合
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
我要为企业配置 Skill 下发策略,请帮我设计方案。
必须依据的真实规则(不要新增策略类型):
- 系统提供三种策略模式:白名单、黑名单,以及作用范围上的组合;白名单指指定成员仅能使用列表中的 Skill,黑名单指禁止指定成员使用列表中的 Skill;
- 优先级规则为黑名单 > 白名单 > 默认允许;
- 下发策略与客户端上传策略相互独立;
- 策略属性包括策略类型、策略名称、作用范围(支持指定成员/部门/角色)、关联 Skill 列表、修改时间;
- 支持权限查询:输入成员名称,查询其被哪些策略覆盖及最终生效结果;
- 下发策略默认所有成员可见;成员自定义 Skill 功能默认关闭,如需开放建议使用白名单模式。
我的场景:研发团队 80 人需要使用代码审查与测试自动化 Skill;外包人员 20 人只开放基础能力;有 3 个高风险 Skill(涉及数据库写入)仅限核心成员使用。
请输出:1)一张策略配置表(策略名称 / 类型 / 目标 Skill / 作用范围 / 目的);2)一段冲突说明,讲清当某人同时命中白名单与黑名单时的最终结果及原因;3)一段验证方案,说明用权限查询功能验证哪几位成员。
```
预期结果
得到一张策略配置表、准确的优先级冲突说明和一份验证方案,明确黑名单优先这一规则。
训练3:制定 Skill 生命周期治理规范
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
我们企业已经上线了一批 Skill,需要一份生命周期治理规范。
必须依据的真实事实(不要增删功能):
- Skill 列表提供搜索框(按名称模糊搜索)与来源筛选(自定义或内置);
- 列表数据列包括:Skill(显示名称,单击可查看详情)、分类、类型(内置/自定义)、VER(版本号)、状态(已启用/已停用)、可见范围、操作(编辑/停用/删除/查看权限);
- 分类支持排序、重命名、删除;删除分类不会删除 Skill,仅解除关联,Skill 变为未分类状态;
- 内置 Skill 无需管理员操作即可供成员使用,但无法由企业端修改或删除;
- 自定义 Skill 需通过审核和策略配置后生效;
- Skill 的浏览、上传和管理不消耗积分,成员在客户端调用时由客户端根据任务内容消耗积分;
- 不再使用的 Skill 请及时停用或删除,并同步清理关联的下发策略。
请输出:1)一份分阶段治理流程(上线—运行—评估—下线),每阶段写明动作与判定标准;2)一张季度审查清单表(审查项 / 看哪些字段 / 什么情况需要下线 / 下线前要做什么);3)一段下线操作的风险提示(不超过 150 字),说明批量操作与策略残留的风险。
```
预期结果
得到一份分阶段治理流程、季度审查清单和下线风险提示,字段与操作描述均来自给定的列表能力。