ru-text

English · Установка · Что изменилось · Источники

ИИ-агент уже записывает ваши мысли по-русски, и это видно: прямые кавычки вместо ёлочек, дефис вместо тире, «в целях повышения эффективности», «Отличный вопрос!». Мысль ваша, а звучит как машина.

ru-text — навык вычитки русского текста для ИИ-агентов. Он работает внутри агента и чистит это по ходу дела: типографику, канцелярит и семнадцать признаков машинного текста (нейрослоп). На каждую правку даёт цитату и правило, по которому она сделана.

Ваши слова, стиль и тон он не трогает: это не ошибки. И ваш файл он не перепишет, пока вы сами не попросите.

Что нового в 2.1.0

Релиз про то, что инструмент перестал править.

• Капслок в одно-два слова остаётся. СРОЧНО: сервер лежит — намеренная эмоция, а не небрежность. Замечание теперь только на полосе из трёх и более прописных слов подряд.
• Усилители при признании вины, обещании и извинении остаются. «Мы действительно сорвали срок» — не находка: удаляя это слово, правишь не стиль, а социальный жест. «Оборудование у нас действительно современное» находкой осталось.
• Ещё четыре оговорки: пассив о поведении продукта, приблизительные числа словами, англицизмы, даты в таблицах.
• Точнее ловятся объявленная искренность и запятая, сомкнутая с тире.

Эталонный набор вырос с 28 текстов до 31: у каждой оговорки теперь есть текст, где она обязана сработать. Что изменилось · Релиз

Нейрослоп

Ловить модель по словарю бесполезно: словарь у неё наш. Выдаёт её манера. Она хвалит ваш вопрос и спорит с тем, чего никто не говорил.

Вот пять предложений, в которых нет ни одного факта:

Отличный вопрос! Сейчас всё объясню — коротко, без воды и по делу. Скажу честно: тут есть нюанс. Давайте разберёмся, как это работает. Дело не в скорости, а в предсказуемости.

Тот же ответ, когда автору есть что сказать:

Под нагрузкой система замедляется предсказуемо: очередь растёт линейно до 800 запросов в секунду, дальше отказы. Вот замеры.

Приёмы по порядку:

• «Отличный вопрос!» — сервисная реплика ассистента;
• «коротко, без воды и по делу» — похвала себе за краткость;
• «скажу честно» — объявленная искренность;
• «давайте разберёмся» — пустой зачин;
• «дело не в скорости, а в предсказуемости» — ложная антитеза: отрицается то, чего никто не утверждал.

Первый вариант я вижу каждый день — в чужих README и в своих черновиках. Он читается гладко и ничего не сообщает.

Прежде чем сделать замечание, навык смотрит оговорки. В цитате, в разборе чужого текста и в юридической формуле приём законен. А триада — любимый у модели ритм из трёх — законна, когда элементов правда три.

Всего в справочнике семнадцать таких признаков. Два из них предъявляются документу целиком, потому что правкой на месте не лечатся: текст, оставшийся стенограммой диалога с нейросетью, и текст, который писали под поисковый запрос.

Канцелярит навык разбирает так же: «в целях повышения эффективности взаимодействия» становится «чтобы отделы работали быстрее», «осуществляется контроль» — «следит Петрова». Отглагольные существительные снова становятся глаголами, у безличного контроля появляется фамилия, а «в целях» и «осуществлять» уходят: они в каталоге из 92 стоп-слов. Фактов навык не сочиняет: фамилию он спросит у вас.

Установка

Дайте эту фразу своему ИИ-агенту:

Установи навык https://github.com/talkstream/ru-text глобально и вызывай его, когда работа идёт над качеством русского текста: вычитка, типографика, очистка от нейрослопа, редактура, UX-тексты, деловая переписка — или по прямому упоминанию ru-text.

Обычно этого достаточно: где его площадка держит навыки, агент знает лучше, чем инструкция, написанная год назад. Работает в Claude Code, Codex и ChatGPT, Cursor, GitHub Copilot, Gemini CLI, Google Antigravity, Windsurf, Continue.dev, Cline, JetBrains Junie, OpenClaw и Notion.

Навыки подхватываются при старте сессии, поэтому начните новую.

