Routeur de questions sur la base de code

VérifiéSûr

Acheminez une question sur la base de code vers l'outil approprié — graphe structurel, recherche sémantique ou analyse de risque. À utiliser pour trouver ou comprendre du code sans connaître les noms de fichiers exacts.

Spar Skills Guide Bot
DeveloppementIntermédiaire
23/07/2026
Claude Code
#code-navigation#semantic-search#codebase-memory#impact-analysis#mcp

Recommandé pour

Synthèse automatique

Ce skill aiguille une question sur le code vers l'outil le plus adapté : graphe structurel pour l'architecture et les traces d'appels, recherche sémantique pour localiser du code, ou analyse de risque avant modification.

Points forts

  • Routage explicite par mots-clés (architecture/flow, find/search, impact/risk) qui évite l'exploration manuelle de fichiers
  • S'appuie sur des outils MCP spécialisés (trace_path, search, detect_changes_tool) plutôt que sur grep et lecture de fichiers
  • Annonce des gains de tokens (120× moins qu'une exploration manuelle) et un format de réponse cadré
  • Prévoit un repli vers la lecture directe quand aucun outil ne convient

Limites

  • Suppose que les trois serveurs MCP (codebase-memory, cocoindex-code, code-review-graph) soient déjà installés et indexés
  • Le routage repose sur une correspondance de mots-clés simple, qui peut mal classer une question ambiguë
  • Peu utile sur un petit dépôt ou un fichier isolé, où lire directement suffit
Quand l'utiliser

À utiliser quand vous cherchez ou cherchez à comprendre du code sans connaître les noms de fichiers exacts, ou avant de modifier du code pour en évaluer l'impact.

Quand l'éviter

À éviter si les serveurs MCP associés ne sont pas configurés ou si la question cible un fichier précis que vous connaissez déjà.

Analyse de sécurité

Sûr
Score qualité82/100

This is a pure routing/instruction document. It references MCP tool names (codebase-memory, cocoindex-code, code-review-graph) but contains no shell commands, no file deletion, no network exfiltration, no credential handling, and no attempt to disable safety controls. The only actions it asks for are read-only graph searches and, as a fallback, reading files directly. No declared tools amplify risk.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Trace a call path
How does an incoming HTTP request end up writing to the audit log? Trace the path through the codebase.
Locate code by meaning
Where is the retry/backoff logic for failed webhook deliveries implemented?
Check impact before changing
I want to change the signature of the PaymentService.charge method — what breaks and what's the blast radius against main?

name: ask description: Route a codebase question to the right tool — structural graph, semantic search, or risk analysis. Use when you need to find or understand code without knowing exact file names.

Ask Skill — Codebase Question Router

Answer a question about the codebase by routing to the most effective tool.

Don't search files manually when a smarter tool exists.

Routing Rules

Architecture / flow / how does X work / trace a call

Use mcp__codebase-memory__trace_path or mcp__codebase-memory__get_architecture. Zero file reads. 120× fewer tokens than manual exploration.

Find / search / locate / what file / which function

Use mcp__cocoindex-code__search with a semantic query. Finds code by meaning, not exact text — useful when you don't know the exact name.

Safe to change / impact / blast radius / what breaks / risk score

Use mcp__code-review-graph__detect_changes_tool with base_branch="main". Reports: risk score 0–100, blast radius, breaking changes, dependent modules.

General code question (narrow, specific file, no plugin fits)

Read the file directly. Grep for the symbol.

Decision Logic

  1. Contains architecture/flow/trace/how/explain → codebase-memory-mcp
  2. Contains find/search/locate/where/what file → cocoindex-code
  3. Contains safe/impact/blast/breaks/risk/change → code-review-graph
  4. None of the above → read directly

Answer Format

  • Tool used and why
  • Finding (file path + line if applicable)
  • Surprising cross-module connections revealed by the graph (if any)

If no tool gives a clear answer, fall back to reading relevant files.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/codebase-question-router-mrx3xw9j/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/codebase-question-router-mrx3xw9j' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/codebase-question-router-mrx3xw9j/download' --output '.skill-downloads/codebase-question-router-mrx3xw9j/SKILL.md.part' && mv '.skill-downloads/codebase-question-router-mrx3xw9j/SKILL.md.part' '.skill-downloads/codebase-question-router-mrx3xw9j/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/codebase-question-router-mrx3xw9j/SKILL.md' && test -s '.skill-downloads/codebase-question-router-mrx3xw9j/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/ask' && cp -R '.skill-downloads/codebase-question-router-mrx3xw9j' '.claude/skills/ask'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/codebase-question-router-mrx3xw9j'

openskills read 'codebase-question-router-mrx3xw9j'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/codebase-question-router-mrx3xw9j/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires