SuperAPI AI 工具集

debug-issue

编程与开发

查看项目

更新于 10-24 16:17

技能介绍

用途

debug-issue 是一个用于系统化调试问题的技能,核心理念是借助代码知识图谱,沿着调用链路追踪并定位缺陷,而不是仅凭经验在代码库中盲搜。

主要能力

根据资料,该技能围绕以下能力组织调试流程:

  • 语义搜索:使用 semantic_search_nodes_tool 查找与问题相关的代码节点。
  • 调用链路追踪:使用 query_graph_tool,配合 callers_of(调用方)与 callees_of(被调用方)追踪调用链。
  • 执行路径查看:使用 get_flow_tool 查看疑似区域中的完整执行路径,帮助找到触发缺陷的入口点。
  • 变更检测:运行 detect_changes_tool,检查问题是否由近期改动引入;资料特别提示,近期变更是新问题最常见的来源。
  • 影响范围评估:对疑似文件使用 get_impact_radius_tool,了解改动还会影响哪些其他部分。

使用方式

资料给出的操作要点包括:

  1. 同时检查调用方与被调用方,以理解完整上下文,而非只看单一方向。
  2. 观察受影响的执行流,定位触发缺陷的入口。
  3. 优先排查近期变更。
  4. 调用顺序上,应先使用 get_minimal_context_tool(task="<your task>") 获取最小上下文,再使用其他图谱工具。
  5. 所有调用使用 detail_level="minimal",仅在信息不足时提升到 "standard"。
  6. 效率目标是:任何审查、调试或重构任务在不超过 5 次工具调用、总计不超过 800 个输出 token 内完成。
  7. 在修改代码前,先阅读实现及其测试;图谱的作用是缩小范围,不能替代阅读源码。

适用场景

适用于需要在较大代码库中定位缺陷来源、梳理调用关系、判断改动影响面,或确认问题是否由近期提交引起的调试与代码审查场景。

限制

资料未说明该技能支持的具体编程语言、依赖的图谱工具实现、安装方式或收费信息,这些内容暂未提供。技能本身强调图谱只用于缩小排查范围,最终判断仍需结合源码与测试阅读。