← 返回首页深度篇
深度篇 · Enterprise · 企业版后台使用说明

企业 Skill 统一下发:上传、分类与策略配置

Enterprise | 更新于 2026-10-18

本篇涵盖的知识重点

Skill 管理路径导览

1 上传企业 Skill 包 2 看清三个特征与两种来源 3 建立分类并组织 Skill 4 决定用白名单还是黑名单 5 新建下发策略并保存 6 设置成员自定义 Skill 策略 7 在 Skill 列表中盘点与检索 8 定期审查与下线清理
共 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
Skill 列表页面与上传 Skill 入口
图:在 AI 资源管理 > Skill 管理 > Skill 列表,单击右上角上传 Skill
上传 Skill 时填写基本信息与上传 zip 包
图:填写标识、显示名称、分类等信息并上传 .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 下发策略的新建策略表单
图:新建下发策略时需配置类型、目标 Skill 与作用范围
6设置成员自定义 Skill 策略

作用开放自上传能激发活力,不受控则会带来质量与安全风险,需要显式选择模式。

操作进入「成员自定义 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 时涉及

权限与安全提示

治理与分发训练

训练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 字),说明批量操作与策略残留的风险。
```
预期结果

得到一份分阶段治理流程、季度审查清单和下线风险提示,字段与操作描述均来自给定的列表能力。

参考文档:Skill管理(WorkBuddy 官方文档)
本文基于官方文档再创作,具体以官方文档站实际展示为准。