Skip to content

Commit 31c055c

Browse files
committed
chore: update AGENTS.md
1 parent da11f5d commit 31c055c

1 file changed

Lines changed: 21 additions & 25 deletions

File tree

AGENTS.md

Lines changed: 21 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -2,58 +2,54 @@
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 经常默默选择一种解释然后执行。这个原则强制明确推理
6359
3. [步骤] → 验证: [检查]
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

Comments
 (0)