| name | editorial-review-wizard |
| description | Провести автора через правки живого редактора из DOCX (comments + Track Changes), уже импортированные в book/ru/editorial/_review-imports/. LLM типизирует правки, принимает простое только после редакторской проверки, важное выносит на accept/reject/edit/defer, ведёт прогресс в процентах и собирает проверяемые патчи. Используй, когда нужно разобрать редакторский DOCX и довести главу до финала. Триггеры: «разбери правки редактора», «пройди worksheet», «разбери batch Тома 1», «продолжи редакторский проход». |
editorial-review-wizard
Ведёт LLM-driven проход по правкам живого редактора. Скрипты уже извлекли и переякорили DOCX; твоя
работа — типизировать, принимать ясную корректуру редактора, выносить важное автору, фиксировать
решения и собирать патчи. Полный метод — meta/human-editor-review-import.md. Роли: скрипт =
механика, ты = решения. Regex/script может только шортлистить и проверять кандидаты; wording/prose
acceptance делаешь ты или автор.
Перед стартом — прочитай
meta/human-editor-review-import.md — артефакты и правила прохода.meta/human-editor-decision-rules.md — каноническая граница: что LLM закрывает сама, а что
остаётся author queue.book/ru/editorial/review-navigation.md — короткая авторская навигация и схема.CLAUDE.md правила 1–2, 8–9, 18 — источники, protected zones, словарь, голос.- Сам batch:
book/ru/editorial/_review-imports/<id>/ — items.jsonl, worksheet.md,
progress.md, by-chapter/[slug]/worksheet.md, decisions.jsonl, chapter-acceptance.jsonl;
видимое зеркало для автора: book/ru/editorial/[slug]/worksheet.md.
Если batch ещё не разложен
python3 scripts/editorial_review/import_docx_review.py --docx <input.docx> --review-id <id> --tome tom1
python3 scripts/editorial_review/render_review_markdown.py --batch book/ru/editorial/_review-imports/<id>
Порядок прохода
- Открой
progress.md — где остановились и какая следующая глава в порядке чтения.
- Идёшь по canonical
by-chapter/[slug]/worksheet.md или по его зеркалу
book/ru/editorial/[slug]/worksheet.md; внутри главы — сверху вниз по приоритетам worksheet:
сначала смысл/голос/структура и вопросы редактора, затем факты/protected zones, затем конкретная
корректура/механика/пунктуация; закрытые/folded решения внизу просматриваются бегло, но в
развернутом формате: решение, финальный текст и заметка должны быть видны прямо в worksheet.
Не используй порядок папок в VS Code как
маршрут: файловый браузер сортирует технически.
- Для каждого item считай галочку автора как intent, сделай final check и только затем зафиксируй
итоговое решение в
decisions.jsonl.
- После главы:
build_patch.py → просмотр patches/<chapter>.patch → apply_review_patch.py --slug <chapter>.
- Перегенерируй
progress.md (render) и покажи автору процент + что осталось.
- Когда глава финально принята, зафиксируй статус в
chapter-acceptance.jsonl.
Как типизировать
Каноническое правило: meta/human-editor-decision-rules.md. Коротко: локальная корректура без
смыслового риска закрывается LLM после final check; смысл, голос, структура, факты, protected zones
и неоднозначные места остаются author queue. Галочка автора — intent, не прямое применение. Перед
ready по главе обязательно сделай второй author-priority audit: если закрытая правка меняет смысл,
голос, метафору, переход, recap, термин, факт, источник или publishing metadata, верни её наверх
worksheet append-only решением defer + unsure: true, пока автор не даст intent.
Жёсткие правила
- Никогда не правь книгу напрямую в обход
decisions.jsonl → build_patch.py → apply_review_patch.py.
- Не переписывай абзац целиком ради одной правки — патч локальный.
- Голос автора важнее гладкости: правку, которая усредняет голос, рекомендуй
reject/edit.
- Низкая
anchor_confidence → сначала найди точное место в Markdown, потом решение.
- Не выдумывай источники/цифры. Спорный факт →
verify к автору с указанием, что проверить.
- Нет script-only acceptance: даже простая wording/prose-правка становится
auto только после
LLM/author review и append в decisions.jsonl.
- Закрытые решения в worksheet не рендерить одной compact-строкой: автор должен видеть
Решение,
Редактор, Было, Предложение редактора, Закрыто так, Почему / заметка, Контекст.
- Никогда не переносить галочку worksheet в
decisions.jsonl слепо: сначала final check по смыслу,
голосу, ошибкам, protected zones и текущему контексту.
- Нулевая author queue после реального DOCX-прохода живого редактора — красный флаг. До
ready
перепроверь закрытые comment_only, edit/reject/defer, низкий anchor и любые заметки про смысл,
голос, структуру, термины, факты или источники.
git commit/push — только по команде автора (правило репозитория).
Рекомендации в worksheet (recommendations.jsonl, advisory)
Пиши сюда свою рекомендацию по каждому важному item, чтобы она была видна автору в worksheet
рядом со слотами (это НЕ решение):
{"id":"C00049","rec":"edit","rationale":"почему","rec_text":"предлагаемый вариант","by":"llm","ts":"…"}
rec: accept|reject|edit|defer|verify. doc_page (страница Word) импортёр проставляет сам —
ссылайся на неё, когда отправляешь автора искать место в DOCX.
Формат решения (decisions.jsonl, append-only)
{"id":"C00042","decision":"edit","final_text":"…","note":"","by":"author","unsure":false,"ts":"…"}
decision: auto|accept|reject|edit|defer. final_text обязателен для auto|accept|edit.
Для вставок/двусмысленных мест можно дать before (точный якорь в тексте).
Формат приемки главы (chapter-acceptance.jsonl, append-only)
{"target_slug":"04-lestnitsa-rushitsya-vhod-i-seredina","target_path":"book/ru/chapters/04-lestnitsa-rushitsya-vhod-i-seredina.md","decision":"accepted","patch":"patches/04-lestnitsa-rushitsya-vhod-i-seredina.patch","by":"author","ts":"…","note":""}
decision: ready|accepted|applied|blocked|defer. Это статус главы/секции, не отдельной правки.
Отчёт автору после прохода главы
Коротко: «Глава X — разобрано N% (k из m). Применил сам: A. Ждут тебя: B (список сутью). Не уверен: C.
Отложено: D.» Затем предложи следующую главу.
