文档首页/ 华为云码道CodeArts代码智能体/ 用户指南（控制台）/ 智能体设置/ 管理技能和规则中心
更新时间：2026-09-04 GMT+08:00
查看PDF
分享

管理技能和规则中心

技能和规则中心用于统一管理云端技能和云端规则。您可在控制台对云端技能和规则执行创建、编辑、启用和删除等操作，创建后的技能和规则可同步至华为云码道代码智能体客户端使用。

华为云码道代码智能体支持创建本地和云端两种类型的技能和规则：本地技能和规则在客户端创建，云端技能和规则在控制台创建，其中云端个人级规则既可在云端创建，也支持在本地客户端创建。

本章节介绍企业成员在控制台管理云端技能和规则的操作，如需在客户端管理技能和规则，请参考技能和规则。

技能的目录结构

技能是一个包含必需的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. 套餐版本是否为新版套餐的个人版（个人体验版、个人标准版、个人高级版、个人旗舰版）？

  2. 在左侧导航栏选择“智能体设置 > 技能和规则中心”，进入技能和规则列表页面。
  3. 在“技能”页签，单击右上角的“新建技能”，弹出“新建技能”对话框。
  4. 在蓝色框区域单击鼠标右键，从本地上传技能zip包。或将本地技能zip包直接拖入蓝色框区域，然后单击“确定”。

    • 技能zip包需符合技能的目录结构，否则可能会导入失败。例如，每个技能文件夹的根目录均须包含对应的SKILL.md文件，此文件中须包含YAML格式的技能名称与描述等。
    • 每次仅支持上传一个zip包，包内可存放多个技能文件夹，且包的总大小不能超过5M。
    图1 新建技能

  5. 参考表3设置云端技能参数。

    图2 新建云端技能
    表3 云端技能参数说明

    参数

    说明

    更换

    若您需要重新上传技能zip包，单击“更换”，参考4重新上传zip包。

    可用范围

    仅企业版（新版套餐）或基础版、专业版（旧版套餐），支持配置该参数。

    • 个人：仅限本人使用，不会共享给其他用户。
    • 团队：指定的团队可用，企业管理员或团队管理员可创建。
    • 企业：整个企业所有成员都可用，仅企业管理员可创建。

    可用团队

    仅“可用范围”设置为“团队”时，展示此参数。

    在下拉列表中选择团队。若尚未创建团队，请先创建团队。

    企业管理员可查看并选择所有团队，团队管理员仅可查看并选择其所属团队。

    标签

    可选，华为云码道代码智能体已预置了几类标签，请根据实际需求在下拉列表中选择。

  6. 单击“确定并启用”，完成技能的创建。

    在“技能”页签中，查看新创建的技能。如需立即在本地客户端中查看云端创建的技能，请在“设置 > 技能与规则”页面的对应技能页签（企业级/团队级/个人级）中，单击技能后的 或“ > 刷新”，同步云端技能到本地客户端。

    • 客户端每24小时自动同步一次云端技能。
    • 客户端仅同步已启用的技能。

管理云端技能

表4展示了不同角色对管理云端技能的操作权限差异，具体如下：

表4 不同角色对云端技能的操作权限说明

角色

企业级技能

团队级技能

个人级技能

企业管理员

可对所有技能执行全量操作。

可对所有技能执行全量操作。

可对所有技能执行除编辑以外的操作，仅能对本人创建的技能进行编辑。

团队管理员

可执行以下操作：

  • 查看云端技能详情。
  • 收藏或取消收藏。

可对本团队成员（含团队管理员）创建的技能执行全量操作。

可对本人创建的技能执行全量操作。

团队成员

可执行以下操作：

  • 查看云端技能详情。
  • 收藏或取消收藏。

可对本团队成员创建的技能执行以下操作：

  • 查看云端技能详情。
  • 收藏或取消收藏。

可对本人创建的技能执行全量操作。

企业成员

可执行以下操作：

  • 查看云端技能详情。
  • 收藏或取消收藏。

无任何操作权限。

可对本人创建的技能执行全量操作。

仅企业版（新版套餐）或基础版、专业版（旧版套餐），涉及表4的操作权限。

表5 管理云端技能

操作

具体步骤

查看云端技能详情
  • 在控制台的“技能和规则中心 > 技能”中，单击目标技能名称，查看云端技能详情。
  • 在客户端的“设置 > 技能与规则”页面的对应技能页签（企业级/团队级/个人级）中，将鼠标悬浮在目标技能上，然后单击 ，查看云端技能详情。

编辑云端技能
  1. 在控制台的“技能和规则中心 > 技能”中，查看目标技能的状态。
    • 如果为已启用，需先停用该技能，然后才能执行编辑操作。
    • 如果为已停用，执行下一步编辑技能。
  2. 单击目标技能后的“编辑”，即可对技能进行修改。

