AIKraft/AI/Войти
AIKraft/Skills/Улучшить архитектуру кодовой базы

Улучшить архитектуру кодовой базы

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock official Дизайн

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

Анализ кодовой базы для выявления архитектурного трения и предложения рефакторинга, превращающего поверхностные модули в глубокие. Цель — повышение тестируемости и способности ИИ ориентироваться в коде.

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

  • Необходимость улучшить архитектуру в конкретной области, указанной пользователем (модуль, подсистема, проблемное место).
  • Автоматический поиск наиболее часто изменяемых участков кода (hot spots) для приоритизации улучшений.
  • Разработка рекомендаций по углублению архитектуры с использованием специфического словаря проектирования.
  • Учет доменной модели и существующих архитектурных решений (ADRs) для избежания повторного обсуждения принятых решений.

Как работает

  1. Определить область сканирования: использовать направление от пользователя или проанализировать историю коммитов (git log --oneline) для выявления часто изменяемых файлов.
  2. Изучить доменный словарь (GLOSSARY.md) и архитектурные решения (ADRs в docs/adr/) в целевой области.
  3. Применить инструмент Skill с параметром "codebase-design" для получения словаря (module, interface, depth, seam, adapter, leverage, locality) и принципов (тест на удаление, "интерфейс — это поверхность теста", "один адаптер = гипотетическая граница, два = реальная").
  4. Сформулировать предложения по рефакторингу, строго используя термины из словаря codebase-design и избегая слов "component", "service", "API", "boundary".
  5. Представить возможности углубления архитектуры в виде наглядного HTML-отчета.
  6. Проработать выбранный вариант изменений в деталях.

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

Улучши архитектуру модуля аутентификации.
Найди и предложи улучшения для участков кода, которые часто меняются.
Проанализируй архитектуру подсистемы обработки заказов и подготовь отчет.

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

  • Доступ к Git-репозиторию (для выполнения git log --oneline).
  • Наличие файла GLOSSARY.md с доменным словарем.
  • Наличие директории docs/adr/ с архитектурными решениями.

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

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

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

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