用途：smart-debug 是提示驱动的 AI 辅助调试专家技能，无独立工具脚本，需在 agent 上下文中通过 $ARGUMENTS 传入待调试问题，适合间歇性、难复现的 bug、生产/运行时问题以及多组件复杂故障。简单可本地复现、根因已明确的 bug 应改用 debugging 技能。
主要流程：一是初步分诊，用 Task 工具（subagent_type="devops-troubleshooter"）做错误模式识别、堆栈分析与严重度评估；二是收集可观测性数据（Sentry、DataDog、New Relic、Jaeger、ELK、LogRocket 等），本地问题可用 pnpm trace:query --component <service-name> --event <event-name> --since <ISO-8601> --limit 200 或 pnpm trace:query --trace-id <traceId> --compact --since <ISO-8601> --limit 200 查询；三是强制生成 3–5 个带概率排序的假设（含证据、反证条件、测试方式），此为阻断门，未完成不得埋点；四是按问题性质选择调试策略；五是围绕具体假设做最小化、非阻塞、会话级埋点，写入 .claude/context/tmp/debug-<sessionId>.log，并记录所有被改文件；六是复现门，默认自动复现（pnpm test -- --grep "<pattern>" 或复现脚本），失败才回退人工复现，SMART_DEBUG_HITL=true 时直接暂停等待人工复现；七是读日志做证据-假设关联，结论只能是根因确认、证据不足或新假设；随后分析、修复、验证并做强制埋点清理与回归预防。
铁律：有排序假设前不得埋点；日志确认根因前不得修复；清理完成前不算结束；trace 与日志证据须独立一致。限制：依赖 agent 上下文与既定工具链；未提供具体支持的平台范围、收费与价格信息；具体可观测性平台需环境已接入。