# 管理技能和规则中心 技能和规则中心用于统一管理云端技能和云端规则。您可在控制台对云端技能和规则执行创建、编辑、启用和删除等操作，创建后的技能和规则可同步至华为云码道代码智能体客户端使用。 华为云码道代码智能体支持创建**本地** 和**云端** 两种类型的技能和规则：本地技能和规则在客户端创建，云端技能和规则在控制台创建，其中**云端个人级规则**既可在云端创建，也支持在本地客户端创建。 本章节介绍企业成员在控制台管理云端技能和规则的操作，如需在客户端管理技能和规则，请参考[技能](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0024.html)和[规则](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0019.html)。 #### 技能的目录结构 技能是一个包含**必需的SKILL.md文件** 和其他**可选的捆绑资源** 的结构化目录，打包完成特定任务所需的知识和工具。 ``` skill-name/ ├── SKILL.md (必填) │ ├── YAML frontmatter 元数据 (必填) │ │ ├── name: (必填) │ │ └── description: (必填) │ └── Markdown 指令 (必填) └── Bundled Resources/ 捆绑资源 (选填) ├── scripts/ - 可执行代码 (Python/Bash 等) ├── references/ - 旨在根据需要加载到上下文中的文档 └── assets/ - 输出中使用的文件 (模板、图标、字体等) ``` 表1技能参数说明 | 参数名称 | 说明 | |:---|:---| | skill-name | 整个技能的根目录，skill-name需要替换成实际的技能名称（比如data-analysis-skill）。技能名称由小写字母、数字和连字符（-）组成，开头和结尾不能是连字符，且连字符不可连续使用，长度1\~64字符。 | | SKILL.md | **SKILL.md文件名不可修改。**它是技能的核心描述文件，相当于技能的"说明书"，必须包含以下两部分： - **YAML frontmatter元数据** ：放在SKILL.md文件的最顶部，以"---"首尾包裹，是AI可解析的结构化信息。包含name和description两个字段。 - **name** ：技能名称，由小写字母、数字和连字符（-）组成，开头和结尾不能是连字符，且连字符不可连续使用，长度1\~64字符。**name必须与skill-name保持一致**。 - **description**：技能描述，长度不超过1024字符。该字段对华为云码道代码智能体识别技能的使用场景至关重要，需清晰描述技能功能及适用触发条件。 - **Markdown指令**：YAML元数据下方的Markdown内容，用于详细说明技能的使用方法、参数、示例和依赖等。 | | Bundled Resources（可选） | 存放技能配套资源的目录，非必填，但能让技能更完整。 - **scripts/** ：存放技能的可执行脚本，例如Python脚本、Shell脚本等，实现**确定性操作**。 - **references/** ：存放技能依赖的参考文档，例如API文档、领域知识、公司政策等，是给智能体的**知识库**，这些文档会在技能执行时按需加载到上下文。 - **assets/**：存放资源文件，例如字体资源、公司Logo、PPT模板等，直接在智能体生成的输出中使用，不需要被加载到上下文窗口。 | #### 云端技能和规则分类 表2云端技能和规则分类 | 作用范围 | 适用对象 | 说明 | |:---|:---|:---| | 企业级 | 企业所有成员 | 企业统一的技能和规则，整个企业所有成员都可用，由企业管理员创建，存储在云端。 | | 团队级 | 指定团队的所有成员 | 团队统一的技能和规则，指定的团队可用。由企业管理员或团队管理员创建，存储在云端。 | | 个人级 | 仅本人 | 仅成员本人可用，存储在云端。 | #### 约束与限制 - 新版套餐中，**个人版** 套餐仅支持创建云端**个人级技能和规则**，企业版套餐可创建云端企业级、团队级、个人级技能和规则。 - 旧版套餐中，仅**基础版** 和**专业版**套餐支持创建云端技能和规则。 - 若存在**名称相同** 的技能或规则，调用优先级如下： - 技能：云端企业级 \> 云端团队级 \> 本地项目级 \> 本地个人级 \> 云端个人级 \> 系统内置。 - 规则：云端企业级 \> 云端团队级 \> 本地项目级 \> 本地个人级 \> 云端个人级。 #### 创建云端技能 1. 套餐版本是否为新版套餐的个人版（个人体验版、个人标准版、个人高级版、个人旗舰版）？ - 是，使用**购买套餐的账号** 登录[码道代码智能体控制台](https://codearts.huaweicloud.com/portal)。 - 否，使用**企业成员或企业管理员** 登录[码道代码智能体控制台](https://codearts.huaweicloud.com/portal)。 2. 在左侧导航栏选择"智能体设置 \> 技能和规则中心"，进入技能和规则列表页面。 3. 在"技能"页签，单击右上角的"新建技能"，弹出"新建技能"对话框。 4. 在蓝色框区域单击鼠标右键，从本地上传技能zip包。或将本地技能zip包直接拖入蓝色框区域，然后单击"确定"。 ![](https://support.huaweicloud.com/usermanual-enterprise/public_sys-resources/caution_3.0-zh-cn.png) - 技能zip包需符合[技能的目录结构]，否则可能会导入失败。例如，每个技能文件夹的根目录均须包含对应的SKILL.md文件，此文件中须包含YAML格式的技能名称与描述等。 - 每次仅支持上传一个zip包，包内可存放多个技能文件夹，且包的总大小不能超过5M。 图1新建技能 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693558622.png "点击放大") 5. 参考[表3]设置云端技能参数。 图2新建云端技能 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723357969.png "点击放大") 表3云端技能参数说明 | 参数 | 说明 | |:---|:---| | 更换 | 若您需要重新上传技能zip包，单击"更换"，参考[4]重新上传zip包。 | | 可用范围 | 仅企业版（新版套餐）或基础版、专业版（旧版套餐），支持配置该参数。 - 个人：仅限本人使用，不会共享给其他用户。 - 团队：指定的团队可用，**企业管理员或团队管理员可创建**。 - 企业：整个企业所有成员都可用，**仅企业管理员可创建**。 | | 可用团队 | 仅"可用范围"设置为"团队"时，展示此参数。 在下拉列表中选择团队。若尚未创建团队，请先[创建团队](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0004.html#codeartsagent_enterprise_0004__section189712364543)。 企业管理员可查看并选择所有团队，团队管理员仅可查看并选择其所属团队。 | | 标签 | 可选，华为云码道代码智能体已预置了几类标签，请根据实际需求在下拉列表中选择。 | 6. 单击"确定并启用"，完成技能的创建。 在"技能"页签中，查看新创建的技能。如需立即在本地客户端中查看云端创建的技能，请在"设置 \> 技能与规则"页面的对应技能页签（企业级/团队级/个人级）中，单击技能后的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002603341837.png) 或"![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002585490954.png) \> 刷新"，同步云端技能到本地客户端。 ![](https://support.huaweicloud.com/usermanual-enterprise/public_sys-resources/note_3.0-zh-cn.png) - 客户端每24小时自动同步一次云端技能。 - 客户端仅同步**已** **启用** **的技能**。 #### 管理云端技能 [表4]展示了不同角色对[管理云端技能]的操作权限差异，具体如下： 表4不同角色对云端技能的操作权限说明 | 角色 | 企业级技能 | 团队级技能 | 个人级技能 | |:---|:---|:---|:---| | 企业管理员 | 可对所有技能执行全量操作。 | 可对所有技能执行全量操作。 | 可对所有技能执行除编辑以外的操作，仅能对本人创建的技能进行编辑。 | | 团队管理员 | 可执行以下操作： - 查看云端技能详情。 - 收藏或取消收藏。 | 可对本团队成员（含团队管理员）创建的技能执行全量操作。 | 可对本人创建的技能执行全量操作。 | | 团队成员 | 可执行以下操作： - 查看云端技能详情。 - 收藏或取消收藏。 | 可对本团队成员创建的技能执行以下操作： - 查看云端技能详情。 - 收藏或取消收藏。 | 可对本人创建的技能执行全量操作。 | | 企业成员 | 可执行以下操作： - 查看云端技能详情。 - 收藏或取消收藏。 | 无任何操作权限。 | 可对本人创建的技能执行全量操作。 | ![](https://support.huaweicloud.com/usermanual-enterprise/public_sys-resources/note_3.0-zh-cn.png) 仅企业版（新版套餐）或基础版、专业版（旧版套餐），涉及[表4]的操作权限。 表5管理云端技能 | 操作 | 具体步骤 | |:---|:---| | 查看云端技能详情 | - 在控制台的"技能和规则中心 \> 技能"中，单击目标技能名称，查看云端技能详情。 - 在客户端的"设置 \> 技能与规则"页面的对应技能页签（企业级/团队级/个人级）中，将鼠标悬浮在目标技能上，然后单击 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723359557.png)，查看云端技能详情。 | | 编辑云端技能 | 1. 在控制台的"技能和规则中心 \> 技能"中，查看目标技能的状态。 - 如果为已启用，需先停用该技能，然后才能执行编辑操作。 - 如果为已停用，执行下一步编辑技能。 2. 单击目标技能后的"编辑"，即可对技能进行修改。 | | 删除指定云端技能 | 1. 在控制台的"技能和规则中心 \> 技能"中，查看目标技能的状态。 - 如果为已启用，需先停用该技能，然后才能执行删除操作。 - 如果为已停用，执行下一步删除技能。 2. 单击目标技能后的"删除"，即可对技能进行删除。 目标技能已从技能列表中移除，表示技能删除成功。 注意： 技能删除后，使用该技能的智能体将受到影响，且删除的技能不可恢复，请谨慎操作。 | | 启用或停用指定云端技能 | 通过以下任意一种方法启用或停用指定云端技能。 - 在控制台的"技能和规则中心 \> 技能"中，单击目标技能后的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693560198.png) / ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723239631.png)，启用或停用云端技能。**已启用的技能才会同步至华为云码道代码智能体客户端中。** - 在客户端的"设置 \> 技能与规则"页面的对应技能页签（企业级/团队级/个人级）中，可通过开关启用或停用云端技能。 | | 收藏或取消收藏指定云端技能 | 在控制台的"技能和规则中心 \> 技能"中，单击目标技能后的"收藏"/"取消收藏"，即可收藏或取消收藏该技能。 在"我收藏的"页面查看已收藏的技能。 | | 批量删除云端技能 | 1. 在控制台的"技能和规则中心 \> 技能"中，查看目标技能的状态。 - 如果为已启用，需先停用该技能，然后才能执行删除操作。 - 如果为已停用，执行下一步删除技能。 2. 勾选目标技能，单击右上角的"更多 \> 批量删除"，弹出确认批量删除对话框。 3. 输入"DELETE"或单击"一键输入"，然后单击"确定"，完成技能的批量删除。 目标技能已从技能列表中移除，表示技能删除成功。 | | 批量启用或停用云端技能 | 通过以下任意一种方法批量启用或停用云端技能。 - 在控制台的"技能和规则中心 \> 技能"中，勾选目标技能，单击右上角的"批量启用"或"更多 \> 批量停用"，批量启用或停用云端技能。**已启用的技能才会同步至华为云码道代码智能体客户端中。** - 在客户端的"设置 \> 技能与规则"页面的对应技能页签（企业级/团队级）中，单击右上角的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693720078.png)。勾选目标技能，选择右上角的"开启"或"关闭"，批量启用或停用云端技能。 - 在客户端的"设置 \> 技能与规则 \> 个人级"中，单击右上角的"![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723359559.png) \> 批量操作"。勾选目标技能，选择右上角的"开启"或"关闭"，批量启用或停用云端技能。 | | 批量收藏或取消收藏云端技能 | 在控制台的"技能和规则中心 \> 技能"中，勾选目标技能，单击右上角的"更多 \> 批量收藏"/"更多 \> 批量取消收藏"，即可收藏或取消收藏目标技能。 在"我收藏的"页面查看已收藏的技能。 | #### 创建云端规则 1. 套餐版本是否为新版套餐的个人版（个人体验版、个人标准版、个人高级版、个人旗舰版）？ - 是，使用**购买套餐的账号** 登录[码道代码智能体控制台](https://codearts.huaweicloud.com/portal)。 - 否，使用**企业成员或企业管理员** 登录[码道代码智能体控制台](https://codearts.huaweicloud.com/portal)。 2. 在左侧导航栏选择"智能体设置 \> 技能和规则中心"，进入技能和规则列表页面。 3. 在"规则"页签，单击右上角的"新建规则"，弹出"新建规则"对话框。 4. 参考[表6]设置规则参数。 图3新建云端规则 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723360131.png "点击放大") 表6云端规则参数说明 | 参数 | 说明 | |:---|:---| | 名称 | 新建规则的名称。 命名规范：长度1\~64字符，且仅允许包含字母、数字、下划线、中文、连字符（-）和点号。 | | 内容 | 自定义一条或多条规则的内容，长度不超过50000个字符。 例如，始终使用Python语言回答。 | | 使用范围 | 指定规则的适用范围，即规则生效的场景。 - 自动应用：规则将默认应用于所有会话，由系统自动识别。 - 手动触发：规则不会自动生效。用户需在聊天窗口的输入框中输入"#"，或单击 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002626932982.png)选择"添加上下文"，再选择"Rules"并从列表中选择特定规则，方可启用。 | | 可用范围 | 仅企业版（新版套餐）或基础版、专业版（旧版套餐），支持配置该参数。 - 个人：仅限企业成员本人使用。 - 团队：指定团队的所有成员可用，**企业管理员或团队管理员可创建**。 - 企业：所有企业成员都可用，**仅企业管理员可创建**。 | | 可用团队 | 仅"可用范围"设置为"团队"时，展示此参数。 在下拉列表中选择团队。若尚未创建团队，请先[创建团队](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0004.html#codeartsagent_enterprise_0004__section189712364543)。 企业管理员可查看并选择所有团队，团队管理员仅可查看并选择其所属团队。 | | 标签 | 可选，华为云码道代码智能体已预置了几类标签，请根据实际需求在下拉列表中选择。 | | 简要描述 | 可选，规则的描述信息，长度不能超过1024个字符。 | 5. 单击"确定并启用"，完成规则的创建。 在"规则"页签中，查看新创建的规则。如需立即在客户端查看云端创建的规则，请在"设置 \> 技能与规则"页面的对应规则页签（企业级/团队级/个人级）中，单击规则后的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002603341837.png)，同步云端规则到客户端。 ![](https://support.huaweicloud.com/usermanual-enterprise/public_sys-resources/note_3.0-zh-cn.png) - 客户端每24小时自动同步一次云端规则。 - 客户端仅同步**已启用** **的规则**。 #### 管理云端规则 [表7]展示了不同角色对[管理云端规则]的操作权限差异，具体如下： 表7不同角色对云端规则的操作权限说明 | 角色 | 企业级规则 | 团队级规则 | 个人级规则 | |:---|:---|:---|:---| | 企业管理员 | 可对所有规则执行全量操作。 | 可对所有规则执行全量操作。 | 可对所有规则执行除编辑以外的操作，仅能对本人创建的规则进行编辑。 | | 团队管理员 | 可对所有规则执行以下操作： - 查看云端规则详情。 - 收藏或取消收藏。 | 可对本团队成员（含团队管理员）创建的规则执行全量操作。 | 可对本人创建的规则执行全量操作。 | | 团队成员 | 可对所有规则执行以下操作： - 查看云端规则详情。 - 收藏或取消收藏。 | 可对本团队成员（含团队管理员）创建的规则执行以下操作： - 查看云端规则详情。 - 收藏或取消收藏。 | 可对本人创建的规则执行全量操作。 | | 企业成员 | 可对所有规则执行以下操作： - 查看云端规则详情。 - 收藏或取消收藏。 | 无任何操作权限。 | 可对本人创建的规则执行全量操作。 | ![](https://support.huaweicloud.com/usermanual-enterprise/public_sys-resources/note_3.0-zh-cn.png) 仅企业版（新版套餐）或基础版、专业版（旧版套餐），涉及[表7]的操作权限。 表8管理云端规则 | 操作 | 具体步骤 | |:---|:---| | 查看云端规则详情 | - 在控制台的"技能和规则中心 \> 规则"中，单击目标规则名称，查看云端规则详情。 - 在客户端的"设置 \> 技能与规则"页面的对应规则页签（企业级/团队级/个人级）中，将鼠标悬浮在目标规则上，然后单击 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693563634.png)，查看云端规则的内容。 | | 编辑云端规则 | 1. 在控制台的"技能和规则中心 \> 规则"中，查看目标规则的状态。 - 如果为已启用，需先停用该规则，然后才能执行编辑操作。 - 如果为已停用，执行下一步编辑规则。 2. 单击目标规则后的"编辑"，即可对规则进行修改。 | | 删除指定云端规则 | 1. 在控制台的"技能和规则中心 \> 规则"中，查看目标规则的状态。 - 如果为已启用，需先停用该规则，然后才能执行删除操作。 - 如果为已停用，执行下一步删除规则。 2. 单击目标规则后的"删除"，即可对规则进行删除。 目标规则已从规则列表中移除，表示规则删除成功。 注意： 规则删除后，使用该规则的智能体将受到影响，且删除的规则不可恢复，请谨慎操作。 | | 启用或停用指定云端规则 | 在控制台的"技能和规则中心 \> 规则"中，单击目标规则后的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693723508.png) / ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723243067.png)，启用或停用云端规则。 **已启用的规则才会同步至客户端中。** | | 收藏或取消收藏指定云端规则 | 在控制台的"技能和规则中心 \> 规则"中，单击目标规则后的"收藏"/"取消收藏"，即可收藏或取消收藏该规则。 在"我收藏的"页面查看已收藏的规则。 | | 批量删除云端规则 | 1. 在控制台的"技能和规则中心 \> 规则"中，查看目标规则的状态。 - 如果为已启用，需先停用该规则，然后才能执行删除操作。 - 如果为已停用，执行下一步删除规则。 2. 勾选目标规则，单击右上角的"更多 \> 批量删除"，弹出确认批量删除对话框。 3. 输入"DELETE"或单击"一键输入"，然后单击"确定"，完成规则的批量删除。 目标规则已从规则列表中移除，表示规则删除成功。 注意： 规则删除后，使用该规则的智能体将受到影响，且删除的规则不可恢复，请谨慎操作。 | | 批量启用或停用云端规则 | 在控制台的"技能和规则中心 \> 规则"中，勾选目标规则，单击右上角的"批量启用"或"更多 \> 批量停用"，批量启用或停用云端规则。 **已启用的规则才会同步至客户端中。** | | 批量收藏或取消收藏云端规则 | 在控制台的"技能和规则中心 \> 规则"中，勾选目标规则，单击右上角的"更多 \> 批量收藏"/"更多 \> 批量取消收藏"，即可批量收藏或取消收藏目标规则。 在"我收藏的"页面查看已收藏的规则。 | | 修改云端企业级/团队级规则的适用范围 | 在华为云码道代码智能体IDE设置页面的"技能与规则 \> 企业级 \> 规则"/"技能与规则 \> 团队级 \> 规则"中，单击目标规则后的开关即可修改适用范围。 - ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723362983.png)：规则适用范围为"手动触发"，需要您手动触发才能生效。 - ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693563636.png)：规则适用范围为"自动应用"，由系统自动识别并触发生效。 | | 批量修改云端企业级/团队级规则的适用范围 | 1. 在华为云码道代码智能体IDE设置页面的"技能与规则 \> 企业级 \> 规则"/"技能与规则 \> 团队级 \> 规则"中，单击右上角的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693723510.png)。 2. 勾选目标规则，选择右上角的"开启"或"关闭"，批量修改规则的适用范围。 |