用途:在创建实现计划、修复计划或针对缺陷/功能的 TDD 循环之前,先快速理解代码流程,避免在未弄清问题前就动手修改。
主要能力:提供三步轻量协议。第一步追踪流程,回答哪个事件或请求触发、哪个 file:line 处理、错误发生在哪个 file:line。第二步画简图,用 class.method() 形式展示事件到结果的流转,标注相关数据与错误位置,控制在 5-10 行。第三步验证,向用户确认流程是否正确,得到确认后再继续。
使用方式:在修复缺陷、实现功能、调试问题或修改代码时激活。示例中针对邮箱校验失败,追踪 user.email.updated 事件,定位 UpdateUserEmailHandler.execute() 与 EmailValidator.parse() 的报错位置,并说明当前抛错、应改用 safeParse() 返回校验错误。
适用场景:需要快速定位问题、为 TDD 确定测试范围时。
限制:保持轻量,不做详细规划;必须具体到 file:line;未获确认不得继续;拼写、格式、文档等琐碎改动可跳过。反模式是直接说“我会修复校验,这是我的计划”,正确做法是先追踪错误位置并请对方确认。