而配置规则（Rules）正是助力 AI 编程场景中进行上下文优化的重要工具，它能将你的项目规范、组件偏好、命名约定等转变为机器可读的规则，持续作为上下文融入 AI 的生成逻辑。通过为文心快码的编程智能体 Zulu 配置规则，开发者能够向 Zulu 清晰说明代码库的构成、各个名词的意义、关键代码的位置以及常见场景的代码写法。此外，还能有效控制 Zulu 的生成过程，限制它的错误输出。有了这些明确的规则，Zulu 就能更好地理解你的需求，实现复杂、重复和情境化的需求一键复用，真正让“指令式对话”转变为“协同式开发”，使得 AI 编程智能体具备工程师的思维方式。
一、Rules 功能的应用场景
在实际开发中，Zulu 的规则功能能够广泛应用于以下几种典型场景：
1. 项目初始化与结构规范
通过设定规则来预设框架选择、目录结构及命名习惯，Zulu 能够自动把新功能模块放到合适的位置，确保代码的整洁和一致性。
例如，当你新增一个页面时，系统会自动将其放置在 pages/xxx/index.tsx，并按照团队的规范命名组件和样式。
2. 统一接口与服务管理
设定接口的命名和注册规则后，Zulu 在生成接口时会自动完成统一挂载、类型定义和错误处理逻辑，从而降低维护成本。
比如，新增的 API 会同步写入 api/index.ts 和统一错误处理模块。
3. 测试与文档自动补全
规则可以指定测试文件的生成路径和模板，或者要求在生成组件或方法时同时补充注释和文档说明，从而提高工程的可维护性。
例如，生成函数时自动添加 JSDoc，或者同步生成 Jest 测试文件。
4. 团队协作与开发风格约定
通过规则固定代码风格（如命名、缩进和注释习惯等），Zulu 可以作为“代码守门人”，帮助新成员迅速适应团队的标准。
例如，强制使用驼峰命名，禁止使用某些不推荐的 API。
二、使用指南
新建 Rules
1. 进入规则设定页面：在文心快码插件或 Comate AI IDE 中，点击右上角的更多「…」选项，然后选择「规则」进入规则设定页面。
2. 在设置中查看所有规则及其状态的列表。
3. 新建规则：进入规则设定页面后，点击右上角的「+ 新建」按钮，添加新规则，并为其命名和选择生效范围。
4. 直接新建规则文件：你也可以在 .comate/rules 路径下直接创建格式为 *.mdr 的文件。
5. 编写规则内容：在 *.mdr 的规则文件中，使用清晰、明确的自然语言，可以按 Markdown 格式组织内容，编写你希望 AI 在处理此项目时必须遵循的指令、约束或偏好设置。编写后记得保存文件。
设置多 Rules
在规则设定页面，你可以根据需求设置不同的规则和生效方式。Zulu 在后续与该项目相关的交互中，将自动加载并遵循设定的规则。
兼容 Cursor Rules
Zulu 可以自动获取你在 Cursor 中设定的规则，不需要在文心快码中重复添加。
注意：
1. Zulu 无法通过图形化界面编辑 Cursor 规则的生效范围，需通过文件编辑器进行修改。
2. 目前不支持获取 Cursor Rules 的子目录。
使用规则
每个规则文件都是一个 .mdr 格式的文档，可以将生效信息和规则内容放在一个文件中。当前支持以下生效方式：
1. 如果你希望规则仅在本地开发环境生效，不想通过版本控制分享给团队其他成员（例如，一些个人编码习惯或临时性的指令），可以将 .comate/rules/ 文件路径添加到项目的目录文件中。这样，Git 等版本控制系统就会忽略这些文件的变动。
2.始终生效的规则每次对话都会调用，就像刻入了 Zulu 的 DNA，无论在哪里都适用，无需持续关注。
3. 指定文件生效的规则仅在上下文中包含特定文件时生效，Zulu 会根据过去或当前对话中已添加的文件判断哪些规则生效，指定文件支持通配符+文件路径/文件格式（如 *.py 或 client/*/*.tsx）。
4.手动生效的规则需要用到的时候，在对话框中#此规则进行使用即可，随用随取（例如在对话中#rulename）。
注意：你可以手动选择所有设定的规则，但是否在会话中生效，还是要看具体的设定内容。例如，规则指定文件为 *.py，但当前对话上下文中并未包含 *.py 的文件，那么这个规则仍然不会生效。
三、实战演练
跟我们一起动手，了解Zulu的开发规范吧！
接下来，咱们一起来练习一下，看看Zulu是如何在规则框架内，根据项目规范进行开发的。这里有个示例项目async-iterator [https://github.com/otakustay/async-iterator]，它是个处理异步数据流的工具库，里面默认提供了一些数据操作符，比如：
-
chunk.ts: 数据分块
-
debounce.ts: 防抖处理
-
filter.ts: 数据过滤
-
map.ts: 数据转换
-
take.ts: 取前N个元素
-
until.ts: 条件终止
接下来，我们要为这个项目添加一个skip操作符，来看看Zulu如何在这些规定下生成更高质量的代码。
示例规则
下面是一些示例规则，定义了项目的开发规范。我们先来看看每一部分都给Zulu约定了什么：
1. 项目概述
用一句话简单明了地告诉Zulu：“这是一个处理异步数据流的工具库，目的是让JS/TS中的async iterable使用起来更简单。” 这样一来，AI就能快速理解这个项目的核心目标。
2. 项目架构
清楚地列出项目各模块的功能和文件路径，比如控制器、工厂方法、操作符等。这样能帮助Zulu更好地理解“不同类型的代码该放在哪”，避免写代码时的“乱七八糟”。
3. 代码结构说明
这里分成两部分：
核心接口：定义了OverAsyncIterator接口，即链式操作符的标准格式，让AI知道如何设计新方法。
工厂函数：列出可用的数据源工厂（如数组、事件、流等），提醒AI在创建新流时如何复用已有的模式。
4. 开发指南
这是最重要的一部分，规定了项目扩展的标准流程。
“基本流程”告诉Zulu新增操作符该放在哪、如何导出以及如何支持链式调用。
“扩展指南”更详细地列出了每个步骤，比如添加操作符时需要修改哪些文件，确保它能“按规矩出牌”，不会遗漏重要环节。
“测试规范”则告诉Zulu，功能必须有测试，测试要符合命名和结构规范，并且不能降低覆盖率标准，这样才能确保自动生成的代码顺利通过项目的CI要求。
5. 代码风格指南
设定了统一的代码风格：
-
类型使用interface
-
多用泛型以提高复用性
-
错误统一使用Error对象处理
-
命名采用驼峰命名法（函数名小驼峰、类名大驼峰）
有了这些规范，AI生成的代码就能和团队现有的代码风格保持一致，不会出现“风格跑偏”的情况。
6. 注意事项
列出一些“隐性规范”，就像资深工程师的开发经验：
-
异步代码要妥善捕获错误
-
注意事件监听器可能导致的内存泄漏
-
接口不要随意破坏兼容性
-
写清楚注释，避免副作用，提高可测试性
这些细节告诉AI：你不仅仅是来“生成代码”的，而是要像真正的工程师一样思考和交付。
## 项目概述这是一个用于处理异步迭代的工具库，提供了一系列用于处理异步数据流的工具和操作符。该项目主要解决了在JavaScript/TypeScript中处理异步数据流的复杂性问题，提供了简单易用的API。## 项目架构项目采用模块化设计，主要分为以下几个核心部分：1. **核心控制器** (`controller.ts`) - 实现了 `AsyncIteratorController` 类 - 负责管理异步数据流的状态和控制 - 提供了数据的输入输出接口2. **工厂模块** (`factory/`) - `array.ts`: 处理数组的异步迭代 - `event.ts`: 处理事件源的异步迭代 - `reader.ts`: 处理流读取器的异步迭代 - `stream.ts`: 处理Node.js流的异步迭代3. **辅助工具** (`helper/`) - 提供了一系列操作符来处理异步迭代器 - 实现了链式调用API - 包含多个独立的操作符实现4. **操作符** (`helper/operators/`) - `chunk.ts`: 数据分块 - `debounce.ts`: 防抖处理 - `filter.ts`: 数据过滤 - `map.ts`: 数据转换 - `take.ts`: 取前N个元素 - `until.ts`: 条件终止## 代码结构说明### 1. 核心接口typescriptinterface OverAsyncIterator extends AsyncIterable { filter(predicate: Predicate): OverAsyncIterator; map(transform: (value: T) => R): OverAsyncIterator; chunk(size: number): OverAsyncIterator; debounce(ms: number): OverAsyncIterator; take(count: number): OverAsyncIterator; until(predicate: Predicate): OverAsyncIterator;}### 2. 工厂函数项目提供了多个工厂函数来创建异步迭代器：- `fromIntervalEach`: 从数组创建带间隔的异步迭代器- `fromEvent`: 从事件源创建异步迭代器- `fromStreamReader`: 从流读取器创建异步迭代器- `fromStream`: 从Node.js流创建异步迭代器## 开发指南### 1. 基本开发流程1. 如需增加运算符，放置在`src/helper/operators`目录下。2. 所有运算符都要从`src/helper/index.ts`导出，并能够链式调用。3. 如果增加对流的消费、创建流的方式，放置在`src/factory`目录下。### 2. 扩展开发指南1. **添加新的工厂函数** - 在 `factory/` 目录下创建新文件 - 实现相应的工厂函数 - 在 `index.ts` 中导出2. **添加新的操作符** - 在 `helper/operators/` 目录下创建新文件 - 实现操作符函数 - 在 `helper/index.ts` 中添加到 `OverAsyncIterator` 接口 - 在 `over` 函数中实现新方法### 3. 测试规范- 所有功能都需要编写对应的单元测试- 测试文件放置在相应模块的 `__tests__` 目录下- 测试文件命名规则：`[功能名].test.ts`- 增加任何功能，都要运行单元测试，确保测试的行覆盖率在100%，分支覆盖率大于90%。## 代码风格指南1. **类型定义** - 优先使用接口（interface）定义类型 - 为所有公开API提供完整的类型定义 - 使用泛型增加代码复用性2. **错误处理** - 统一使用 Error 对象处理错误 - 在异步操作中正确处理错误传播3. **命名规范** - 使用驼峰命名法 - 类名使用大驼峰 - 接口名清晰表达其用途## 注意事项1. 所有的异步操作都应该正确处理错误情况2. 注意内存泄漏，特别是在处理事件监听器时3. 在实现新功能时，确保与现有的接口保持一致4. 保持代码的可测试性，避免副作用5. 文档注释要清晰完整，包含参数说明和使用示例
操作步骤
1. 打开Comate AI IDE
2. 点击右上角的更多选项，找到「规则」
3. 添加新规则，命名为：async-iterator-rule，并设置为「始终生效」
4. 将规则文件的内容添加进去
5. 输入指令：新增一个skip操作符，完成所需任务
6. 检查生成的代码是否严格遵循项目规范
效果对比
在设定好规则的情况下
1. 我们要求Zulu新增一个skip操作符
2. 项目规则中明确规定了添加新操作符的规范，要求新的操作符必须在OverAsyncIterator接口中注册
3. Zulu在生成过程中，遵循了这个规范
4. 最后，Zulu成功将skip操作符注册到了OverAsyncIterator接口，符合要求
如果没有这个规则，AI就不会严格按照项目规范生成代码，用户可能需要花费更多时间去修正AI生成的代码。
1. 我们要求Zulu新增一个skip操作符，但项目中没有配置规则
2. Zulu在生成代码时，没有意识到新的操作符必须在OverAsyncIterator接口中注册这个要求
3. 最后，AI按照自己的理解生成了一个新的index.js文件，而没有在现有的index.js中进行注册，这违反了项目规范
在AI编程越来越普及的今天，Prompt只是基础指令，而Rules则是更高级的语法。它不仅能让AI更明白你的意思，也让你的项目更加稳定和可靠。现在，试试为你的Zulu配置一条规则，看看它能有多聪明！如果你手头已经有实用的规则设置，欢迎在评论区或社区分享你的经验，帮助更多开发者探索AI编程的新可能，把Zulu培养成真正的AI工程师。
如果你觉得这个内容对你有帮助，记得关注文心快码，这里有更多干货等着你！
