Debug Issue
Systematically debug issues using graph-powered code navigation
SKILL.md.claude/skills/debug-issue/skill.md
GitHubDebug Issue
Use the codebase-memory-mcp knowledge graph (project C-Marcos-Proyectos-Zenda) to systematically trace and debug issues.
Steps
search_graph(query="<síntoma o nombre de función/ruta>")para ubicar el código relacionado.trace_path(function_name=..., mode="calls")para ver quién llama y a quién llama la función sospechosa.trace_path(function_name=..., mode="data_flow")si el bug es de propagación de un valor/argumento concreto.detect_changes(since="HEAD~5")(o el ref relevante) para ver si un cambio reciente causó el bug.get_code_snippet(qualified_name=...)para leer el código exacto una vez localizado (usa elqualified_namedevuelto porsearch_graph, no adivines la ruta).
Tips
- Revisa tanto callers como callees para entender el contexto completo.
- Los cambios recientes (
detect_changes) son la causa más común de bugs nuevos. - Usa
query_graphcon Cypher para patrones multi-hop quetrace_pathno cubre (p.ej. cruzar por rutas HTTP).
Reglas de eficiencia de tokens
- Empieza siempre con
search_graphacotado (usalabel,file_patternolimitbajo) antes dequery_graphlibre. - Pide
get_code_snippetsolo del símbolo exacto que necesitas, no de archivos completos. - Objetivo: resolver el debug en ≤5 llamadas a herramientas de grafo.