文档首页/华为云码道（CodeArts）代码智能体/用户指南/上下文/规则
更新时间：2026-03-26 GMT+08:00
查看PDF
分享

规则

通过自定义规则（Rules），可以帮助AI更好地理解并遵循规范。这些规则可由智能体自动加载或调用，并能与代码库保持同步，确保一致性与准确性。

表1 规则与其他功能的对比

对比维度

规则（Rule）

技能（Skill）

MCP Server

定义

用于约束智能体的行为方式。

用于描述如何完成特定任务。

提供外部工具的调用能力。

加载方式

在对话开始时加载到上下文中，持续参与推理。

按需加载，减少上下文占用。

不参与推理过程，按需调用外部接口。

使用场景

定义代码规范、输出格式、团队协作约定等。

例如：代码必须符合PEP8规范。

封装测试流程、开发任务、复杂业务逻辑等。

例如：执行UI自动化测试。

连接外部系统，执行具体操作。

例如：控制浏览器操作。

关键区别

控制智能体“应该怎么做”，是行为边界。

解决“如何完成任务”，是流程指导。

提供“调用工具的能力”，是执行能力。

约束与限制

在JetBrains系列开发工具（如IntelliJ IDEA）中，当模型选择UT智能体时，不支持创建规则。

规则分类

华为云码道（CodeArts）代码智能体支持项目级和个人级两种规则配置模式。用户可根据具体开发场景与协作需求，选择最适合的规则层级进行设置，实现灵活高效的代码管理。

表2 规则分类

规则类型

说明

项目级

仅针对当前项目的规则，随代码库分发，存于本地。不同工具的规则文件在本地存储的位置有所不同。

  • 华为云码道IDE和Visual Studio Code的规则文件路径：./.codeartsdoer/rule
  • JetBrains系列的规则文件路径：./.codeartsdoer/complex_code_task/expertises

个人级

个人习惯或特定偏好的规则，仅对本人生效，个人级规则存储在规则中心。

创建规则

华为云码道支持项目级与个人级两类规则配置，您可以根据开发场景与协作需求灵活选择，实现高效、精准的代码管理。

专为当前项目定制的规则配置，随代码库一并分发，确保团队成员在统一规范下协作开发，提升一致性与交付效率。

  1. 参考快速启动操作，登录华为云码道。
  2. 打开华为云码道聊天窗口。

    • 华为云码道IDE：单击IDE顶部菜单栏中的展开AI侧栏图标 ，打开华为云码道聊天窗口。
    • Visual Studio Code：单击Visual Studio Code侧边栏图标 ，打开华为云码道聊天窗口。
    • JetBrains：以IntelliJ IDEA为例，单击IntelliJIDEA侧边栏图标 ，打开华为云码道聊天窗口。

    不同工具中华为云码道的界面风格有所差异，本章以其在IDE工具中的界面为例进行介绍，实际操作请以所用工具的显示为准。

  3. 在聊天界面中，单击设置图标 ，进入智能体设置页面。
  4. 新建项目级规则。

    1. 选择“技能与规则”，在项目级页签中单击规则后的 。
    2. 设置规则参数，单击“确定”，完成规则的创建。
      图1 新建项目级规则
      表3 新建项目级规则参数说明

      参数

      说明

      规则名称

      新建规则的名称。

      命名规范：长度不能超过64个字符，且禁止包含特殊字符\/:*?"<>|

      适用范围

      指定规则的适用范围，即规则在哪里生效。

      • 自动应用：规则将默认应用于所有会话，包括华为云码道编辑区，系统自动识别，无需重复配置。
      • 手动触发：规则不会自动生效。用户需在对话中输入“#”，并从列表中选择特定规则，方可启用。
    3. 项目级规则创建完成后，存放路径如表4所示。
      表4 项目级规则存放路径

      工具名称

      路径

      华为云码道IDE

      项目目录的./.codeartsdoer/rule

      Visual Studio Code

      项目目录的./.codeartsdoer/rule

      JetBrains（以IntelliJ IDEA为例）

      项目目录的./.codeartsdoer/complex_code_task/expertises

  5. 定义具体的规则，让智能体在特定条件下自动做出一致、可预测的响应或行为。

    在规则文件中，配置您想要的规则，按快捷键（Windows/Linux：“Ctrl+S”；macOS:“Command(⌘)+S”）保存。

    图2 添加具体规则

