# 文件夹介绍

## rules 文件夹

rules 是指编辑器根据一定条件自动读取的对 AI 的要求

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

### 规则类型：全局使用 `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-child.mdc)
- [公共组件](/src/components/_cursor.ai/rules/type-component-pub.mdc)

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

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

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

## prompts 文件夹

prompts 是我们主动提问，和我们在聊天窗口叫 ai 干活一样  
区别是对于经常执行的有具体要求的操作，固定下来方便反复使用

## 文档文件夹

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

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