infostyle

Files (5)

• SKILL.md
• genres.md · references/
• stop-words.md · references/
• structure.md · references/
• syntax.md · references/

SKILL.md (first lines)

# Infostyle: редактура русского текста

Source material: «Пиши, сокращай 2025» (Ильяхов, Сарычева) — уровни слова, предложения, абзаца и текста; «Ясно, понятно» (Ильяхов) — абстракции, примеры, антипримеры, подача.

## Три режима

**Правка (по умолчанию).** Выдать отредактированный текст целиком, затем короткий отчёт: что изменено на каждом уровне и какие места требуют фактов от автора. Если работаем с файлом — править файл через Edit, а в ответ вынести только отчёт и спорные места.

**Разбор (`--разбор`, или когда пользователь просит «не правь, объясни»).** Не переписывать. Выдать находки по уровням с цитатой, диагнозом и предложенной заменой. Заканчивать вопросом, что из этого применять.

**Раскладка (`--раскладка`, или когда формулировки менять нельзя: юристы согласовали, регламент, чужой утверждённый документ).** Не трогать ни одного слова. Нарезать абзацы по 5–7 строк, выписать, о чём каждый абзац, вынести это подзаголовками, переставить блоки от сути к предыстории, продублировать ключевое перечнем в начале, добавить заголовок, к каждому графику — хотя бы одну выноску. Этого одного хватает, чтобы нечитаемый документ стал рабочим.

## Жёсткие правила

Нарушение любого из них проваливает задачу.

1. **Не выдумывать факты.** Замена оценки на факт («качественный сервис» → «отвечаем за 15 минут») требует факта, которого у вас нет. Если факта нет — спросить автора или оставить в тексте явную метку `[нужен факт: скорость ответа]`. Выдуманная цифра хуже оценки: оценку читатель отфильтрует, а цифре поверит.
2. **Коротко ≠ ясно.** Удаляем мусор, оценки без опоры, графоманию, канцелярит. НЕ удаляем: опорные тезисы, примеры, антипримеры, объяснения по цепочке, элементы управления вниманием. Текст после правки может стать длиннее — это нормально.
3. **Стоп-слово — сигнал, а не запрет.** Каждое слово из списков проверяется на информативность именно в этом тексте. Вводное слово, которое несёт смысл, остаётся. Механическая вычистка по списку — не редактура.
4. **Термины и юридически значимые формулировки не трогаем.** «Иррациональное число», «акцепт оферты», номер закона, название документа — это точность, а не заумь. Меняем форму изложения, не смысл и не правовую силу.
5. **Синтаксические приёмы — инструменты, не закон.** Подлежащее-субъект и глагол действия включают воображение читателя и смещают фокус на того, кто действует. Если герой не важен («Дома построены по стандарту» → «Дома соответствуют стандарту», а не «Строители построили дома»), фокус выбираем сознательно.
6. **Тональность и голос автора сохраняем.** Чистим текст, а не переписываем человека. Шутка, которая работает, остаётся.

## Ход работы

### Проход 0. Задача и контекст

Прежде чем править, ответить (и записать в отчёт):

- Для кого это? «Для всех» не принимается — нужна конкретная группа с понятными проблемами. Общечеловеческие темы конкурируют со всем интернетом сразу; специализация («как оставаться здоровым мужчине за 35») выигрывает у общей темы.
- Полезное действие: почему читатель САМ захочет это читать? Решить проблему, стать значимее в своей группе или что-то почувствовать. «Проинформировать» — не полезное действие.
- Контекст: где публикуется, кто автор и как к нему относятся, что происходит вокруг, чего читатель ждёт от этой площадки. Если контекст испорчен (предубеждение, неуместное время, чужая повестка), правкой слов это не лечится — лечится «выкладыванием багажа», сменой канала или молчанием.
- Читают это подряд или сканируют глазами; какой жанр (для жанровых чек-листов — `references/genres.md`).

Если из текста и разговора это не выводится — задать один вопрос пользователю. Если он отвечает «не знаю» — зафиксировать предположение в отчёте и править исходя из него. Всё, что не соответствует полезному действию, — кандидат на вылет, даже если написано хорошо.

### Проход 1. Структура

- Суть — вперёд. Обоснования, предыстория, ссылки на регламенты — в конец предложения, абзаца, документа.
- Одна структура на текст и она следует из содержания: новость (пирамида), история (хронология), инструкция (порядок исполнения), подборка (одинаковые модули), обзор (разные модули), рассуждение (тезис → аргументы → вывод).
- Длинному тексту — договор с читателем в начале: о чём, как устроен, для кого, сколько займёт.
- Не больше одного уровня вложенности заголовков.
- Введение: факт, которого читатель не знает, личный опыт или сразу решение. Вырезать заходы «в наши дни», «каждый знает», «отличная новость», метафору не по теме, описание времени года.
- Заключение: приём «сделай наоборот» (после объективного обзора — личное мнение, после мнения — статистика, после тезиса — взгляд с обратной стороны), что делать дальше, куда идти за подробностями.

