用途:定位 Elixir/Phoenix 缺陷的根因,包括崩溃、异常、堆栈跟踪、编译错误、LiveView 不更新和静默失败。
主要能力:提供顺序排查流程与并行深度排查模式。顺序流程先查 .claude/solutions/ 中已有方案,再运行 mix compile --warnings-as-errors 2>&1 | head -50 和 mix ecto.migrate 做基本检查,随后用 mix test test/path_test.exs --trace 复现并查看 log/dev.log 末尾 200 行,逐字阅读错误信息,按清单检查文件是否保存、atom 与字符串、数据预加载、模式匹配、nil、返回值、服务是否重启等,再用 IO.inspect 或 Tidewave project_eval 验证假设,最后给出根因与证据并按修复规模分流。若检测到 Tidewave MCP,可自动捕获运行时上下文,如 mcp__tidewave__get_logs level: :error、mcp__tidewave__get_source_location、mcp__tidewave__execute_sql_query、mcp__tidewave__project_eval。
使用方式:命令为 /phx:investigate,参数为缺陷描述或错误信息,可加 --parallel 启用四轨深度排查。并行模式在嵌套深度 3+ 时使用 deep-bug-investigator 编排器;深度 1 或 2 时在主会话直接并行启动复现、根因、影响、修复策略四条轨道,等待后综合证据。
适用场景:涉及 3 个以上模块、跨多个上下文、间歇性或并发相关缺陷,或用户明确要求深度排查时。
限制:资料未提供安装方式、收费、价格、平台与效果信息。技能强调先复现再修复,不得在确认根因前应用修复,也不应为验证已知结论而生成确认性子代理。