Ревью отчётов

koi-report-review

Прогнать отчёт через проверки стиля, постановки, подзадач и результатов — писать в файл только после «пройдено».

Что делает

Перед сохранением отчёта запускает набор проверок. На этапе постановки — стиль, ясность setup и качество подзадач. После прогона — полноту результатов и человеческие формулировки. Параллельно следит, чтобы колонка карточки на доске совпадала с фактом работы.

Зачем

Чтобы в репозиторий не уходили сырые или противоречивые отчёты, а доска не врала: «в работе» и «готово» отражают реальность.

Когда вызывать

• Пишете постановку нового отчёта до запуска
• Заполняете результаты после прогона
• Просите «проверь отчёт» перед сохранением или публикацией

Как вызвать

Передайте AI-помощнику фрагмент отчёта и этап (постановка или результаты). Попросите довести до «пройдено» по сценарию ревью и синхронизировать колонку на доске.

Проверь постановку отчёта (§1–§3) по сценарию ревью отчётов:
критики стиля, ясности и подзадач — до «пройдено».

Схема работы

Схема — цикл правок. От этапа зависит набор проверок. Пока есть замечания, черновик переписывают и снова отправляют на ревью. В файл попадают только после «пройдено».

flowchart TD
  A[Черновик отчёта] --> B{Какой этап?}
  B -->|постановка| C[Стиль + ясность + подзадачи]
  B -->|результаты| D[Полнота результатов]
  C --> E{Пройдено?}
  D --> E
  E -->|нет| F[Переписать]
  F --> A
  E -->|да| G[Сохранить в файл]