个人规则根据您的使用习惯和偏好设定，华为云码道将始终遵循这些规则，在所有项目中为您提供更贴合个人风格的输出。

方式一：在华为云码道创建个人级规则

  1. 参考快速启动操作，登录华为云码道。
  2. 打开华为云码道聊天窗口。
    1. 华为云码道IDE：单击IDE顶部菜单栏中的展开AI侧栏图标 ，打开华为云码道聊天窗口。
    2. Visual Studio Code：单击Visual Studio Code侧边栏图标 ，打开华为云码道聊天窗口。
    3. JetBrains：以IntelliJ IDEA为例，单击IntelliJIDEA侧边栏图标 ，打开华为云码道聊天窗口。

    不同工具中华为云码道的界面风格有所差异，本章以其在IDE工具中的界面为例进行介绍，实际操作请以所用工具的显示为准。

  3. 在聊天界面中，单击设置图标 ，进入智能体设置页面。
  4. 选择“技能与规则”，在个人级页签中单击规则后的 。
  5. 设置规则参数，单击“确定”，完成规则的创建。
    图3 新建个人级规则
    表5 新建个人级规则参数说明

    参数

    说明

    规则名称

    新建规则的名称。

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

    适用范围

    指定规则的适用范围，即规则在哪里生效。

    • 自动应用：规则将默认应用于所有会话，包括华为云码道编辑区，系统自动识别，无需重复配置。
    • 手动触发：规则不会自动生效。用户需在对话中输入“#”，并从列表中选择特定规则，方可启用。

    内容

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

方式二：在华为云码道服务控制台创建个人级规则

  1. 单击规则中心，进入技能和规则页面。
  2. 单击“新建个人规则”，参照表6设置个人规则。
    表6 新建个人级规则参数说明

    参数

    说明

    名称

    新建规则的名称。

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

    内容

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

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

    使用范围

    指定规则的适用范围，即规则在哪里生效。

    • 自动应用：规则将默认应用于所有会话，包括华为云码道编辑区，系统自动识别，无需重复配置。
    • 手动触发：规则不会自动生效。用户需在对话中输入“#”，并从列表中选择特定规则，方可启用。

    可用范围

    个人级规则的使用范围，仅限本人使用，不会共享给其他用户。

    标签

    为规则配置业务领域的标签，请在下拉菜单中选择对应的标签分类。

    简要描述

    请输入规则的描述信息，长度不能超过1024个字符。

  3. 单击“确定并发布”，完成规则的创建和发布。

    在规则列表中可查看到已创建的个人级规则，且状态为“已发布”。

    图4 查看已创建的规则

在对话中引用规则

  • 自动应用类型的规则：默认对所有会话生效（包括华为云码道编辑区），无需重复设置，如图5。
    图5 规则已生效
  • 手动触发类型的规则：在对话中输入“#”，然后选择已创建的规则，规则才能生效。
    图6 添加上下文选择规则
    图7 规则在对话中生效

管理规则

  • 编辑或删除项目级规则：在华为云码道设置页面的“技能与规则 > 项目级 > 规则”中，将鼠标悬浮在规则上，单击 或 ，即可对规则进行编辑或删除。
    图8 编辑或删除项目级规则
  • 编辑或删除个人级规则：您可以通过以下两种方式对个人级规则进行编辑或删除，根据实际需求选择合适的方式操作即可。
    • 方式一：在华为云码道设置页面的“技能与规则 > 个人级 > 规则”中，将鼠标悬浮在规则上，单击 或 ，即可对规则进行编辑或删除。
      图9 在华为云码道设置页面编辑和删除规则
    • 方式二：在规则中心对个人级规则进行编辑和删除，操作前需要先将规则下线。
      图10 在规则中心编辑和删除个人级规则
父主题： 上下文

相关文档