AIKraft/AI/Войти
AIKraft/Skills/Визуальная сводка

Визуальная сводка

Turn a PR, branch, commit, or git diff into an interactive visual recap with diagrams, file maps, API/schema summaries, annotated diffs, and focused review notes.

builderio official Дизайн

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

Skill «Визуальная сводка» (Visual Recap) преобразует git diff, PR или коммит в интерактивный Agent-Native Plan с диаграммами, картами файлов и аннотированными диффами, позволяя ревьюеру оценить масштаб изменений до детального просмотра кода. Это заменяет текстовые сводки в чате на структурированный, аннотируемый план, созданный через инструменты Plan MCP.

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

  • Ревью больших PR, веток или коммитов, затрагивающих несколько файлов, схемы данных, API-контракты или архитектуру.
  • Автоматическая генерация обзора изменений из diff PR с помощью GitHub Action.
  • Запрос агента на создание сводки по запросу (например, «recap this PR» или «show me what this branch changed»).
  • Создание локальных/оффлайн-сводок для приватных данных без записи в хостинг-базу данных Plan.

Как работает

  1. Определить контекст: собрать изменения всей рабочей единицы (thread), отделив их от предыдущего состояния, и решить, использовать ли хостинг или локальный режим (local-files).
  2. Провести анализ diff: составить инвентарь измененных маршрутов, компонентов, состояний и API, выделить ключевые файлы для детального разбора.
  3. Сформировать структуру плана: добавить заголовок UI-воздействия (wireframes, если есть UI), краткое описание изменений, блоки data-model/api-endpoint и дерево файлов с флагами изменений.
  4. Создать блок «Key changes»: выбрать 3–8 ключевых файлов, сгруппировать их в горизонтальные вкладки с диффами (до ~150 строк на вкладку) и аннотациями.
  5. Опубликовать результат: использовать инструмент create-visual-recap через Plan MCP для публикации Agent-Native Plan (или создать локальный MDX файл в режиме local-files).
  6. Проверить качество: убедиться, что wireframes соответствуют стандартам (references/wireframe.md), а текст не содержит лишнего boilerplate.

Примеры запросов агенту

Создай визуальную сводку для этого PR.
Покажи, что изменилось в этой ветке.
Сделай recap текущего коммита.

Что понадобится

  • Инструменты Plan MCP (create-visual-recap, get-plan-blocks и др.) или локальные утилиты (collect-diff, plan local check/serve/verify).
  • Файлы справки: references/connection.md, references/local-files.md, references/wireframe.md.
  • Доступ к diff, истории коммитов или кодовой базе для анализа изменений.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «visual-recap» из репозитория: # https://github.com/builderio/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r visual-recap/ ~/.claude/skills/visual-recap/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.