用途:该技能用于怀疑或排查 bug、意外行为、不稳定测试时,通过运行时日志证据定位根因,而不是只依赖静态代码分析猜测修复方案。
主要能力:围绕 3-5 个可验证的具体假设,在代码中插入 __debugLog 埋点调用,收集变量取值、代码分支走向、异步事件顺序以及捕获到的错误。日志发送到本地收集端点,按假设 ID 进行关联,便于比对与缩小根因范围。
使用方式:用户以 /debug-mode 调用,可附带 bug 描述;若无描述则要求用户提供预期行为与实际行为、复现方式、错误信息与相关文件。技能会静默启动日志收集器(curl -s http://127.0.0.1:7777/health || bun ${CLAUDE_PLUGIN_ROOT}/scripts/start-collector.mjs),随后生成假设、埋点、提供编号复现步骤。清理日志使用 bun ${CLAUDE_PLUGIN_ROOT}/scripts/clear-logs.mjs。埋点须使用 fetch 方式写入 http://127.0.0.1:7777/ingest,并带有 location、hypothesisId、message、data、level 字段。
适用场景:需要运行时证据的 bug 排查、异步竞态、条件分支、异常捕获与缓存失效等问题。
限制:修复必须由日志证据确认,需多次迭代,首次修复失败属正常;禁止记录密码、令牌、PII、API 密钥等敏感数据;客户端代码不得使用 node:fs。其它事实暂未提供。