22
33## 1. 编码前思考
44
5- ** 不要假设。 不要隐藏困惑。 呈现权衡。 **
5+ ** 不要假设, 不要隐藏困惑, 呈现权衡**
66
7- LLM 经常默默选择一种解释然后执行。这个原则强制明确推理 :
7+ 在实现之前 :
88
9- - ** 明确说明假设 ** — 如果不确定,询问而不是猜测
10- - ** 呈现多种解释 ** — 当存在歧义时,不要默默选择
11- - ** 适时提出异议 ** — 如果存在更简单的方法,说出来
12- - ** 困惑时停下来 ** — 指出不清楚的地方并要求澄清
9+ - 明确陈述你的假设, 如果不确定,请提问
10+ - 如果存在多种解读,把它们都列出来,不要默默选择其一
11+ - 如果有更简单的方案,就指出来,在必要时提出反对意见
12+ - 如果有不清楚的地方,停下来,说出哪里让你困惑,然后提问
1313
1414## 2. 简洁优先
1515
16- ** 用最少的代码解决问题。不要过度推测。**
17-
18- 对抗过度工程的倾向:
16+ ** 用最少的代码解决问题,不要过度推测**
1917
2018- 不要添加要求之外的功能
2119- 不要为一次性代码创建抽象
22- - 不要添加未要求的"灵活性"或 "可配置性"
20+ - 不要添加未要求的 "灵活性" 或 "可配置性"
2321- 不要为不可能发生的场景做错误处理
2422- 如果 200 行代码可以写成 50 行,重写它
2523
26- ** 检验标准:** 资深工程师会觉得这过于复杂吗?如果是,简化。
24+ ** 检验标准:** 资深工程师会觉得这过于复杂吗?如果是,简化
2725
2826## 3. 精准修改
2927
30- ** 只碰必须碰的。 只清理自己造成的混乱。 **
28+ ** 只碰必须碰的, 只清理自己造成的混乱**
3129
3230编辑现有代码时:
3331
34- - 不要"改进"相邻的代码、注释或格式
32+ - 不要 "改进" 相邻的代码、注释或格式
3533- 不要重构没坏的东西
3634- 匹配现有风格,即使你更倾向于不同的写法
37- - 如果注意到无关的死代码,提一下 —— 不要删除它
35+ - 如果注意到无关的死代码,提一下, 不要删除它
3836
3937当你的改动产生孤儿代码时:
4038
41- - 删除因你的改动而变得无用的导入/变量/函数
39+ - 删除因你的改动而变得无用的导入、变量或函数
4240- 不要删除预先存在的死代码,除非被要求
4341
44- ** 检验标准:** 每一行修改都应该能直接追溯到用户的请求。
42+ ** 检验标准:** 每一行修改都应该能直接追溯到用户的请求
4543
4644## 4. 目标驱动执行
4745
48- ** 定义成功标准。 循环验证直到达成。 **
46+ ** 定义成功标准, 循环验证直到达成**
4947
5048将指令式任务转化为可验证的目标:
5149
52- | 不要这样做... | 转化为... |
53- | ------------- | ------------------------------------ |
54- | "添加验证" | "为无效输入编写测试,然后让它们通过" |
55- | "修复 bug" | "编写重现 bug 的测试,然后让它通过" |
56- | "重构 X" | "确保重构前后测试都能通过" |
50+ "添加验证" → "为无效输入编写测试,然后让它们通过"
51+ "修复 bug" → "编写重现 bug 的测试,然后让它通过"
52+ "重构 X" → "确保重构前后测试都能通过"
5753
5854对于多步骤任务,说明一个简短的计划:
5955
@@ -63,7 +59,7 @@ LLM 经常默默选择一种解释然后执行。这个原则强制明确推理
63593. [步骤] → 验证: [检查]
6460```
6561
66- 强有力的成功标准让 LLM 能够独立循环执行。弱标准 ("让它工作")需要不断澄清。
62+ 明确有力的成功标准能让你独立循环推进,模糊的标准 ("让它工作")只会不断需要澄清
6763
6864# 命令
6965
@@ -126,7 +122,7 @@ v3-admin-vite
126122│ └─ main.ts # 入口文件
127123├─ tests # 单元测试
128124├─ types # 类型声明
129- │ └─ auto # 自动生成的类型
125+ │ └─ auto # 自动生成的类型(禁止手动修改)
130126├─ .editorconfig # 编辑器配置
131127├─ .env # 所有环境
132128├─ .env.development # 开发环境
@@ -143,4 +139,4 @@ v3-admin-vite
143139
144140# 约定
145141
146- 参考 ` .cursor/rules ` 规则
142+ 按需参考 ` .cursor/rules ` 目录下规则
0 commit comments