context-map — скилл для GitHub Copilot: карта файлов до правок
Скилл заставляет агента сначала собрать карту файлов, тестов и зависимостей по задаче, а код менять уже после этого. Пригодится на незнакомой кодовой базе.
npx skills add github/awesome-copilot --skill context-map -a claude-codeЧто делает context-map
Скилл описывает порядок работы перед реализацией: поиск файлов по задаче, разбор прямых зависимостей через импорты и экспорты, поиск связанных тестов, а также похожих мест в коде, на которые можно опереться. Результат выводится таблицами в markdown: файлы к правке, зависимости, тесты, референсные паттерны и блок оценки рисков с пунктами про публичный API, миграции базы и изменения конфигурации.
Внутри — один файл SKILL.md с инструкциями и шаблоном вывода. Никаких скриптов и внешних сервисов, ключи не нужны. Работает в GitHub Copilot, а через установщик скиллов ставится и в Claude, Codex, Cursor, Gemini CLI и Windsurf.
Главное условие — не начинать правки, пока карта не просмотрена. Это дисциплинирует на больших репозиториях, где агент любит трогать не те файлы. Если задача в одну строку в одном файле, карта только замедлит: пропустите скилл.
Какие задачи решает
- найти все файлы, которые затронет правка
- вытащить прямые зависимости изменяемого модуля
- подобрать тесты, покрывающие функциональность
- найти похожий код как образец для новой реализации
- оценить риск для публичного API и миграций
Примеры запросов агенту
- собери context map для задачи: добавить пагинацию в список заказов
- прежде чем менять код, покажи карту файлов и тестов по этой задаче
- какие зависимости и тесты затронет рефакторинг модуля авторизации?
Как установить context-map
1Через Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill context-map -a claude-code2Вручную: положить файлы
~/.claude/skills/context-map/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/context-map/
Вручную: положить файлы
.agents/skills/context-map/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/context-map/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1Через Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill context-map2GitHub CLI
gh skill install github/awesome-copilot context-map3Вручную: положить файлы
.github/skills/context-map/SKILL.mdКомандой платформы
gemini skills install https://github.com/github/awesome-copilot --path skills/context-mapВручную: положить файлы
.devin/skills/context-map/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Похожие
Вопросы о context-map
Как установить context-map в GitHub Copilot?
Через установщик скиллов: npx skills add github/awesome-copilot --skill context-map или gh skill install github/awesome-copilot context-map. Файл окажется в .github/skills/context-map/SKILL.md.
Что делает context-map?
Перед изменениями агент ищет файлы по задаче, зависимости, тесты и похожие паттерны, а затем выдаёт карту таблицами в markdown с блоком оценки рисков.
Можно ли поставить его в Claude или Cursor?
Да, установщик поддерживает несколько агентов: npx skills add github/awesome-copilot --skill context-map -a claude-code. Для Cursor файл кладётся в .cursor/skills/context-map/SKILL.md.
Исходный текст
SKILL.md · MIT
---
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
```markdown
## 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.
© github · MIT · github/awesome-copilot