使用企业 Skill 管理功能统一分发和管理组织内的 CodeBuddy/WorkBuddy 能力扩展，实现标准化的技能共享与精细化权限控制。
概述
什么是 Skill
Skill（技能） 是可复用的 CodeBuddy/WorkBuddy 能力扩展单元，封装了特定领域的指令、工具和知识，使智能体能够执行专业化的任务。
特征 | 说明 |
可发现性 | 成员可在客户端按分类浏览和使用已授权的 Skill |
可管控性 | 管理员可控制每个 Skill 的可见范围和使用权限 |
可扩展性 | 支持企业统一下发和成员自定义两种来源 |
关键区分
内置 Skill：系统预置的能力，无需管理员操作即可供成员使用。
自定义 Skill：企业管理员或成员上传的组织专属能力，需通过审核和策略配置后生效。
核心概念
策略体系
企业 Skill 管理采用双层策略架构：
策略维度 | 控制对象 | 典型场景 |
Skill 下发策略 | 成员能使用哪些 Skill | 仅允许研发团队使用代码审查 Skill |
成员自定义 Skill | 成员能否自行上传 Skill | 开放/限制成员创建个人 Skill 的权限 |
优先级规则
黑名单 > 白名单 > 默认允许。
“下发策略”与“客户端上传策略”相互独立。
快速开始
步骤1：上传企业 Skill
1. 进入 AI 资源管理 > Skill 管理 > Skill 列表。
2. 单击右上角 + 上传 Skill。
3. 填写 Skill 基本信息，单击或拖拽上传本地 Skill 包文件（支持
.zip 格式）。Skill 标识（必填）：用于显示的唯一标识。
显示名称（必填）：客户端显示的名称。
分类（必填）：选择或新建归属分类。
版本（选填）：Skill 版本号。
描述（选填）：Skill 的简要说明。
4. 确认权限配置 > 可见范围后，单击保存并启用完成上传。
步骤2：配置分类
1. 切换到 分类管理 标签页。
2. 单击 + 新增分类 创建业务分类。
3. 新增 Skill 分类界面完成以下配置项：
字段 | 说明 | 示例 |
分类名称 | 客户端显示的类别名 | “代码审查”、“数据分析” |
分类描述 | 辅助理解的文字说明 | “用于自动化代码质量检测” |
排序位置 | 决定客户端展示顺序 | 可设置追加到末尾或置顶到首位 |
步骤3：设置下发策略
如果需要限制特定 Skill 的使用范围：
1. 进入 Skill 下发策略 标签页。
2. 单击 + 新建策略。
3. 选择策略类型并配置：
策略名称：自定义策略名称。
策略类型：可选择白名单或黑名单。
目标 Skill：搜索并选择需要限制的 Skill。
作用范围：选择策略生效的成员或部门。
4. 保存后策略即时生效。
Skill 列表
页面功能概览
Skill 列表是管理的核心入口，提供 Skill 的全生命周期操作。
功能区 | 说明 |
搜索框 | 按 Skill 名称模糊搜索 |
来源筛选 | 切换查看自定义或内置Skill |
数据列定义
列名 | 类型 | 说明 |
Skill | 文本 | Skill 显示名称，单击可查看详情 |
分类 | 文本 | 归属的分类名称 |
类型 | 枚举 | 内置 / 自定义 |
VER | 版本号 | 当前发布版本，如 v1.2.0 |
状态 | 枚举 | 已启用 / 已停用 |
可见范围 | 文本 | 当前 Skill 的可见成员/部门范围 |
操作 | 按钮 | 编辑 / 停用 / 删除 / 查看权限 |
上传 Skill 规范
支持的 Skill 包结构：
my-enterprise-skill/├── SKILL.md # [必填] 名称 + 描述 + 使用说明├── manifest.yaml # [必填] 版本、依赖、元数据├── scripts/ # [可选] 可执行脚本├── references/ # [可选] 参考文档└── assets/ # [可选] 图标、模板等资源
manifest.yaml 最小示例：
name: my-enterprise-skillversion: 1.0.0description: "企业内部专用的数据处理 Skill"category: data-processingauthor: enterprise-admin
分类管理
为什么需要分类
分类管理解决两个核心问题：
问题 | 解决方案 |
Skill 过多导致查找困难 | 按业务领域分组，客户端以树形结构呈现 |
不同部门关注点不同 | 可按部门需求定制可见分类 |
操作指引
创建新分类
1. 在 分类管理 标签页单击 + 新增分类。
2. 填写表单：
字段 | 必填 | 约束 | 说明 |
分类名称 | 是 | 1-20 个字符 | 客户端显示名称 |
分类描述 | 否 | 最大 500 字符 | 补充说明信息 |
排序 | 否 | 追加到末尾 / 置顶到首位 | 同级排序依据 |
3. 单击保存
管理现有分类
对已有分类支持的操作：
操作 | 触发方式 | 影响 |
排序 | 单击向上/向下箭头 | 修改排序 |
重命名 | 重命名按钮 | 修改分类名称 |
删除 | 操作删除按钮 | 分类下 Skill 变为未分类状态 |
说明：
删除分类不会删除 Skill，仅解除关联关系。
Skill 下发策略
策略类型详解
系统提供三种策略模式：
白名单策略
定义：指定成员仅能使用列表中的 Skill。
适用场景：
新员工入职，仅开放基础能力。
外包人员访问受限 Skill 集。
合规要求限定可用工具范围。
黑名单策略
定义：禁止指定成员使用列表中的 Skill。
适用场景：
高风险 Skill 需要限制访问。
敏感操作仅限核心人员。
试用期限制高级功能。
策略管理操作
操作 | 说明 |
新建策略 | 单击“+ 新建策略”，选择类型后填写表单 |
权限查询 | 输入成员名称，查询其被哪些策略覆盖及最终生效结果 |
编辑/删除 | 对已有策略进行调整或移除 |
策略属性一览
属性 | 类型 | 说明 |
策略类型 | 枚举 | 全部 / 白名单 / 黑名单 |
策略名称 | 文字 | 管理标识，便于检索 |
作用范围 | 复合 | 支持指定成员/部门/角色 |
关联 Skill | 列表 | 策略涉及的 Skill 集合 |
修改时间 | 时间戳 | 最近一次更新时间 |
成员自定义 Skill
功能说明
控制企业成员是否可以自行上传并使用个人 Skill。
策略选项
选项 | 效果 |
允许所有用户 | 所有成员均可上传个人 Skill |
白名单模式 | 仅名单中的人可操作，其他人禁止 |
黑名单模式 | 名单中的人禁止，其他人正常 |
禁止所有用户 | 所有成员均禁止操作 |
配置步骤
1. 进入 成员自定义 Skill 标签页，查看当前策略状态。
2. 单击 修改策略 按钮。
3. 在弹窗中选择新的策略模式，确认保存。
注意事项与重点提示
信息收集与使用
收集项 | 类型 | 用途 |
企业账号信息（登录凭据） | 必要 | 登录企业管理后台，进行 Skill 的上传、配置和管理 |
Skill 包文件内容（SKILL.md、manifest.yaml、脚本、参考文档等） | 必要 | 构建企业 Skill 的定义、指令和行为能力 |
分类名称与描述 | 必要 | 用于客户端展示 Skill，帮助成员按领域查找 |
下发策略配置（成员/部门/角色选择） | 必要 | 控制 Skill 的可见范围和使用权限 |
成员自定义 Skill 上传行为和内容 | 非必要 | 仅在开启成员自定义 Skill 策略且成员主动上传个人 Skill 时涉及 |
类型判定标准：
必要：使用 Skill 管理核心功能时必须提供的信息（如企业账号、Skill 包内容、分类配置、策略成员选择）。
非必要：仅在管理员开启特定策略且成员主动触发时才涉及的数据（如个人 Skill 上传内容）。
权限边界
管理员通过下发策略控制成员能使用哪些 Skill，不直接干预成员在客户端中的实际调用行为。
成员自定义 Skill 仅对上传者本人可见，不会在企业内自动共享。
分类管理独立于 Skill 数据，删除分类不会删除 Skill，仅解除关联。
黑名单优先级高于白名单，当同一成员同时适用两种策略时以黑名单为准。
安全提示
上传 Skill 包前请确认来源可靠，Skill 包中的脚本（
scripts/）将在客户端沙箱中执行。下发策略默认所有成员可见，建议对含敏感操作的 Skill 配置白名单策略以限制使用范围。
成员自定义 Skill 功能默认关闭，如需开放建议使用白名单模式，仅授权特定成员。
不再使用的 Skill 请及时停用或删除，并同步清理关联的下发策略。
内置 Skill 无需管理员额外操作，但无法由企业端修改或删除。
积分消耗提醒
Skill 的浏览、上传和管理不消耗积分；成员在客户端中调用 Skill 执行任务时，由客户端根据任务内容消耗相应积分。
第三方共享
企业自建 Skill 的内容由企业管理和控制，不会共享给平台外第三方。
内置 Skill 由平台提供和维护，遵循平台的数据管理策略。
Skill 的 MCP 连接或外部 API 调用能力取决于 Skill 包内的配置，不在企业管理范围内。
免责声明
企业自建 Skill 的内容准确性和安全性由上传者负责，WorkBuddy 不对 Skill 包内脚本的执行结果承担责任。
内置 Skill 由平台维护，其功能的可用性和准确性取决于平台更新策略。
成员自定义 Skill 策略开放后，成员上传的 Skill 内容由该成员自行负责。
使用建议
分类命名建议与部门业务对齐（如“代码审查”、“数据分析”、“测试自动化”），避免分类过度泛化导致查找困难。
下发策略配置后建议使用“权限查询”功能验证生效结果，确认目标成员获取了正确的 Skill 权限。
成员自定义 Skill 策略开启前，建议先评估团队规模和 Skill 质量管控需求，选择白名单/黑名单/全部开放中合适的模式。
定期审查已上线的 Skill 列表和下发策略，清理不再使用或过期的 Skill，保持企业空间中 Skill 的质量和可维护性。
批量操作（启用/停用/删除）前确认选中范围，避免误操作影响生产环境中的成员使用。
声明
