用途
debug-issue 是一个用于系统化调试问题的技能,核心理念是借助代码知识图谱,沿着调用链路追踪并定位缺陷,而不是仅凭经验在代码库中盲搜。
主要能力
根据资料,该技能围绕以下能力组织调试流程:
- 语义搜索:使用 semantic_search_nodes_tool 查找与问题相关的代码节点。
- 调用链路追踪:使用 query_graph_tool,配合 callers_of(调用方)与 callees_of(被调用方)追踪调用链。
- 执行路径查看:使用 get_flow_tool 查看疑似区域中的完整执行路径,帮助找到触发缺陷的入口点。
- 变更检测:运行 detect_changes_tool,检查问题是否由近期改动引入;资料特别提示,近期变更是新问题最常见的来源。
- 影响范围评估:对疑似文件使用 get_impact_radius_tool,了解改动还会影响哪些其他部分。
使用方式
资料给出的操作要点包括:
- 同时检查调用方与被调用方,以理解完整上下文,而非只看单一方向。
- 观察受影响的执行流,定位触发缺陷的入口。
- 优先排查近期变更。
- 调用顺序上,应先使用 get_minimal_context_tool(task="<your task>") 获取最小上下文,再使用其他图谱工具。
- 所有调用使用 detail_level="minimal",仅在信息不足时提升到 "standard"。
- 效率目标是:任何审查、调试或重构任务在不超过 5 次工具调用、总计不超过 800 个输出 token 内完成。
- 在修改代码前,先阅读实现及其测试;图谱的作用是缩小范围,不能替代阅读源码。
适用场景
适用于需要在较大代码库中定位缺陷来源、梳理调用关系、判断改动影响面,或确认问题是否由近期提交引起的调试与代码审查场景。
限制
资料未说明该技能支持的具体编程语言、依赖的图谱工具实现、安装方式或收费信息,这些内容暂未提供。技能本身强调图谱只用于缩小排查范围,最终判断仍需结合源码与测试阅读。