Проверьте на живом тексте: дайте агенту абзац и попросите «вычитай». В ответе придут исправленный вариант и список правок. Списка нет — навык не поднялся, смотрите INSTALL.md.

Ставите руками, агент промахнулся или площадка ставит навык своим установщиком — это в INSTALL.md. Там каталоги площадок с адресами вендорской документации; клик-пути для Claude Desktop и Notion; четыре факта, которые агент перебором не откроет.

Что решаете вы

Правила уступают вашей просьбе. Скажете «пиши разговорно» — будет разговорно. Академический, юридический, SEO, литературный — то же. Это умолчания, ваша прямая просьба их отменяет.

Мандат выдаёте вы. Фраза для установки просит вызывать навык, когда работа идёт над качеством русского текста — и по прямому упоминанию. Нужен мандат поуже: «вызывай ru-text, только когда я прошу вычитку». Нужен пошире: «вызывай ru-text на любом русском тексте». Агент исполняет вашу формулировку.

Ничего не переписывается молча. При проверке навык возвращает исправленный вариант и список изменений; правит файл, только если вы прямо об этом попросили.

Чужой текст остаётся чужим. Цитаты, код, чужие фрагменты внутри вашего документа воспроизводятся как есть: замечание — возможно, правка — никогда.

Выключается одной командой. В Claude Code — /plugin, на остальных площадках — удалить каталог навыка.

Иногда агент прогоняет вычитку сам, не спросив: так настроены его автопроверки. Такой проход начинается с быстрой проверки, и она никогда не выдаёт себя за полную вычитку.

Что он правит ещё

Кнопки, ошибки, пустые состояния: кнопка называет действие — «Отмена» вместо «Нет»; ошибка говорит, что случилось и что делать дальше; плейсхолдер — пример, а не инструкция.

Письма и сообщения: тема письма начинается с дела — «Согласовать бюджет на Q3»; первое предложение несёт просьбу или вывод; «довожу до сведения» разворачивается в «сообщаю». Тон уважительный, без заискивания.

Лендинги и документация: вместо «команды профессионалов» — то, что можно проверить; вывод сверху, по «перевёрнутой пирамиде»; ссылка говорит, куда ведёт.

Оценка текста

В Claude Code есть две команды. /ru-text:ru-score снимает с текста показания: балл от 0 до 10 по пяти шкалам — типографика, чистота языка, грамотность, структура, точность для читателя. К каждому замечанию идёт цитата из вашего текста и правило, по которому оно сделано, так что балл можно проверить построчно и оспорить. /ru-text:ru-check делает разбор без оценки: находки, правило на каждую, предложенная замена. На остальных площадках попросите словами: «оцени этот текст по ru-text», «вычитай» — рубрика подгрузится сама.

Вместе с баллом рубрика печатает, чего она не мерила: фактическую точность, попадание в аудиторию, авторский голос и оригинальность, эффективность, соответствие брифу. Голос в балл не входит: 8,0 у осторожного текста и 8,0 у резкого значат одно и то же.

Два верхних ярлыка — «Эталонный» и «Хороший» — не достаются документу, который остался стенограммой чата или писался для поисковика: такой текст бывает чист в каждой фразе и бесполезен целиком. Рубрика назовёт правило, которое ограничило ярлык. Балл при этом печатается как посчитался.

Корпус

Более 2 000 лингвистических атомов: правил, пар «плохо → хорошо», словарных статей и исключений. Это пол, а не точное число, и он считается командой:

tools/extract-atoms.sh skills/ru-text | wc -l

Раньше это число я вписывал руками. Оно разъехалось по файлам, я правил его сразу в девяти — и в записи об этой правке ошибся даже в числе файлов. Теперь его печатает скрипт.

Корпус разложен по 10 справочникам, и они подгружаются по запросу: при старте сессии контекст свободен. Откройте любой и посчитайте правила сами.

• typography.md — кавычки, тире, неразрывные пробелы, разрядка чисел, сокращения
• info-style.md — каталог из 92 стоп-слов, структура текста, факты вместо оценок
• editorial-punctuation.md — сложные предложения, запятые-ловушки, вводные слова
• editorial-grammar.md — согласование, плеоназмы, управление, деепричастия, омофоны
• ux-writing.md — кнопки, ошибки, пустые состояния, формы, уведомления, диалоги подтверждения
• business-writing.md — письма, мессенджеры, тон, заметки к встречам
• anti-patterns.md — пары «неправильно — правильно» по степени серьёзности
• addenda.md — 17 признаков машинного текста с оговорками
• scoring.md — рубрика оценки: измерения, веса, полы
• sources.md — источники и атрибуция

Сколько это стоит контекста

ru-text не гоняет корпус целиком на каждый абзац: это было бы расточительством за ваш счёт.

Постоянно в контексте висит один файл — всегда включённый навык. Это 4 килобайта: таблица типографики и верхушка стоп-слов. Справочники лежат рядом и подгружаются, когда до них дошло дело.

Скажете «вычитай» или «прогони ru-text» — он читает весь корпус.

Когда агент проверяет себя сам, идёт быстрый проход по индексу признаков и каталогу стоп-слов. Он ловит типографику и стоп-слова — то, что решается по одной строке. Наберётся пять замечаний или мелькнёт след машинного текста — проход сам разворачивается в полную вычитку.

Признаки машинного текста быстрый проход не судит: у каждого есть оговорка, где приём законен, а оговорки живут только в полном справочнике. Увидел след — это повод развернуться.

Обновление

У разовой установки нет механизма обновления: агент поставил навык и забыл о нём. Сигнал один: релизы репозитория, Watch → Custom → Releases. Пришло письмо о релизе — попросите агента повторить установку. Что изменилось, написано в CHANGELOG, команды для каждой площадки — в INSTALL.md.

Закрепление ru-text в community-маркетплейсе Claude Code отстаёт от свежей версии на месяцы. Свою версию покажет claude plugins list; если она старая, поставьте навык копированием: три команды в INSTALL.md.

Источники и благодарности

Эти книги, гайды и инструменты научили меня работать с русским текстом. Если ru-text экономит вам время — купите их книги и пользуйтесь их инструментами.

Типографика и вёрстка. Артём Горбунов, «Типографика и вёрстка» · Советы Бюро Горбунова · А. Э. Мильчин, Л. К. Чельцова, «Справочник издателя и автора» · Типографская раскладка Ильи Бирмана · Журнал Type.today

Информационный стиль. Максим Ильяхов, «Пиши, сокращай» и «Ясно, понятно» · Редполитика Т—Ж · Гайды Контура · Яндекс Gravity UI

Язык и письмо. Артемий Лебедев, «Ководство» · Нора Галь, «Слово живое и мёртвое» · справочники Д. Э. Розенталя · М. Ильяхов, Л. Сарычева, «Новые правила деловой переписки» · UX-практики Ozon · ГОСТ Р 7.0.12-2011 и ГОСТ 7.12-93

Полный список с указанием вклада каждого источника — в sources.md.

Рядом стоят и инструменты: Главред, Типограф Лебедева, Орфограммка.

Правовая справка

ru-text — самостоятельное авторское произведение Арсения Камышева. Правила в нём — личное понимание автором стандартов русской типографики и редактуры, сложившееся за годы практики и чтения перечисленных источников. Формулировки оригинальные, дословных цитат нет. Сами принципы (правила типографики, нормы грамматики, приёмы редактуры) авторским правом не охраняются: ст. 1259(5) ГК РФ, 17 USC §102(b), Бернская конвенция.

Авторы и издатели перечисленных источников этот плагин не одобряли и не рецензировали. Ссылки даны для удобства читателя. Названия продуктов принадлежат их правообладателям.

Дальше

Дальше хочу телеграм-бота и расширение для браузера. Про плагин для WordPress пока только думаю. Идеи и замечания — в issues или обсуждениях.

Автор

Арсений Камышев — nafigator@gmail.com · Telegram · GitHub

Если ru-text сэкономил вам вычитку — GitHub Sponsors. Нашли правило, которое неправо? Напишите в issues. Корпус растёт и от таких находок, и в CHANGELOG они подписаны именами.

MIT · Политика конфиденциальности · плагин не делает сетевых запросов и не собирает данные. Эта страница вычитана текущей версией ru-text.