GI
code-tour
Создаёт CodeTour .tour файлы — пошаговые инструкции с привязкой к файлам и строкам. Полезно для онбординга, обзора PR, объяснения архитектуры или поиска багов. Поддерживает 20 ролей разработчиков и различные типы шагов.
Что делает навык
Создаёт CodeTour .tour файлы — пошаговые инструкции с привязкой к файлам и строкам кода, предназначенные для работы с VS Code CodeTour extension. Решает задачи онбординга, обзора PR, объяснения архитектуры и поиска багов через персонализированные пошаговые обходы кодовой базы.
Когда применять
- Онбординг новых разработчиков (persona: new-joiner)
- Обзор изменений в Pull Request
- Объяснение архитектуры проекта
- Поиск и локализация багов
- Создание документации на основе README
Как работает
- При запросе генерации из документации запустить scripts/generate_from_docs.py для извлечения скелета тура, затем заполнить его данными
- Создать JSON-файл тура в директории .tours/, строго соблюдая структуру из references/codetour-schema.json
- Использовать примеры из references/examples.md или реальные .tour файлы из GitHub для проверки корректности использования команд, паттернов и навигации
- После создания тура обязательно запустить scripts/validate_tour.py для проверки валидности JSON, существования файлов, корректности номеров строк и логической последовательности
- Убедиться, что все шаги привязаны к конкретным файлам и номерам строк, а narrative arc соответствует целевой роли разработчика
Примеры запросов агенту
Создай CodeTour для онбординга нового разработчика в этот проект, используя README как основу
Напиши пошаговый тур для обзора этого Pull Request, выделив ключевые изменения в коде
Сгенерируй CodeTour, объясняющий архитектуру модуля X, с привязкой к конкретным файлам и строкам
Что понадобится
- Python (для запуска скриптов validate_tour.py и generate_from_docs.py)
- VS Code CodeTour extension (для просмотра результатов)
- Доступ к репозиторию и файловой структуре проекта
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «github-code-tour» из репозитория:
# https://github.com/github/awesome-copilot
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r github-code-tour/ ~/.claude/skills/github-code-tour/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.