删除指定云端技能
  1. 在控制台的“技能和规则中心 > 技能”中，查看目标技能的状态。
    • 如果为已启用，需先停用该技能，然后才能执行删除操作。
    • 如果为已停用，执行下一步删除技能。
  2. 单击目标技能后的“删除”，即可对技能进行删除。

    目标技能已从技能列表中移除，表示技能删除成功。

注意：

技能删除后，使用该技能的智能体将受到影响，且删除的技能不可恢复，请谨慎操作。

启用或停用指定云端技能

通过以下任意一种方法启用或停用指定云端技能。

  • 在控制台的“技能和规则中心 > 技能”中，单击目标技能后的 / ，启用或停用云端技能。已启用的技能才会同步至华为云码道代码智能体客户端中。
  • 在客户端的“设置 > 技能与规则”页面的对应技能页签（企业级/团队级/个人级）中，可通过开关启用或停用云端技能。

收藏或取消收藏指定云端技能

在控制台的“技能和规则中心 > 技能”中，单击目标技能后的“收藏”/“取消收藏”，即可收藏或取消收藏该技能。

在“我收藏的”页面查看已收藏的技能。

批量删除云端技能
  1. 在控制台的“技能和规则中心 > 技能”中，查看目标技能的状态。
    • 如果为已启用，需先停用该技能，然后才能执行删除操作。
    • 如果为已停用，执行下一步删除技能。
  2. 勾选目标技能，单击右上角的“更多 > 批量删除”，弹出确认批量删除对话框。
  3. 输入“DELETE”或单击“一键输入”，然后单击“确定”，完成技能的批量删除。

    目标技能已从技能列表中移除，表示技能删除成功。

批量启用或停用云端技能

通过以下任意一种方法批量启用或停用云端技能。

  • 在控制台的“技能和规则中心 > 技能”中，勾选目标技能，单击右上角的“批量启用”或“更多 > 批量停用”，批量启用或停用云端技能。已启用的技能才会同步至华为云码道代码智能体客户端中。
  • 在客户端的“设置 > 技能与规则”页面的对应技能页签（企业级/团队级）中，单击右上角的 。勾选目标技能，选择右上角的“开启”或“关闭”，批量启用或停用云端技能。
  • 在客户端的“设置 > 技能与规则 > 个人级”中，单击右上角的“ > 批量操作”。勾选目标技能，选择右上角的“开启”或“关闭”，批量启用或停用云端技能。

批量收藏或取消收藏云端技能

在控制台的“技能和规则中心 > 技能”中，勾选目标技能，单击右上角的“更多 > 批量收藏”/“更多 > 批量取消收藏”，即可收藏或取消收藏目标技能。

在“我收藏的”页面查看已收藏的技能。

创建云端规则

  1. 套餐版本是否为新版套餐的个人版（个人体验版、个人标准版、个人高级版、个人旗舰版）？

  2. 在左侧导航栏选择“智能体设置 > 技能和规则中心”，进入技能和规则列表页面。
  3. 在“规则”页签，单击右上角的“新建规则”，弹出“新建规则”对话框。
  4. 参考表6设置规则参数。

    图3 新建云端规则
    表6 云端规则参数说明

    参数

    说明

    名称

    新建规则的名称。

    命名规范：长度1~64字符，且仅允许包含字母、数字、下划线、中文、连字符（-）和点号。

    内容

    自定义一条或多条规则的内容，长度不超过50000个字符。

    例如，始终使用Python语言回答。

    使用范围

    指定规则的适用范围，即规则生效的场景。

    • 自动应用：规则将默认应用于所有会话，由系统自动识别。
    • 手动触发：规则不会自动生效。用户需在聊天窗口的输入框中输入“#”，或单击 选择“添加上下文”，再选择“Rules”并从列表中选择特定规则，方可启用。

    可用范围

    仅企业版（新版套餐）或基础版、专业版（旧版套餐），支持配置该参数。

    • 个人：仅限企业成员本人使用。
    • 团队：指定团队的所有成员可用，企业管理员或团队管理员可创建。
    • 企业：所有企业成员都可用，仅企业管理员可创建。

    可用团队

    仅“可用范围”设置为“团队”时，展示此参数。

    在下拉列表中选择团队。若尚未创建团队，请先创建团队。

    企业管理员可查看并选择所有团队，团队管理员仅可查看并选择其所属团队。

    标签

    可选，华为云码道代码智能体已预置了几类标签，请根据实际需求在下拉列表中选择。

    简要描述

    可选，规则的描述信息，长度不能超过1024个字符。

  5. 单击“确定并启用”，完成规则的创建。

    在“规则”页签中，查看新创建的规则。如需立即在客户端查看云端创建的规则，请在“设置 > 技能与规则”页面的对应规则页签（企业级/团队级/个人级）中，单击规则后的 ，同步云端规则到客户端。

    • 客户端每24小时自动同步一次云端规则。
    • 客户端仅同步已启用的规则。

