hello-debug

调试相关工作必须遵循以下规范。

编码前

禁止未经根因分析直接修复。 先建立可运行、可重复、可判断的反馈循环；没有反馈循环，不直接猜原因或改代码。

Git 作为记忆

每次调试前，先读取相关的 git 历史：

• git log --oneline -20 查看最近变更
• git log --all --grep="revert" 查看过去的失败回滚
• 如果发现之前已经尝试并回滚过类似修复 → 不要重复同样的方向

反馈循环优先

反馈循环是调试入口，必须能证明“问题出现 / 问题消失”：

• 优先写失败测试；不适合写测试时，用 HTTP 脚本、CLI 样例输入、浏览器脚本、请求 / 事件回放、最小验证脚本、差异对比或压力循环复现
• 循环要尽量快、稳定、断言具体症状，不用“没有崩溃”代替正确性
• 非确定性问题先提高复现率，记录触发次数、失败比例和关键条件
• 实在无法建立循环时，停止并说明已尝试方式，向用户请求日志、录屏、请求记录、环境访问或授权加临时观测点