unstuck git:20260711.ac4022aA

Immutable. This exact content is served forever at /api/v1/blob/ae93a0fa744f19c6.

---
name: unstuck
description: 定位疑难问题的最佳实践。当连续两次修改均未达致预期时必须使用。
user-invocable: true
---

# unstuck

连续修改均未达致预期代表当前假设不可靠，继续试错只会引入更多不确定性。
立刻撤销所做的无效修改，改为用以下方式定位：

A. 测试用例复现

- 编写用例复现真实场景，锁定错误的行为表现。
- 执行测试，观察实际输出与预期的差异。

B. 添加详细调试日志

- 在关键路径插入调试日志，输出中间变量、分支走向、错误码。日志内容应该帮助你定位根因，而非简单的"到达某行"。
- 运行程序复现操作。若有必要，则提示用户进行操作。根据日志缩小排查范围

根据复现结果或日志，形成新的根因假设，再进入下一轮修复。

若此时仍然无法解决，请求 `senior` 子代理协助。