break-tunnel-vision

Files (1)

• SKILL.md

SKILL.md (first lines)

# 跳出牛角尖方法论

**诊断信号：同一个方向修了 2 次以上，用户/系统还是报同样的错。** 出现这个信号，别再在那条线上叠加第 3/4 个修复——这套方法逼你重新锚定。

## 一、先停止：第 2 次失败 = 你的方向大概率是错的

**超过 2 次修复失败，几乎必然是"你修的层不对"，不是"修得不够"。**

- 不要在第 3 次修复上再叠加改动（这是最典型的牛角尖：把同一套逻辑用不同参数再跑一遍）
- 停下来问一句："我还能从同一条线修出第 4 个方案吗？能，但方向大概率还是错的。"
- **承认"我这条线走错了"是跳出牛角尖的第一步，不是丢人。**

Red Flags（听到自己说以下任何一句 → 立即停止）：

- "再试一次修复"（已经失败 2+ 次）
- "大概是 X，我再改一下"
- "工具说这个段是干净的"（但我用的工具是自写/启发式）

## 二、回头看"问题发生的时机和位置"（而非"成因"）

牛角尖的典型特征：一直追"为什么"（成因），却忘了重新确认"**在哪一刻、哪个位置**出问题"。

**动作**：

- 重新精确描述：问题出现在**什么时机**（场景切换 / 读档 / 初始化 / 某次操作）？
- 问题出现在**什么位置**（哪个模块 / 哪个文件 / 哪个段 / 哪个卡点）？
- **很多时候，问题"时机/位置"的描述本身就藏着答案。**

## 三、从浅到深：先确认最表层没问题，再往深挖

牛角尖常犯的错误：**一上来就钻最深的层**（存储 / 引擎 / 指针），跳过表层。

**动作**：

- 从**最表层**开始逐层确认：用户看到的"现象"有没有被某种表象掩盖？
- 每确认一层"没问题"，才往下一层走；**不要假设深层有问题，先证明表层真没问题。**
- 表层问题常常在**掩盖 / 干扰**深层的判断。

## 四、前后关系：之前没问题，改了之后出问题

**最有力的线索：什么改动引入了问题。**

- 对比"之前能正常做 X"和"现在不能做 X"之间，**你改了什么**？
- 用单变量隔离：一次只改一个，对比结果，锁定"那个变量"。

## 五、关键卡点：特殊步骤出问题，问题多半就在这些关键步骤

问题如果出现在**特殊 / 关键的卡点**（场景切换、读档、初始化、状态转换、边界），那问题本身**很可能就在这个关键步骤的逻辑里**：

- 不要在"卡点之外"找原因
- 卡点往往是：输入/输出边界、状态转换、资源切换、生命周期交接。**这些地方最容易踩到"数据格式 / 命名 / 偏移"问题。**

## 六、抓住关键问题点（那个"只要动它就翻转"的点）

牛角尖解开的标志：**找到一个"动它、结果立刻变"的关键点**。

- 只要保留这一处不改 → 正常；改了它 → 出问题。**动它就翻转结果，这就是根因。**
- 找不到这个"翻转点"之前，说明还在模糊区；找到后，一切豁然开朗。

## 七、相信操作者的反馈（用户/操作者是最硬的证据）

用户的实测反馈和直觉，常比静态工具准。出现这些反馈，**立刻改变方向，不要继续原来的猜测**：

- "不是一直说过了吗" → 我在重复确认已确认的事实，浪费回合
- "还是崩" → 我这条线又被证伪了
- "你想想有没有别的方向" / "我觉得你的思路错了" → 该重新锚定了

---

## 跳出牛角尖循环（可复用模板）

```
卡在牛角尖（同方向失败 2+ 次）
  ↓
【停止】承认方向可能错，不再叠加修复
  ↓
【时机/位置】重新锚定：问题发生在哪一刻？哪个位置？（用户提示为准）
  ↓
【从浅到深】先证最表层没问题（消除干扰表象），再逐层下探
  ↓
【前后关系】对比"之前能/现在不能"，锁定改动引入的变量（单变量隔离）
  ↓
【关键卡点】问题在特殊步骤 → 深挖这个卡点的边界逻辑
  ↓
【关键点】找出"动它结果就翻转"的那一处 → 做最小隔离验证
  ↓
输出：重新锚定的方向 + 一个具体可测的隔离/修复方案（不是又猜一套）
```

## Quick Reference

| 步骤      | 关键动作               | 完成标准                                  |
| --------- | ---------------------- | ----------------------------------------- |
| 停止      | 承认方向错，停止叠加   | 说出"我这条线可能错了"                    |
| 时机/位置 | 重新描述何时何地出问题 | 精确到"具体时机 + 具体位置"，而非笼统现象 |
| 从浅到深  | 先证表层，再下探       | 表层干扰已排除/已识别                     |
| 前后关系  | 对比改动前后           | 锁定多出的那个变量                        |
| 关键卡点  | 深挖特殊步骤边界       | 定位到具体卡点逻辑                        |
| 关键点    | 找翻转点               | 动它 → 结果翻转                           |

## 与其他 skill 区别

| skill                   | 区别                                                                                      |
| ----------------------- | ----------------------------------------------------------------------------------------- |
| **break-tunnel-vision** | 专治反复失败钻牛角尖：停止 + 回头看时机位置 + 从浅到深 + 前后关系 + 关键卡点              |
| diagnosing-bugs         | 通用 bug 定位（build feedback loop / bisection / hypothesis），首次修复就常见的问题用这个 |
| on-site-project         | 外部项目全流程方法论；其排障卡住时载入本 skill                                            |

From JianHun101/catStudio, MIT.

More from JianHun101/catStudio