Скил human-summary — краткий отчёт оператору

После прогона проверки качества или архивации технический вывод отвечает на многие вопросы — но не на те четыре, которые интересуют оператора: что сделано, что получилось, что не получилось и что дальше. Скил human-summary добавляет короткую секцию на понятном языке, которая отвечает именно на эти четыре вопроса — каждый раз.

Секция располагается между техническим блоком и меню следующих шагов в конце ответа. Она не заменяет технический вывод — это дополнительный слой для оператора, которому не нужно разбирать таблицы вердиктов.

Четыре подраздела

Структура фиксирована и исчерпывающая. Секция всегда содержит четыре подзаголовка в одном порядке: что было сделано, что получилось, что не получилось или осталось открытым, и что дальше. Добавить пятый подраздел — блокирующая ошибка. Удалить любой из четырёх — тоже: пустой подраздел должен содержать одну строку-заглушку, а не исчезать.

Первая строка после заголовка секции — идентификатор: номер задачи и название. Он нужен потому, что отчёт читают и вне контекста — оператор, пролистывая историю чата, видит готовую секцию без окружающего ответа, и без идентификатора непонятно, к какой задаче она относится.

Контроль понятности

Скил проверяет понятность через три слоя. Первый — список запрещённых слов: файл с ASCII-токенами (термины DevOps, Git-глаголы, тестовый жаргон, названия CI/CD-инструментов), которые нельзя использовать в русской части отчёта. Для каждого запрещённого слова есть русский эквивалент. Перед проверкой по списку запрещённых читается список разрешённых — общепринятые аббревиатуры вроде JSON или HTTP всегда разрешены.

Третий слой — заглушка для отдельных абзацев. Дословный блок — строка лога, вывод команды, фрагмент кода — можно обернуть в явный маркер и освободить от проверки. Этот маркер предназначен для цитат технического содержимого, но не для повествовательного текста. В одном отчёте допустимо не более двух таких блоков; третий вызывает предупреждение, пятый — блокирует весь отчёт.

Где применяется

Скил загружается тремя командами. /dr-qa запускает его после отчёта о качестве, при любом вердикте. /dr-compliance — после отчёта о соответствии. /dr-archive — после обновления активного контекста. Во всех трёх случаях источником для краткого отчёта служит только что созданный артефакт, а не кешированное состояние.

Общий бюджет по объёму — от 150 до 400 слов на все четыре подраздела. Если исходный материал больше, скил сжимает его агрессивно: цель — быстрое чтение, а не подробный индекс.

Общая картина — в посте что такое Datarim. О том, как с самого начала фиксируется намерение оператора, рассказывает пост о скиле init-task-persistence.