# 文件夹介绍

## rules 文件夹

rules 是指 AI 根据一定条件自动读取的工作环境设定，是我们控制项目代码生成质量的重要手段

### 规则类型：全局使用 `Always` 

所有的聊天（Agent、Ask、Edit）和 ctrl+k 编辑，都会参考此规则生成代码

- [系统角色](/src/components/_cursor.ai/rules/all-system-role.mdc)
- [项目介绍](/src/components/_cursor.ai/rules/all-project-info.mdc)
- [开发规范](/src/components/_cursor.ai/rules/all-dev-specification.mdc)

### 规则类型：按路径匹配 `Auto-Attached`

当文件名称或路径匹配上时，会参考此规则生成代码

- [请求集](/src/components/_cursor.ai/rules/type-fetchers.mdc)
- [数据控制器](/src/components/_cursor.ai/rules/type-pilot.mdc)
- [界面](/src/components/_cursor.ai/rules/type-surface.mdc)
- [子组件&公共组件](/src/components/_cursor.ai/rules/type-component.mdc)

### 规则类型：自主决定 `Agent-Requested`

在 Agent 模式下，由 AI 根据 Description 的文字描述，自主决定是否需要参考此规则生成代码  
非 Agent 模式需要我们自己 @ 此规则才能生效

- [请求集基类](/src/components/_cursor.ai/rules/fit-base-fetcher.mdc)
- [数据控制器基类](/src/components/_cursor.ai/rules/fit-base-pilot.mdc)
- 表单验证规则

> 注意：rules 文件夹需要进行初始化  
> 请双击项目根目录文件 `link-rules.cmd` 执行命令，将公共资源目录中的 rules 链接到编辑器中  
> 然后在编辑器设置中查看是否链接成功（CursorSetting > Rules > ProjectRules）

## prompts 文件夹

prompts 存放我们主动提出的指令  
和我们在聊天窗口要求 ai 完成工作一样，就是对需要经常执行的有具体要求的操作，存下来方便反复使用

## 文档文件夹

公共组件库组件对应的文档

| 文档目录      | 对应的组件目录          |
| ------------- | ----------------------- |
| `common.doc`  | src/components/common/  |
| `forms.doc`   | src/components/forms/   |
| `layout.doc`  | src/components/layout/  |
| `plugins.doc` | src/components/plugins/ |