- Click entrypoint: mybot update (make install / pip -e), mybot chat (claude in repo) - Optional --dangerously-skip-permissions for Claude Code - Makefile install; hatchling package layout - .gitignore: venv, build artifacts, workspace (local symlinks) Made-with: Cursor
1.1 KiB
1.1 KiB
调试技能 (Debugging Skill)
调试原则
- 复现优先: 能稳定复现才算找到原因
- 隔离变量: 一次只改一个因素
- 最小化: 找到最小复现路径
- 验证假设: 每个假设都要有证据
调试流程
1. 问题确认
- 错误信息是什么?
- 什么情况下发生?
- 是否可以稳定复现?
- 最近有什么变更?
2. 信息收集
- 完整错误堆栈
- 相关日志
- 输入数据样本
- 环境信息
3. 定位方法
- 二分法:注释掉一半代码,看问题是否还在
- 对比法:对比正常情况和异常情况的差异
- 日志法:在关键点插入日志,追踪执行路径
4. 修复验证
- 修复后是否解决问题?
- 是否引入新问题?
- 测试用例是否通过?
常见陷阱
- 不要根据现象猜测原因
- 不要同时尝试多种修复
- 不要忽略警告信息
- 不要假设"不可能"
工具使用
- 优先用日志而非调试器
- 复杂状态用 pdb/ipdb
- 性能问题用 profiler