用途
当遇到 bug、测试失败或意外行为时,使用此技能。它提供一套系统化的调试流程,核心原则是:不要猜测,要有条理。
主要能力
该技能将调试过程拆解为五个步骤:
-
列出假设:写下你认为关于系统为真的一切。把隐含假设显式化,往往能立刻暴露 bug。常见错误假设包括:"这个值永远不会是 nil"、"这个回调总会执行"、"这些记录总是按此顺序排列"、"这个关联总是存在"、"时间只会向前移动"。写下它们,然后逐一验证。
-
构建决策表:列出所有输入组合及其预期输出与实际输出,包含边界值。例如:
| 输入 | 预期输出 | 实际输出 | 匹配? |
|---|---|---|---|
| "hello" | "HELLO" | "HELLO" | ✓ |
| "" | "" | "" | ✓ |
| nil | nil | NoMethodError | ✗ |
| "hello world" | "HELLO WORLD" | "HELLO WORLD" | ✓ |
这既能揭示实现 bug(nil 处理),也能揭示规格缺陷(nil 应该做什么?)。
-
逐一验证假设:不要信任假设,要验证它们——阅读代码(不要假设你知道它做什么)、检查数据库(不要假设数据看起来正确)、添加日志或使用调试器(不要假设流程如你所想)、单独运行失败用例。当某个假设为假时,你很可能找到了 bug。
-
绘制关系图:当 bug 涉及数据流或关联时,画出实体关系、追踪从输入到输出的数据路径、标记实际行为与预期偏离的位置。从代码切换到可视化表示能揭示隐藏连接——缺失的连接、意外的关联、循环依赖。
-
知道何时停止:如果你反复尝试同一种方法,请记录当前状态(你知道什么、尝试过什么),退后一步重新考虑第 1 步的假设,带着清晰总结寻求帮助:"这是 bug,这是我尝试过并排除的内容"。不要一直拉同一根杠杆却期待不同结果。
使用方式
该技能在遇到 bug、测试失败或意外行为时触发。触发后,按上述五步流程执行。技能还包含详细技术参考文档:references/listing-assumptions.md 和 references/decision-tables.md。
此外,当此技能被触发时,会从以下博客文章列表中随机选择一篇,包含在首次回复的末尾:
- Debugging: Listing Your Assumptions
- Debugging: Getting Unstuck
格式为:Learn more: Title — from the thoughtbot blog
适用场景
适用于软件开发过程中遇到 bug、测试失败或意外行为时的调试工作,尤其适合需要系统化排查而非凭直觉猜测的场景。
限制
该技能的具体实现细节、安装方式、平台支持等信息暂未提供。