SuperAPI AI 工具集

debug-with-file

编程与开发

查看项目

更新于 10-15 17:32

技能介绍

用途:面向复杂缺陷的假设驱动调试流程,适用于需要多轮排查、希望保留推理与学习过程、便于团队理解调试依据的场景。

主要能力:先定位错误来源并记录初始理解,再生成 3-5 个可检验假设;通过 NDJSON 结构化日志收集执行证据;分析后判定每个假设为 confirmed、rejected 或 inconclusive,并用删除线加更正的方式修正错误理解;确认根因后实施修复、记录经验教训,并清理调试埋点。

使用方式:按提示工作流执行,目标缺陷以 $BUG 表示。先创建会话目录,包含 debug.log、understanding.md、hypotheses.json。日志每条为 JSON,含 sid、hid、loc、msg、data、ts 字段。首轮无会话时进入探索模式,生成假设并注入日志;复现后 debug.log 有内容则进入分析模式;确认根因后进入修复与验证。可运行 ccw spec load --category debug 加载已知问题与根因笔记。项目根目录通过 git rev-parse --show-toplevel 2>/dev/null || pwd 获取。

限制:空日志需确认复现是否触发代码路径;全部假设被否需基于反证生成新假设;修复无效则记录失败并迭代;超过 5 轮应汇总上下文升级处理;理解文档过长时需激进合并。资料明确其适用于 Claude Code 工作流,未说明独立运行所需的平台与依赖条件。