1 files changed, 308 insertions, 0 deletions
diff --git a/.agents/skills/bug-detective/references/common-patterns.md b/.agents/skills/bug-detective/references/common-patterns.md
new file mode 100644
index 0000000..b125edc
--- /dev/null
+++ b/.agents/skills/bug-detective/references/common-patterns.md
@@ -0,0 +1,308 @@
+# 常见错误模式
+
+## 通用编程错误模式
+
+### 1. Off-by-one Error（差一错误）
+
+**描述**：循环或索引中出现 ±1 的偏差
+
+**示例**：
+```python
+# ❌ 错误：范围应该是 range(n) 而不是 range(n+1)
+for i in range(len(items) + 1):
+    print(items[i])  # IndexError
+
+# ✅ 正确
+for i in range(len(items)):
+    print(items[i])
+```
+
+### 2. Null/None 引用错误
+
+**描述**：尝试访问 None 对象的属性或方法
+
+**Python**：
+```python
+# ❌ 可能返回 None
+result = get_data()
+print(result.value)  # AttributeError
+
+# ✅ 检查 None
+result = get_data()
+if result is not None:
+    print(result.value)
+```
+
+**JavaScript**：
+```javascript
+// ❌ 可能是 null
+const user = getUser();
+console.log(user.name);  // TypeError
+
+// ✅ 使用可选链
+console.log(user?.name);
+```
+
+### 3. 资源泄漏
+
+**描述**：打开的资源（文件、连接）未正确关闭
+
+**Python**：
+```python
+# ❌ 文件可能未关闭
+f = open("file.txt")
+content = f.read()
+# 如果发生异常，文件不会关闭
+
+# ✅ 使用 with 语句
+with open("file.txt") as f:
+    content = f.read()
+# 文件自动关闭
+```
+
+### 4. 竞态条件
+
+**描述**：多线程/进程间的时序依赖问题
+
+**示例**：
+```python
+# ❌ 检查后使用（TOCTOU）
+if os.path.exists("file.txt"):
+    # 其他进程可能在这之间删除文件
+    with open("file.txt") as f:
+        content = f.read()
+
+# ✅ 直接尝试并处理异常
+try:
+    with open("file.txt") as f:
+        content = f.read()
+except FileNotFoundError:
+    content = None
+```
+
+### 5. 忘记返回值
+
+**描述**：函数没有显式返回值，导致返回 None
+
+**示例**：
+```python
+# ❌ 忘记返回结果
+def calculate(x, y):
+    result = x + y
+    # 忘记 return
+
+# ✅ 正确返回
+def calculate(x, y):
+    return x + y
+```
+
+### 6. 错误的比较运算符
+
+**描述**：使用 = 代替 ==，或混淆 is 和 ==
+
+**Python**：
+```python
+# ❌ 赋值而不是比较
+if x = 5:  # SyntaxError
+
+# ❌ 使用 is 比较值
+if x is 5:  # 不保证正确
+
+# ✅ 正确
+if x == 5:
+```
+
+### 7. 浮点数精度问题
+
+**描述**：浮点数比较因精度问题失败
+
+**示例**：
+```python
+# ❌ 直接比较浮点数
+if 0.1 + 0.2 == 0.3:  # False
+    print("相等")
+
+# ✅ 使用容差比较
+if abs((0.1 + 0.2) - 0.3) < 1e-9:
+    print("相等")
+
+# 或使用 math.isclose()
+import math
+if math.isclose(0.1 + 0.2, 0.3):
+    print("相等")
+```
+
+### 8. 字符串拼接性能问题
+
+**描述**：在循环中使用 + 拼接字符串
+
+**示例**：
+```python
+# ❌ 低效：每次创建新字符串
+result = ""
+for item in items:
+    result += str(item)
+
+# ✅ 高效：使用列表和 join
+result = "".join(str(item) for item in items)
+```
+
+## Python 特有模式
+
+### 1. 可变默认参数
+
+```python
+# ❌ 所有调用共享同一个列表
+def append(item, items=[]):
+    items.append(item)
+    return items
+
+# ✅ 使用 None 作为默认值
+def append(item, items=None):
+    if items is None:
+        items = []
+    items.append(item)
+    return items
+```
+
+### 2. 闭包变量绑定问题
+
+```python
+# ❌ 所有函数使用相同的 i 值
+funcs = [lambda: i for i in range(3)]
+# 所有函数都返回 2
+
+# ✅ 使用默认参数捕获值
+funcs = [lambda i=i: i for i in range(3)]
+```
+
+### 3. 修改正在迭代的序列
+
+```python
+# ❌ 迭代时修改列表
+items = [1, 2, 3, 4]
+for item in items:
+    if item % 2 == 0:
+        items.remove(item)
+
+# ✅ 创建新列表或使用副本
+items = [item for item in items if item % 2 != 0]
+
+# 或
+for item in items[:]:
+    if item % 2 == 0:
+        items.remove(item)
+```
+
+## JavaScript/TypeScript 特有模式
+
+### 1. this 绑定问题
+
+```javascript
+// ❌ this 丢失上下文
+class Counter {
+  count = 0;
+  increment() {
+    setTimeout(function() {
+      this.count++;  // this 不是 Counter 实例
+    }, 100);
+  }
+}
+
+// ✅ 使用箭头函数
+class Counter {
+  count = 0;
+  increment() {
+    setTimeout(() => {
+      this.count++;  // this 正确绑定
+    }, 100);
+  }
+}
+```
+
+### 2. 异步错误处理
+
+```javascript
+// ❌ 没有处理 Promise 错误
+async function getData() {
+  const response = await fetch(url);
+  return response.json();  // 如果失败会抛出异常
+}
+
+// ✅ 使用 try-catch
+async function getData() {
+  try {
+    const response = await fetch(url);
+    return await response.json();
+  } catch (error) {
+    console.error("获取数据失败:", error);
+    throw error;
+  }
+}
+```
+
+### 3. 数组/对象引用
+
+```javascript
+// ❌ 直接赋值会复制引用
+const arr1 = [1, 2, 3];
+const arr2 = arr1;
+arr2.push(4);  // arr1 也会被修改
+
+// ✅ 创建副本
+const arr2 = [...arr1];  // 或 arr1.slice()
+
+// 对象
+const obj1 = { a: 1 };
+const obj2 = { ...obj1 };  // 或 Object.assign({}, obj1)
+```
+
+## 并发错误模式
+
+### 1. 死锁
+
+```python
+# ❌ 可能死锁
+import threading
+
+lock1 = threading.Lock()
+lock2 = threading.Lock()
+
+def thread1():
+    with lock1:
+        with lock2:
+            # 操作
+
+def thread2():
+    with lock2:
+        with lock1:  # 死锁
+            # 操作
+```
+
+### 2. 数据竞争
+
+```python
+# ❌ 多个线程同时修改共享变量
+counter = 0
+
+def increment():
+    global counter
+    counter += 1  # 非原子操作
+
+# ✅ 使用锁
+counter = 0
+lock = threading.Lock()
+
+def increment():
+    global counter
+    with lock:
+        counter += 1
+```
+
+## 预防措施
+
+1. **使用类型检查**：TypeScript、Python 类型注解
+2. **编写单元测试**：覆盖边界条件
+3. **使用静态分析工具**：pylint、eslint
+4. **代码审查**：让他人检查代码
+5. **使用防御性编程**：验证输入、处理异常