用途:在项目出现问题时报出错误、崩溃、白屏、无法连接等场景下,定位根因并修复。该技能把通用调试方法交给 systematic-debugging(根因优先调查)与 verification-before-completion(先有证据再声称修好),项目相关内容保留在 TeaTree 本地流程中。
主要能力与流程:强调“根因、一处修复”,若出现修症状又冒新症状的循环,应停下来重新诊断。修复对象是整类问题而非单个调用点:先枚举所有调用处(如 grep -rn 'unguarded_helper(' src/ 或 rg 'unguarded_helper(' src/),再修共享helper或模式。排查前优先查看用户提示、截图/视频证据(视频可用 t3 工具 analyze-video),并检查近期改动,如 git log --oneline --since="3 days ago"、文件时间、插件更新与环境变量变化。任何回归或功能分支 CI 变红,第一步是对比基线:git diff origin/main...HEAD 或 git log --oneline origin/main..HEAD,确认分支引入的内容,再怀疑既有代码。
Git 安全规则:执行 cherry-pick、reset --hard、rebase、revert、force-push 等破坏性操作前,必须对实时分支核验目标 SHA;记忆中或交接信息里的 SHA 视为可能过期,先读取实时日志再在单独命令中使用刚读到的 SHA,禁止把核验与操作串成一条命令。
依赖与交付:需要 workspace(提供服务器重启与环境上下文),若未加载先加载 /t3:workspace。修复验证后经 PR 提交,先加载 /t3:ship;不要直接在 main 上提交,先建 worktree 与分支。1 次修复失败后重读错误输出,3 次以上失败应停下询问用户。常用命令包括 t3 <overlay> run backend、t3 <overlay> run build-frontend、t3 <overlay> worktree start、t3 ci fetch-errors。限制:收费、平台与更多细节暂未提供。