用途：当 Claude 调试会话在生成代理后停滞、hook 意外拦截操作、记忆/搜索/token-saver 约束表现不一致，或需要可复现的回归验证时，使用该技能进行确定性诊断与修复验证。
主要能力：定位会话与日志来源；先运行 trace 查询（pnpm trace:query --trace-id <traceId> --compact --since <ISO-8601> --limit 200）提取高信号错误（排除已知 MCP 认证/启动噪声）；将错误映射到所属 hook/模块；做最小代码路径修补并新增或更新回归测试；执行针对性检查（测试与改动文件的 lint/format）；重跑调试提示，确认错误类型不再复现；把结论记录到记忆文件中。
使用方式：主包装脚本命令为 node .claude/skills/troubleshooting-regression/scripts/main.cjs --prompt "search the codebase for any issues or bugs"；也可直接分析指定日志：node .claude/skills/troubleshooting-regression/scripts/main.cjs --log-path "C:\Users\<user>\.claude\debug\<session>.txt"；或使用 --mode quick 分析最新日志、--log-path "<path>" --strict 在存在严重发现时失败退出。输出包含 ok、logPath、findings[]（带严重级别与所属文件提示）与 nextActions[]。
适用场景：框架看似陈旧、卡住或出现回归时的排障与验证。
限制与铁律：没有可复现触发提示、trace 证据、hook/工具调试日志证据和针对性测试通过，不得宣称回归已修复；在确定复现失败前不得修改 hook 或路由配置；每次改动后须跑完整回归测试；须在 issues.md 记录根因、修复与验证证据。相关产物路径、记忆协议与反模式清单详见技能文档；资料未提供具体收费、平台与效果信息。