### Проход 2. Абзац

- Один абзац — одна тема. Отступление либо становится отдельным абзацем, либо удаляется (тест: тянет на абзац?).
- Первое предложение заявочное, ключевые слова в начале, абзац читается в отрыве от предыдущего. Начало с «например», «хотя», «в этой ситуации», «и наоборот» — признак сломанной автономности.
- Проверка целого: прочитать подряд только первые предложения абзацев. Складывается картина текста — структура в порядке.
- Длина 3–9 строк. Абзацы в одну строку подряд рвут текст; абзац длиннее 8–12 строк читается как полотно.

### Проход 3. Предложение

- Одна мысль — одно предложение. Много запятых — сигнал.
- Главное рядом: подлежащее и сказуемое рядом друг с другом и ближе к началу. Уточнения — в отдельные предложения.
- Люди и действия вместо явлений и процессов: отглагольные существительные → глаголы, страдательный залог → действительный, безличное → с исполнителем, если исполнитель важен.
- Глаголы состояния (быть, являться, находиться, располагать, предполагать, указывать) часто прячут действие.
- Однородные члены: близкие по смыслу — оставить одно; три и больше — обобщить или вынести в перечень.
- Хронология внутри абзаца не ломается.
- Абстракция остаётся, но обрастает картинкой: термин + что конкретно делают люди.
- Обратный ход: после чистки перечитать вслух. Если текст зазвучал рублено — предложения одной длины и схемы, связи достраивает читатель, — объединить те, что раскрывают одну мысль, разнообразить начала, чередовать длину. Здесь связки вроде «это связано с тем, что» ставятся намеренно.

Подробности и таблицы замен: `references/syntax.md`.

### Проход 4. Слово

Пять групп стоп-слов: вводные, неопределённое, заумь, навязанные оценки, штампы. Каталог с примерами замен: `references/stop-words.md`.

После удаления мусора на освободившееся место добавляем полезное — факт, сценарий, пример. Если добавить нечего, см. правило 1.

### Проход 5. Подача

- Заголовок отражает суть, а не привлекает внимание: «Отключение горячей воды 1–2 октября», не «Уважаемые жильцы». Игровые заголовки в информационном тексте мешают.
- Подзаголовки информативные, согласованные по форме, каждые 5–10 абзацев; при отрицательной модальности («чего не делать») отрицание повторяется в каждом подзаголовке.
- Однородная информация — в перечень с обобщающей фразой; элементы одинаковой структуры; повторяющееся во всех пунктах выносится за перечень; пункты строятся под сценарий поиска читателя («Детям до 12 лет — детский тариф»).
- Длинному документу — плашка-шпаргалка: «если мало времени, прочитай только это».
- Жирным — только подзаголовки. Выделенные слова в середине абзаца не складываются в связную историю, а диагональное чтение всё равно не работает. Захотелось выделить — вынести в начало абзаца или в подзаголовок.
- Порядок приоритетов: сначала заголовки, подзаголовки, начала абзацев, примеры и акценты — и только потом полировка формулировок. Нюанс, спрятанный в середине абзаца, для читателя не существует.

## Финальная проверка

- Закрыть название компании — текст всё ещё о чём-то конкретном? Если подходит любой компании, это пустой текст.
- Каждая мысль, которую читатель должен запомнить, обвязана примером; там, где есть «делай так», есть и антипример «а вот так не надо, и вот почему люди так делают».
- Есть ли место, где читатель почувствует себя дураком? Оценки направлены на работу, а не на человека; плохое — не во втором лице.
- Числа: округлены до читаемой точности, у больших чисел есть с чем сравнить, у фактов есть сценарий («что я смогу с этим сделать»).
- Примеры правдивы: ни одна деталь не выдумана в области, которой вы не знаете. Выдуманный пример ломается о знание читателя и обнуляет доверие ко всему тексту.
- Эмоции не написаны словами: то, что читатель должен почувствовать, показывается, а не утверждается («вы будете блистать» включает у него проверку логикой и сопротивление).
- Не пересушили: текст не превратился ни в плотный ком подробностей, ни в рубленую цепочку одинаковых фраз.

## Отчёт

После правки — не пересказ текста, а список изменений, сгруппированный по уровням, и отдельно:

- **Нужны факты:** места, где оценка снята, а факта нет.
- **Спорное:** что вы изменили, но решение зависит от задачи, которую знает только автор.

Держать отчёт коротким: длинный разбор своей работы читают реже, чем сам текст.

From lexfrei/ccc, BSD-3-Clause.

More from lexfrei/ccc