AIKraft/Skills/code-tour

code-tour

Создаёт CodeTour .tour файлы — пошаговые инструкции с привязкой к файлам и строкам. Полезно для онбординга, обзора PR, объяснения архитектуры или поиска багов. Поддерживает 20 ролей разработчиков и различные типы шагов.

GIGitHub official Разработка ★ 39.8k

Что делает навык

Создаёт CodeTour .tour файлы — пошаговые инструкции с привязкой к файлам и строкам кода, предназначенные для работы с VS Code CodeTour extension. Решает задачи онбординга, обзора PR, объяснения архитектуры и поиска багов через персонализированные пошаговые обходы кодовой базы.

Когда применять

  • Онбординг новых разработчиков (persona: new-joiner)
  • Обзор изменений в Pull Request
  • Объяснение архитектуры проекта
  • Поиск и локализация багов
  • Создание документации на основе README

Как работает

  1. При запросе генерации из документации запустить scripts/generate_from_docs.py для извлечения скелета тура, затем заполнить его данными
  2. Создать JSON-файл тура в директории .tours/, строго соблюдая структуру из references/codetour-schema.json
  3. Использовать примеры из references/examples.md или реальные .tour файлы из GitHub для проверки корректности использования команд, паттернов и навигации
  4. После создания тура обязательно запустить scripts/validate_tour.py для проверки валидности JSON, существования файлов, корректности номеров строк и логической последовательности
  5. Убедиться, что все шаги привязаны к конкретным файлам и номерам строк, а 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 и совместимые) подхватывает его по описанию и следует шагам.