管理云端规则

表7展示了不同角色对管理云端规则的操作权限差异，具体如下：

表7 不同角色对云端规则的操作权限说明

角色

企业级规则

团队级规则

个人级规则

企业管理员

可对所有规则执行全量操作。

可对所有规则执行全量操作。

可对所有规则执行除编辑以外的操作，仅能对本人创建的规则进行编辑。

团队管理员

可对所有规则执行以下操作：

  • 查看云端规则详情。
  • 收藏或取消收藏。

可对本团队成员（含团队管理员）创建的规则执行全量操作。

可对本人创建的规则执行全量操作。

团队成员

可对所有规则执行以下操作：

  • 查看云端规则详情。
  • 收藏或取消收藏。

可对本团队成员（含团队管理员）创建的规则执行以下操作：

  • 查看云端规则详情。
  • 收藏或取消收藏。

可对本人创建的规则执行全量操作。

企业成员

可对所有规则执行以下操作：

  • 查看云端规则详情。
  • 收藏或取消收藏。

无任何操作权限。

可对本人创建的规则执行全量操作。

仅企业版（新版套餐）或基础版、专业版（旧版套餐），涉及表7的操作权限。

表8 管理云端规则

操作

具体步骤

查看云端规则详情
  • 在控制台的“技能和规则中心 > 规则”中，单击目标规则名称，查看云端规则详情。
  • 在客户端的“设置 > 技能与规则”页面的对应规则页签（企业级/团队级/个人级）中，将鼠标悬浮在目标规则上，然后单击 ，查看云端规则的内容。

编辑云端规则
  1. 在控制台的“技能和规则中心 > 规则”中，查看目标规则的状态。
    • 如果为已启用，需先停用该规则，然后才能执行编辑操作。
    • 如果为已停用，执行下一步编辑规则。
  2. 单击目标规则后的“编辑”，即可对规则进行修改。

删除指定云端规则
  1. 在控制台的“技能和规则中心 > 规则”中，查看目标规则的状态。
    • 如果为已启用，需先停用该规则，然后才能执行删除操作。
    • 如果为已停用，执行下一步删除规则。
  2. 单击目标规则后的“删除”，即可对规则进行删除。

    目标规则已从规则列表中移除，表示规则删除成功。

注意：

规则删除后，使用该规则的智能体将受到影响，且删除的规则不可恢复，请谨慎操作。

启用或停用指定云端规则

在控制台的“技能和规则中心 > 规则”中，单击目标规则后的 / ，启用或停用云端规则。

已启用的规则才会同步至客户端中。

收藏或取消收藏指定云端规则

在控制台的“技能和规则中心 > 规则”中，单击目标规则后的“收藏”/“取消收藏”，即可收藏或取消收藏该规则。

在“我收藏的”页面查看已收藏的规则。

批量删除云端规则
  1. 在控制台的“技能和规则中心 > 规则”中，查看目标规则的状态。
    • 如果为已启用，需先停用该规则，然后才能执行删除操作。
    • 如果为已停用，执行下一步删除规则。
  2. 勾选目标规则，单击右上角的“更多 > 批量删除”，弹出确认批量删除对话框。
  3. 输入“DELETE”或单击“一键输入”，然后单击“确定”，完成规则的批量删除。

    目标规则已从规则列表中移除，表示规则删除成功。

注意：

规则删除后，使用该规则的智能体将受到影响，且删除的规则不可恢复，请谨慎操作。

批量启用或停用云端规则

在控制台的“技能和规则中心 > 规则”中，勾选目标规则，单击右上角的“批量启用”或“更多 > 批量停用”，批量启用或停用云端规则。

已启用的规则才会同步至客户端中。

批量收藏或取消收藏云端规则

在控制台的“技能和规则中心 > 规则”中，勾选目标规则，单击右上角的“更多 > 批量收藏”/“更多 > 批量取消收藏”，即可批量收藏或取消收藏目标规则。

在“我收藏的”页面查看已收藏的规则。

修改云端企业级/团队级规则的适用范围

在华为云码道代码智能体IDE设置页面的“技能与规则 > 企业级 > 规则”/“技能与规则 > 团队级 > 规则”中，单击目标规则后的开关即可修改适用范围。

  • ：规则适用范围为“手动触发”，需要您手动触发才能生效。
  • ：规则适用范围为“自动应用”，由系统自动识别并触发生效。

批量修改云端企业级/团队级规则的适用范围
  1. 在华为云码道代码智能体IDE设置页面的“技能与规则 > 企业级 > 规则”/“技能与规则 > 团队级 > 规则”中，单击右上角的 。
  2. 勾选目标规则，选择右上角的“开启”或“关闭”，批量修改规则的适用范围。
父主题： 智能体设置

相关文档