UserRules

最新推荐文章于 2025-09-03 16:03:06 发布

原创最新推荐文章于 2025-09-03 16:03:06 发布 · 458 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#ai

Cursor UserRules：Excel / 代码转 Markdown 表格

规则概述

当用户提供 Excel 模板文件或代码文件后，自动读取内容并转换为 Markdown 表格，同时提取列含义和填写方法说明。

对于 Excel：读取表格数据，转换为 Markdown 格式，提取列说明。
对于代码（如 Vue、HTML 等前端代码）：解析页面元素及逻辑，转换为 Markdown 表格，结合代码逻辑补充列属性。
根据表头说明和内容信息，填充表格内容并生成填写说明。
最后生成的内容要是日语IT专业术语

一、表格转换通用规则

1. 内容来源识别

Excel 文件：默认读取第一个工作表（Sheet1），用户指定则优先；自动识别表头（多级表头取最后一级）和数据范围（忽略全空行 / 列）。
代码文件：支持 Vue、HTML 等前端代码，解析范围包括：
- <template>中的页面元素（输入框、按钮、表格列等）；
- <script>中的验证规则（如rules）、数据类型（如data()中的变量类型）、事件方法（如@click绑定的操作）。

2. Markdown 表格生成

基本格式：

| 表头1 | 表头2 | 表头3 |
|:---:|:---:|:---:|
| 数据1 | 数据2 | 数据3 |

表头规定：必须与读取的内容（Excel 表头 / 代码元素属性）保持一致。
对齐方式：默认居中对齐（|:---:|）。
特殊符号处理：保留原内容中的特殊符号（如-、_），不做额外处理。

二、列含义与填写方法说明

1. 标记方式

用户可通过以下方式标记列说明：

Excel 场景：表头上方注释行或文件内说明（冲突时以文件说明为主）。
代码场景：从代码注释（如// 账号输入框：必填）或元素属性（如placeholder="请输入账号"）中提取。

2. 输出格式

生成 Markdown 表格后，附加填写说明部分：

### 填写说明：
- **表头1**：说明内容（如必填/选填、格式要求等）
- **表头2**：说明内容

三、代码转换专项规则

1. 元素识别与映射

（1）核心元素提取优先级

项目名称（默认）：优先从label、placeholder、按钮文字（如el-button的text）提取；无明确文字时，从组件功能描述（如@click="addStaff"→“添加员工按钮”）推导。
形式：根据前端组件类型映射，具体对应关系如下：

形式标识	对应组件 / 元素	说明
L	静态文本标签	如`<span>账号</span>`、`<label>姓名</label>`
IP	输入类组件	如`el-input`、`el-select`、`el-date-picker`等输入交互元素
BT	按钮类组件	如`el-button`、`<button>`等可点击触发操作的元素
TB	表格列组件	如`el-table-column`、`<td>`等表格内数据列
IC	图标组件	如`el-icon-search`、`<i class="icon">`等纯图标元素

（2）列属性与代码来源对应关系

表格列	代码中提取来源	补充说明
数据类型	`<script>`中`data()`的变量类型（如`String`）、验证规则（如`rules`中的格式限制）	无明确类型时默认为 “-”
必須	从`rules`中的`required: true`判断；无规则时默认为 “否”	需区分 “前端验证必填” 与 “后端必填”，优先取前端规则
最大长度	从`rules`中的`min`和`max`提取（如`min:5, max:10`→“5-10 字符”）	单个字段的字符长度限制，区别于 “最大行数”（表格行数限制）
最大行数	从表格组件属性（如`max-height`关联的行数限制）提取	无限制时填 “-”
全半角	从`placeholder`或验证规则（如 “手机号需 11 位数字”→“数字”）提取	无特殊要求时填 “-”
位置	从`style`属性（如`margin-left:20px`、`width:300px`）或布局描述（如 “表单内，标签右侧”）提取	描述需简洁（例：“页面顶部左侧，搜索框右侧”）
登録	从按钮`@click`事件方法名（如`addStaff`、`submit`）判断，存在新增逻辑则为 “可”	无新增功能时填 “-”
編集	从按钮`@click`事件方法名（如`handleEdit`、`update`）判断，存在编辑逻辑则为 “可”	无编辑功能时填 “-”
承認	从按钮`@click`事件方法名（如`approve`）判断，存在审批逻辑则为 “可”	无审批功能时填 “-”
参照	从元素功能（如表格列、搜索框）判断，用于展示数据则为 “读” 或 “可”	无展示功能时填 “-”

2. 多文件 / 多表格处理

多文件转换：按文件分别生成表格，表格标题需包含文件名（例：“AddStaff.vue 转换表格”）。
多表格排列：同一文件内多个表格按出现顺序排列，存在层级关系时标注层级（例：“1. 主表格：员工信息”“2. 子表格：操作日志”）。

四、多语言输出规则

支持多语言（如日语、英语）输出，固定术语翻译对应关系：

中文术语	日语翻译	英语翻译
必填	必須	Required
选填	任意	Optional
可	可	Allowed
读	読	Read
正常	正常	Normal
禁用	無効	Disabled

五、特殊情况处理

场景	处理方式
如果不确定内容	直接在表格中填写“不确定，需要添加说明”
无有效表格数据（Excel）	提示：“未检测到表格数据，请确认 Excel 中包含内容”
无有效代码元素（代码）	提示：“未检测到可转换的页面元素，请确认代码包含前端组件”
未发现列说明标记	提示：“未找到列说明信息，是否需要补充？”
代码与 Excel 表格冲突	优先以用户指定的来源为准（需询问用户确认）