Human Summary

Обзор

Human Summary — канонический контракт человеческого пересказа, который выводится в конце команд /dr-compliance и /dr-archive. Пересказ стоит между техническим блоком (вердикт, запись архивного документа, проверочный список) и блоком следующих шагов. Адресат — человек, который не открывал ни одного файла и не разработчик. Цель — быстрый прочёт, не точный индекс технического вывода.

Зачем это нужно

Технический вывод Датарима настроен на агента в петле: вердикты, пути файлов, проверочные списки, структурированные CTA. Человек-оператор, читающий чат, хочет ответы на четыре вопроса: что сделано, что получилось, что не получилось, что дальше. Без этого скила оператор открывает архивный документ, чтобы вытащить эти четыре ответа. Со скилом — четыре ответа уже в чате, над блоком следующих шагов, в 150–400 словах.

Контракт вывода

Раздел в формате markdown с заголовком (## Отчёт оператору для русского, ## Operator summary для английского) и четырьмя фиксированными подразделами в строгом порядке: «Что было сделано», «Что получилось», «Что не получилось / осталось открытым», «Что дальше». Язык совпадает с языком последнего сообщения оператора — по умолчанию для экосистемы Arcanada это русский.

Стиль

• Простой язык. Без жаргона. В русском тексте не использовать английские заимствования, если есть русский эквивалент.
• Без таблиц. Только маркированные списки или сплошной текст.
• Без голых идентификаторов задач — всегда вместе с одной фразой-расшифровкой.
• Без аббревиатур без расшифровки (CI/CD, TDD, PRD).
• Без многоуровневых вложенных списков. Только один уровень маркеров.
• Без эмодзи. Без смешения языков в одном пересказе.
• Жёсткий верхний предел: 400 слов на все четыре подраздела.

Запрещённые и разрешённые слова

Три ортогональных слоя обеспечивают «плоский» язык. Список из примерно пятидесяти заимствованных слов запрещён в русской прозе; список из примерно тридцати общепринятых сокращений (JSON, OAuth, HTTP, CLI, RFC, CI/CD и так далее) разрешён всегда и проверяется первым. Внутри одного пересказа автор может процитировать вывод инструмента, текст ошибки или код дословно, обернув цитату в ограниченный «литеральный блок»; внутри блока — до 15 строк, внутри одного пересказа — не более двух таких блоков. Нарушения собираются по нарастающей: первое — пометка, третье — заметное предупреждение над пересказом, пятое — пересказ отклоняется, и оператор получает однострочное объяснение и предложение перезапуска.

Старые архивы

Контракт проверяет только живой вывод — текст в чате и опциональную дописанную секцию в отчёте проверки качества или проверки итогов. Архивные документы, написанные до появления контракта, никогда не перепроверяются; добавление нового слова в список запрещённых не делает старый архив «красным».

Кем загружается

Обязательно: /dr-qa (Step 8), /dr-compliance (Step 8), /dr-archive (Step 8). В будущем может быть переиспользован другими pipeline-командами с тем же контрактом.

Тесты

tests/test-human-summary-contract.bats — 24 spec-regression теста: существование файла скила, четыре обязательных подзаголовка, мини-примеры RU и EN, объявление бюджета длины, файлы запрещённых и разрешённых слов, контракт литерального блока, шкала нарушений, правило не-валидации старых архивов, перекрёстные ссылки из всех трёх команд.