Перейти к основному содержимому

Составной анализ

Соберите находки нескольких проверок в один список приоритетов: сценарий 18 для оптимизации, сценарий 19 для стандартов.

Руководства

Командная строка CodeGraph объединяет результаты нескольких проверок и помогает выбрать, что разбирать первым. Она объединяет повторяющиеся находки, фиксирует конфликты и ранжирует общий список. Сценарий 18 сводит сигналы для оптимизации, а сценарий 19 — находки по стандартам и качеству кода. Результат содержит пояснение, находки и метаданные объединения. Составной анализ предлагает дальнейшую работу, но не меняет исходники. Выбранные изменения вносите отдельно.

Выберите оркестратор

Выберите оркестратор
Оркестратор Назначение Следующий шаг
s18 / scenario_18 Объединяет находки по безопасности, производительности, архитектуре, рефакторингу и техническому долгу в предложения по оптимизации. Выберите предложение, определите измеримый результат и создайте задачу реализации.
s19 / scenario_19 Объединяет находки по стандартам и качеству кода. Проверьте каждую находку по правилу и ревизии исходников, затем назначьте ответственного.

CLI поддерживает эти два составных оркестратора. Полный аудит проекта описан в руководстве по аудиту на основе CPG.

Запустите составной анализ из CLI

Выполняйте команды в PowerShell из корня репозитория CodeGraph и используйте настроенное Python-окружение. Импортируйте проект и настройте его CPG и LLM по руководству по конфигурации. Перед запуском проверьте, что CPG соответствует нужной ревизии исходников. Команда использует настроенный проект и область из запроса; отдельного параметра пути к исходникам у неё нет.

Сохраните результаты в отдельные файлы:

python -m src.cli composition run "Проанализируй ограниченный компонент и предложи оптимизации." --orchestrator s18 --language ru --output composition-s18.json
python -m src.cli composition run "Проверь ограниченный компонент по принятым стандартам." --orchestrator s19 --language ru --output composition-s19.json

Запишите ревизии исходников и CPG, запрос, оркестратор, конфигурацию, вызванные подсценарии, метаданные объединения, конфликты и находки. Храните JSON-файл вместе с этими данными, чтобы сравнить результат с повторным анализом.

Команда использует запрос, оркестратор, язык и подсценарии из конфигурации проекта. CLI принимает флаги --sub-scenario, --parallel/--sequential и --merge-strategy, но они не меняют настроенный запуск.

Откройте созданный JSON-файл. Проверьте metadata, список выполненных подсценариев и ошибки, затем сопоставьте находки с исходниками. Используйте файл для дальнейшей обработки: вывод в терминале содержит пояснения.

Выполните выбранное изменение

После анализа выберите предложение и создайте отдельную задачу реализации. Приложите результат, ссылки на найденный код и ревизию проекта. Определите измеримый результат: например, время выполнения выбранной операции при фиксированной нагрузке. В задаче укажите файлы, проверки поведения и способ отката. После изменения повторите анализ с теми же входами и сопоставьте находки и измерения. CLI составного анализа формирует предложения; изменения исходников вносятся в отдельной задаче реализации.

Проверьте результат

  • Дедупликация и ранжирование помогают выбрать порядок расследования; каждую исходную находку проверяйте по привязанной ревизии.
  • Метаданные разрешения конфликтов описывают объединение. Решение ответственного проверяющего фиксируется отдельно.
  • Предложение об изменении ещё нужно проверить. Сопоставьте его с текущей ревизией исходников перед реализацией.
  • Для пустого результата проверьте область и конфигурацию подсценария. При ошибке сохраните её в отчёте, восстановите нужный сервис и повторите проверку.

Связанные руководства