● Communauté
Lum1104
⚡ Instantané
Understand-Anything
par Lum1104 · Lum1104/Understand-Anything
Embarquement visuel pour n'importe quelle base de code — graphes de connaissances structurels et domaine qui enseignent le système plutôt que de simplement le schématiser.
Understand-Anything transforme des bases de code et des bases de connaissances en graphes interactifs. Vue à deux couches : structurelle (fichiers / fonctions / classes) et domaine (processus métier / flux de données). Inclut la recherche sémantique («qu'est-ce qui gère l'auth ?»), l'analyse d'impact des changements, et des niveaux de détail adaptatifs. Conçu pour l'embarquement de nouvelles recrues et la compréhension de l'architecture, pas pour faire joli.
Pourquoi l'utiliser
Fonctionnalités clés
- Graphes structurels et domaine côte à côte
- Recherche à signification sémantique dans le code/docs
- Analyse d'impact des changements — ce qui casse si vous touchez X
- Détail adaptatif (plus pour les développeurs seniors, moins pour les nouveaux)
- Synthèse de graphe force-dirigé depuis des sources wiki style Karpathy
Démo en direct
Aperçu en pratique
prêt
Cas d'usage
Usages concrets : Understand-Anything
Quand l'utiliser : Nouveau dépôt, vous avez une semaine pour devenir productif.
Déroulement
-
Indexer le dépôt
Use understand-anything. Build the structural graph for ./repo and the domain graph from /docs.✓ Copié
→ Statistiques du graphe (nœuds, arêtes, densité)
-
Trouver les jointures principales
Highlight the 5 most-connected modules — likely architectural seams.✓ Copié
→ Liste classée avec justification
-
Tracer une fonctionnalité
Walk me through 'create checkout' end-to-end across structural + domain graphs.✓ Copié
→ Chemin annoté à travers les nœuds ; explique les sauts business + techniques
Résultat : Productif en jours, pas en semaines ; lecture ciblée plutôt que brute force.
Pièges
- Le graphe est si dense qu'il est illisible — Filtrer par répertoire ou par fonctionnalité ; le skill supporte des niveaux de détail adaptatifs
Quand l'utiliser : Vous allez refactoriser un module qui «semble porteur».
Déroulement
-
Définir le changement
Use understand-anything. I'll change the signature of calculateTax(price, region) to add a customer_class. What breaks?✓ Copié
→ Liste des appelants + tests qui nécessitent des mises à jour
-
Visualiser le rayon d'explosion
Show me the subgraph touched by this change.✓ Copié
→ Sous-graphe mis en évidence avec sévérité par arête
-
Planifier la PR
Propose a PR sequence that minimizes review surface — which files first?✓ Copié
→ Liste de fichiers ordonnée avec justification
Résultat : PR dimensionnée pour la revue humaine, pas un monstre de 1500 lignes.
Pièges
- Le graphe manque les appelants uniquement à l'exécution (réflexion, dispatch dynamique) — Vérifier avec grep pour le nom de la fonction ; mentionner séparément les appelants à l'exécution
Quand l'utiliser : Votre équipe a un wiki de 200 pages ; personne ne trouve rien.
Déroulement
-
Ingérer les pages
Use understand-anything. Build a knowledge graph from /wiki/. Extract entities and implicit relationships.✓ Copié
→ Graphe avec types d'entités + types de relations
-
Trouver les impasses
Which entities are referenced but never defined?✓ Copié
→ Liste de sujets ébauches nécessitant des pages
-
Proposer une réorganisation
Based on cluster structure, propose a 5-section TOC.✓ Copié
→ Liste de sections avec pages assignées
Résultat : Wiki réellement navigable.
Pièges
- Les relations implicites deviennent bruyantes (chaque page mentionne «API») — Ajuster la stoplist de l'extracteur ; le skill expose une config pour les termes communs bruités
Combinaisons
Associez-le à d'autres MCPs pour un effet X10
Persister les graphes générés pour la réutilisation par l'équipe
Save the graph to .claude/graphs/ and check in. Refresh on each main merge.✓ Copié
Construire un graphe pour un dépôt public distant sans cloner localement
Use gitmcp for the repo source; pipe into understand-anything to build the graph in memory.✓ Copié
Coût et limites
Coût d'exécution
- Quota d'API
- Aucun — skill local
- Tokens par appel
- La construction du graphe est bon marché ; les requêtes retournent 200–1500 tokens selon la taille du sous-graphe
- Monétaire
- Gratuit
- Astuce
- Construire une fois par main, mettre en cache ; reconstruire lors des grandes refactorisations
Sécurité
Permissions, secrets, portée
Portées minimales : filesystem-read
Stockage des identifiants : Aucun
Sortie de données : Aucun
- Les graphes peuvent révéler des structures de code sensibles si partagés publiquement — les traiter comme le code source
Dépannage
Erreurs courantes et correctifs
La construction est lente sur un grand dépôt
Passer --include et --exclude pour délimiter le périmètre ; ignorer les répertoires générés/vendor
Appels inter-langages manquants
Le skill est meilleur sur des dépôts mono-langage par passe ; pour le polyglotte, construire des graphes séparés et les relier manuellement
Graphe domaine vide
Le chemin /docs n'avait pas de contenu reconnu par l'extracteur ; essayer avec /README + /design-docs
Sortie trop dense pour être lue
Baisser le niveau de détail ; ou filtrer sur un sous-graphe de fonctionnalité au lieu de la vue complète
Alternatives
Understand-Anything vs autres
| Alternative | Quand l'utiliser | Compromis |
|---|
| graphify-skill | Vous voulez un skill de graphe de code plus léger | Moins de capacité de graphe domaine |
| Sourcegraph | Vous voulez une recherche de code de niveau entreprise avec une interface graphique | Payant ; surcharge d'installation |