Сценарий 12: планирование технического долга

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

Выбор поверхности

Выбор поверхности
Задача	Поверхность	Результат
Объяснить и разбить погашение долга для принятой задачи	типизированный сценарий 12	анализ и предлагаемый план
Получить текущую сводку проекта	`codegraph_quality_tech_debt_report_get()`	dead methods, hotspots, quality summary
Найти неиспользуемую или неэффективную конфигурацию	`python -m src.cli dogfood config-check`	находки по гигиене конфигурации

У dashboard MCP нет входных полей, и он не создаёт план погашения. План формируется отдельным процессом; команда dogfood выполняет свой сценарий анализа технического долга.

Предварительные условия и область

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

Сложность или кандидат в мёртвый код не задают приоритет автоматически. Влияние на продукт, частота изменений, владелец, стоимость исправления и риск требуют отдельных свидетельств.

Запуск типизированного сценария

from src.digital_employees.runtime.scenarios import (
    RoleBoundScenarioInvocationRequest,
    invoke_role_bound_scenario_request,
)

request = RoleBoundScenarioInvocationRequest(
    query="Ранжируй долг в конвейере импорта и предложи ограниченные этапы погашения.",
    employee_id="codegraph_developer",
    scenario_id="scenario_12",
    event_type="implementation_start",
    context={
        "project_key": "codegraph",
        "namespace": "default",
        "task_id": "<task-id>",
        "source_refs": ["<revision-ref>", "<quality-evidence-ref>"],
        "file_paths": ["<bounded-source-path>"],
    },
)
result = invoke_role_bound_scenario_request(request)

Для отдельной агрегированной сводки вызовите dashboard MCP:

codegraph_quality_tech_debt_report_get()

Как читать результат

Для сценария 12 сохраните предложенные этапы, ссылки на исходники, допущения, риски и метаданные вызова. Для dashboard-сводки — время наблюдения и ревизию проекта. Для config-check — точную ревизию конфигурации и вывод команды.

До включения работы в план воспроизведите значимые находки в исходниках или целевом тесте. Сводный план предлагает приоритеты; тяжесть долга подтверждается исходниками и целевыми тестами.

Границы безопасности и полномочий

Ни одна из трёх поверхностей не редактирует код, не утверждает план, не меняет продуктовый приоритет и не закрывает критерий приёмки. Область и приоритет одобряет человек. Реализация по-прежнему требует tests-first изменения и профильных дорожек ревью.

Разделяйте результаты разных ревизий. Данные дашборда позволяют оценить объём долга; при их отсутствии используйте исходники и целевые тесты.

Ошибки и восстановление

MCP вернул текст ошибки: проверьте контекст активного проекта и CPG; не считайте ошибку нулевым значением.
Сценарий дал общий ответ: сузьте компонент, ссылки на свидетельства и вопрос решения.
config-check нашёл ключ: подтвердите, что он действительно не используется, прежде чем удалять конфигурацию.
Приоритет оспаривается: разделите продуктовые и эксплуатационные данные и повторите ревью решения.

Контракт с исходным кодом

Статья привязана к следующим источникам:

src/mcp/tools/project_suite/tech_debt.py — dashboard-агрегация без аргументов;
src/workflow/scenarios/code_quality/tech_debt.py — анализ сценария;
src/digital_employees/runtime/scenarios/role_bound_scenario_invoker.py — типизированная маршрутизация;
src/digital_employees/runtime/scenarios/employee_scenario_invocation.py — владелец-разработчик и политика события;
src/cli/dogfood_suite/dogfood_commands.py — проверка гигиены конфигурации.