Cartographie de contexte avant modifications

VérifiéSûr

Analyse le codebase et génère une carte des fichiers concernés, dépendances, tests et risques avant toute modification.

Spar Skills Guide Bot
DeveloppementDébutant
2018/10/2026
Claude CodeCursorWindsurfCopilotCodex
#codebase-analysis#dependency-analysis#planning#context-engineering#risk-assessment

Recommandé pour

Notre avis

Avant toute modification, ce skill demande à l'agent d'explorer le dépôt et de produire une cartographie structurée des fichiers à modifier, de leurs dépendances, des tests concernés et des patterns de référence.

Points forts

  • Impose une phase d'analyse explicite avant l'écriture de code, ce qui réduit les modifications mal ciblées
  • La sortie en tableaux markdown (fichiers, dépendances, tests, patterns) est directement lisible et réutilisable dans une revue
  • La section Risk Assessment force l'agent à signaler les ruptures d'API publique, migrations de base de données et changements de configuration
  • Le format est générique et indépendant du langage ou du framework du projet

Limites

  • Ne fournit aucun script ni outil : tout repose sur la capacité de recherche de l'agent, la qualité de la carte varie donc selon le modèle
  • Aucune stratégie d'arrêt n'est définie pour les très gros dépôts, où l'exploration peut être longue ou incomplète
  • La carte produite n'est pas vérifiée automatiquement ; elle peut omettre des dépendances dynamiques ou des fichiers générés
Quand l'utiliser

À utiliser au démarrage d'une tâche de refactorisation ou d'ajout de fonctionnalité dans un dépôt existant que l'agent ne connaît pas encore.

Quand l'éviter

À éviter pour une correction triviale et localisée, ou lorsque le contexte du projet est déjà entièrement chargé dans la conversation.

Analyse de sécurité

Sûr
Score qualité84/100

The skill only provides instructions for analyzing a codebase and generating a documentation artifact. It does not declare or invoke any tools, execute commands, access network resources, or manipulate files. There is no destructive, exfiltrating, or obfuscated behavior.

Aucun point d'attention détecté

Exemples

Refactor an auth module
/context-map Add rate limiting to the login flow — map out which files, dependencies, and tests are involved before you change anything.
Plan a schema change
Use the context-map skill for this task: rename the `users.fullname` column to `display_name` across the API. Show me the files to modify, dependents, and whether migrations are needed.
Onboard to unfamiliar repo
/context-map I need to add CSV export to the reports page. I'm new to this repo — first give me the context map with reference patterns, then wait for my go-ahead.

name: context-map description: 'Generate a map of all files relevant to a task before making changes'

Context Map

Before implementing any changes, analyze the codebase and create a context map.

Task

{{task_description}}

Instructions

  1. Search the codebase for files related to this task
  2. Identify direct dependencies (imports/exports)
  3. Find related tests
  4. Look for similar patterns in existing code

Output Format

## Context Map

### Files to Modify
| File | Purpose | Changes Needed |
|------|---------|----------------|
| path/to/file | description | what changes |

### Dependencies (may need updates)
| File | Relationship |
|------|--------------|
| path/to/dep | imports X from modified file |

### Test Files
| Test | Coverage |
|------|----------|
| path/to/test | tests affected functionality |

### Reference Patterns
| File | Pattern |
|------|---------|
| path/to/similar | example to follow |

### Risk Assessment
- [ ] Breaking changes to public API
- [ ] Database migrations needed
- [ ] Configuration changes required

Do not proceed with implementation until this map is reviewed.

Skills similaires