ukrainian-fiction · git:20261106.d0695bc · 2026-11-06 · sha256 443b57725220f522
ukrainian-fiction git:20261106.d0695bcA
Immutable. This exact content never changes and is served at /api/v1/blob/443b57725220f522.
---
name: ukrainian-fiction
description: >
Диспетчер пакета художньої прози українською. Визначає, які скіли пакета
потрібні для роботи і в якому порядку: письмо (write), будова сцени й глави
(scene), ідеї сцен (ideas), аудит і чистка (audit), читацький тест
(reader), налаштування книги й картки героїв (setup). Використовувати,
коли запит на художній текст охоплює кілька задач одразу: «напиши главу й
перевір», «доведи главу до чистового стану», «сплануй сцену і напиши», а
також коли незрозуміло, який скіл пакета брати. Не вмикатися на технічний
текст — документацію, інструкцію, HLD (це ukrainian-tech-docs) — і на запит
однієї задачі: його бере відповідний скіл напряму. Правила конкретної книги
(герої, словник, лор, тон) пакет не тримає: їх дає профіль книги в проєкті.
---
# Диспетчер пакета художньої прози
Пакет ділиться на шість скілів, кожен робить одну задачу. Цей файл каже, який
скіл узяти і які правила діють між скілами. Зміст правил лежить у скілах і в
спільній теці `shared/`.
Пакет містить те, що працює безвідносно до книги: мову, правопис, ремесло
речення, діалогу, сцени й глави, порядок аудиту. Усе, що належить одній
книзі, — герої, лор, словник, тон, межі голосу, де лежать глави — живе в
проєкті й підключається через **профіль книги** (`shared/profile.md`).
## 1. Задача → скіл
| Задача | Скіл | Коли |
|---|---|---|
| Пишеться нова сцена, епізод, глава, діалог, чернетка чи заділ, або змінюється зміст наявного тексту | `write` | «напиши сцену», «для наступної глави», «в стилі роману», «напиши діалог», правка змісту на прохання автора; «дай промпт для реплік», «зведи відповіді моделей на промпт» (`character-card.md`, Ч8) |
| Ідеї сцен і поворотів, коли задуму ще немає; розвиток вибраної ідеї в діалозі з автором до каркаса | `ideas` | «дай ідеї для сцени», «придумай ідеї сцени», «ідеї для глави», «що могло б статися далі», «запропонуй поворот, задуму ще немає», «сплануй сцену» без задуму; явний запит режиму «повністю на ШІ» (`ideas/SKILL.md`, розд. 4). Прози не пише |
| Будова сцени, епізоду, глави | `scene` | обговорення або план сцени, епізоду, глави за задумом автора; «перевір будову глави»; «перевір зв'язаність епізодів»; «перевір факти всередині глави»; розбір готової глави на рівні сюжету. Прози не пише |
| Аудит готового тексту й чистка мови | `audit` | «перевір», «перевір мій текст», «перевір згенерований текст», «перевір на логіку, стилістику, побудову речень», «перевір, як написано», «чи звучить це як ШІ», «що не так із главою», «почисти главу», «виправ главу», «прибери ШІ з тексту», «діагностика кальок у главі», «перевір мову», «прожени мову по главах» |
| Налаштування книги: профіль, слоти, картки героїв | `setup` | «налаштуй книгу», «заведи профіль книги», «заведи картки героїв», «створи картку персонажа», «перевір картку героя». Прози не пише й глав не править |
| Читацький тест | `reader` | «тест читача», «читацький тест», «прожени главу очима читача», «чи зрозуміло це без мене», «як це прочитає людина з вулиці»; сам не вмикається |
Неоднозначні запити розводяться так:
| Запит | Скіл | Чому |
|---|---|---|
| «почисти главу» | `audit` | аудит із мовною правкою (`audit.md`, А1); зміна подій, канону, задуму чи голосу (клас 3) — лише з дозволу автора, і тоді це `write`; узгодження факту класу 1 — у самому `audit` (розд. 2) |
| «перевір главу», а автор потім просить змінити зміст | `audit` → `write` | аудит, після якого автор просить змінити зміст, — це ще й письмо |
| «перевір факти всередині глави» | `scene` | окремий розбір фактів — `scene`, С16; факти як один рівень ширшого аудиту — `audit`, А2 |
| «перевір будову глави» | `scene` | окремий розбір будови — `scene`; будова як один із рівнів ширшого аудиту («перевір главу») — `audit`, А2 |
| «перевір на логіку, стилістику, побудову речень» | `audit` | повний аудит за порядком А2: логіка всередині глави — факти (С16), будова й дискурс (С1–С15, С17); стилістика — діалог, мова, кальки; побудова речень — Р1–Р9. Звірка з попередніми главами — не аудит |
| «перевір, як написано» і «перевір зв'язаність епізодів» | «як написано» — `audit`, лише рівні Д, Р, Л, К, О; «зв'язаність» — `scene`, розбір готової глави С1–С17 | дві окремі перевірки. Якщо автор замовив обидві, обидві лише знахідками, а правка — після обох: інакше відшліфоване речення може опинитися в епізоді, який друга перевірка запропонує переставити (А2) |
| «перевір главу», потім вердикт «усе за рекомендацією» | `audit`, правка за вердиктом | без питання вносяться лише знахідки класів 1 і 2, клас 3 — окремим списком на перепитування (`findings.md`, А7); зміна змісту — ще й `write` |
| «напиши главу», а каркаса ще немає | `write`, за бажанням автора спершу `scene` чи `ideas` | будову вирішує автор (розд. 2): спитати, чи писати за його задумом, чи спершу план; у режимі «ідеї плюс діалог» (`ideas/SKILL.md`, розд. 2) — ще й чи дати ідеї на вибір. У режимі «без запуску» ідей не пропонувати |
| «варіанти повороту», «сплануй сцену» | `scene`, якщо є задум, каркас чи план автора; `ideas`, якщо задуму ще немає чи є лише зерно («сплануй сцену сварки, як — не знаю») | `scene` працює із задумом автора, `ideas` — із зерном чи з нуля (`ideas/SKILL.md`, розд. 1) |
| «зроби все сам», «придумай сцену повністю», «вигадай за мене» | без задуму чи каркаса — `ideas`, режим «ідеї плюс діалог»; з каркасом автора («ось каркас, зроби все сам») — `write` | повний режим вмикає лише явний запит саме цього режиму й підтвердження автора (`ideas/SKILL.md`, розд. 4); схожа фраза його не вмикає в жодному з двох випадків |
| «почисти текст», «тест читача», «чи звучить це як ШІ» без типу тексту | за самим текстом | глава, сцена, діалог, художня чернетка чи заділ — цей пакет; технічний документ, технічна нотатка, інструкція — `ukrainian-tech-docs`. З тексту не видно — одне питання авторові |
| «перевір картку героя» | `setup` | картка — не художній текст, а довідка про героя: її звіряють із шаблоном (`character-card.md`, Ч6), а не аудитують за рівнями мови |
| «доведи главу до чистового стану» | `audit` → `write` → (`reader`, якщо автор просить) | аудит дає знахідки, письмо вносить погоджені правки й проходить самоперевірку |
Скіл викликають інструментом Skill за повним іменем: `ukrainian-fiction:write`,
`ukrainian-fiction:audit` тощо. Там, де такого інструмента немає, — прочитати
`SKILL.md` потрібного скіла з теки `skills/<скіл>/` плагіна.
## 2. Правила між скілами
Ці правила не належать жодному скілу окремо. Скіли, яким вони потрібні, повторюють
їх у своїх передумовах.
**Скіл про мову й ремесло, не про книгу.** У файлах пакета немає жодного
імені героя, назви світу, слова зі словника книги чи факту лору. Приклади
у файлах — приклади, не канон.
**Будову вирішує автор.** Сюжетні рішення, повороти, поведінка персонажів
й архітектура глави належать авторові. Помічник пропонує варіанти, а не
підсовує готовий абзац замість питання. Кожен варіант будови має три
складники: механізм (як це працює в сцені), наслідок (що зміниться для
читача й сюжету) і ризик (чому може не спрацювати). Так автор відкидає
слабкий варіант без зайвого обговорення. Автор вирішує і те, чи доручити
будову ШІ: режим «повністю на ШІ» скіла `ideas` вмикається лише на явний
запит автора й після його підтвердження (`ideas/SKILL.md`, розд. 4).
Підстава не лише в етиці. У StoryScope 278 оповідань Gemini пропустили
крізь стильове переписування (його виконував сам Gemini за схемою LAMP),
і класифікатор за оповідними ознаками розпізнавав їх так само: 93,9%
macro-F1 проти 95,5% до правки ([StoryScope, §4.2](https://arxiv.org/html/2604.03136v6#S4.SS2)).
Висновок пакета із цього досліду, ширший за саму вибірку: якщо будову
придумала модель, шліфування речень її не зробить авторською. Межа досліду:
LAMP переписує окремі фрагменти тексту. Чи стає будова авторською, коли
автор сам переробляє структуру чи довго працює з моделлю, дослід не
перевіряв.
**Стадії не взаємовиключні.** Стадію визначає те, що відбувається з
текстом, а не назва запиту. Художній текст змінюється — стадії Письмо й
Самоперевірка обов'язкові. Профіль і картки героїв — не художній текст:
їх заводить `setup` за своїми стадіями. Хто їх проходить, залежить від зміни:
| Зміна | Скіл | Письмо | Самоперевірка |
|---|---|---|---|
| Мовна чистка за пунктами Л, К, О, Р без зміни змісту (`audit.md`, А1) | `audit` | правила рівнів, за якими правиться: `language.md`, `calques.md`, `orthography.md`, `sentence.md` | `final-pass.md`, А5, і тести правки `findings.md`, А4 |
| Узгодження факту в межах глави (С16, клас 1, `findings.md`, А7) | `audit` | `write/SKILL.md`, розд. 3 | `final-pass.md`, А5, і тести правки `findings.md`, А4, А7 |
| Новий текст або зміна змісту, канону, подій чи голосу | `write` | `write/SKILL.md`, розд. 3 | `final-pass.md`, А5 |
Аудит, після якого автор просить змінити зміст, — це ще й `write`.
**Закривальний рядок — один на всю роботу.** Кожен скіл, що працював, додає
до рядка свою частину (розд. 3). Стадії, якої в рядку немає і пропуск якої
не пояснено, не пройдено, і слово «готово» не пишеться.
**Профіль книги один для всіх скілів** — `shared/profile.md`. Профілю немає —
кожен скіл каже це вголос і не вигадує вмісту слотів.
## 3. Закривальний рядок у кожному скілі
Перед словом «готово» й перед записом тексту в сховище виконавець пише рядок
стадій — які стадії пройдено і які файли на кожній прочитано. У рядку стоять
файли, які справді прочитано в цій роботі, а не назви стадій із таблиці: так
рядок звіряється з викликами інструментів у розмові. Стадію пропущено —
назвати, чому.
| Скіл | Зразок рядка |
|---|---|
| `write` | `Стадії: вхід (write/SKILL, profile, профіль книги, канон голосу, словник, еталонні уривки, кінець попередньої глави) · письмо (language, sentence, dialogue, orthography) · самоперевірка (final-pass А5, чек-лист)` |
| `ideas` | `Стадії: вхід (ideas/SKILL, profile, профіль книги, канон фактів) · режим: ідеї плюс діалог (запит / профіль / типовий) · ідеї (scene-chapter) · текст не змінювався` |
| `scene` | `Стадії: вхід (scene/SKILL, profile, профіль книги, канон голосу, словник) · будова (scene-chapter, findings А3) · текст не змінювався` |
| `audit` | `Стадії: вхід (audit/SKILL, profile, профіль книги, канон голосу, словник) · аудит (audit А1–А2, findings А3, scene-chapter, dialogue, sentence, language, orthography) · текст не змінювався` |
| `audit`, чистка | `Стадії: вхід (…, еталонні уривки) · аудит (audit А1–А2, findings А3, …) · чистка — письмо (language, calques, orthography, sentence) · самоперевірка (final-pass А5, чек-лист; findings А4, А7)` |
| `audit`, правка за вердиктом | `Стадії: вхід (…) · аудит (audit А1–А2, findings А3, …) · правка за вердиктом — письмо (language, sentence, …; write/SKILL розд. 3, якщо змінено зміст) · самоперевірка (final-pass А5, чек-лист; findings А4, А7)` |
| `write`, промпт для реплік | `Стадії: вхід (write/SKILL, profile, профіль книги, картка героя) · промпт для реплік (character-card Ч8, replica-prompt) · текст не змінювався` |
| `setup` | `Стадії: вхід (setup/SKILL, profile, профіль книги) · майстер (book-setup М1–М4, шаблон профілю, шаблон картки, character-card) · створено: <файли> · порожнім лишилось: <поля>` |
| `setup`, картка | `Стадії: вхід (setup/SKILL, profile, профіль книги) · картка (book-setup М2 кроки 4 і 6, character-card, шаблон картки) · створено: <файл>` |
| `setup`, перевірка картки | `Стадії: вхід (setup/SKILL, profile, профіль книги) · перевірка картки (character-card Ч1–Ч6) · картка не змінювалась` |
| `reader` | `Стадії: вхід (reader/SKILL, profile, профіль книги; перелік — від автора) · читацький тест (reader-test А6, findings А3) · читач: агент fiction-reader · текст не змінювався` |
**Профілю немає** — рядок каже це словами: `профіль: немає`.
## 4. Де лежать файли
Шляхи в усіх файлах пакета короткі: `language.md`, `audit.md`. Повна адреса —
від кореня плагіна:
| Файл | Де |
|---|---|
| `profile.md`, `findings.md` (А3, А4, А7), `final-pass.md` (А5), `language.md`, `calques.md`, `orthography.md`, `sentence.md`, `dialogue.md`, `scene-chapter.md`, `character-card.md` (Ч1–Ч8), `book-setup.md` (М1–М4), `templates/book-profile.md`, `templates/character-card.md`, `templates/replica-prompt.md` | `shared/` |
| `audit.md` (А1–А2) | `skills/audit/references/` |
| `reader-test.md` (А6) | `skills/reader/references/` |
| агент читацького тесту | `agents/fiction-reader.md` |
Від теки будь-якого скіла `shared/` — це `../../shared/`. Посилання виду
«`write/SKILL.md`, розд. 3» ведуть у `skills/write/SKILL.md`. Нумерація
пунктів (Л, К, О, Р, Д, С, А, Ч, М) стабільна й наскрізна для всього пакета.
## 5. Чого пакет не робить
- Не тримає даних книги: імен, словника, лору, тону, меж голосу.
- Не ставить квот на сторінку: жодне число в пакеті не є нормою, під яку
підганяють текст. Числа з досліджень — діагностика, а не план.
- Не вирішує за автора будову, повороти й поведінку персонажів. Виняток —
режим «повністю на ШІ» скіла `ideas`, який вмикає сам автор явним запитом
і підтвердженням, на одну сцену.
- Не застосовується до технічних документів: для них є окремий пакет.
## 6. Склад пакета
```
skills/
ukrainian-fiction/ SKILL.md — цей диспетчер
write/ SKILL.md — межа, вхід, письмо, самоперевірка
scene/ SKILL.md — будова сцени, епізоду й глави
ideas/ SKILL.md — ідеї сцен і поворотів, три режими
audit/ SKILL.md · references/audit.md — аудит А1–А2: режим,
порядок рівнів
reader/ SKILL.md · references/reader-test.md — читацький тест А6
setup/ SKILL.md — майстер налаштування книги, картки героїв
shared/
profile.md профіль книги: слоти, порядок входу, еталонні уривки,
робота без профілю, старшинство правил
findings.md таблиця знахідок А3, тести правки А4, самостійність
правки А7
final-pass.md фінальний прохід А5 і чек-лист
language.md мова: Л1–Л13 — віддієслівні іменники, пасив, порожні
звороти, «слугує» замість «є», трійки, родові ланцюги,
обгортки-абстракції, слова-фільтри, пишномовність,
живий розмовний регістр, залишки чату, дієприслівник
і підмет, канцелярит в оповіді
calques.md кальки з російської й англійської, діагностика К1–К4
orthography.md правопис, милозвучність і пунктуація діалогу О1–О8
за Правописом 2019, з параграфами й сторінками
sentence.md речення й абзац Р1–Р9: ритм, ШІ-шаблони, конкретика,
почуття, дистанція оповідача, що не чіпати
dialogue.md діалог Д1–Д6: справи репліки й обміну, підтекст, голоси,
ремарки й реакції
scene-chapter.md будова сцени, епізоду й глави С1–С17 за StoryScope
і суміжними дослідженнями; факти всередині глави
character-card.md картка персонажа Ч1–Ч8: поля, розділи й синоніми, що
бере write, перевірка картки, зразки реплік, промпт
для реплік
book-setup.md майстер налаштування книги М1–М4
templates/
book-profile.md шаблон профілю книги
character-card.md шаблон картки персонажа
replica-prompt.md шаблон промпту для реплік
agents/
fiction-reader.md свіжий читач для читацького тесту
SOURCES.md джерела пакета
```
Джерела ідей пакета — `SOURCES.md` у корені плагіна.