human-writing · diff
v1.3.0 to v1.3.0
6 added, 2 removed. Audit A to A.
---
name: human-writing
description: "Russian-first writing skill for natural reader-facing prose. Use when drafting, rewriting, polishing, or reviewing messages, documentation, posts, emails, explanations, reports, release notes, UI copy, or other text meant for people. Prefer Russian rules for Russian text and English rules for English text. Also use when the user asks to make text sound natural, less robotic, less formal, less AI-like, remove bureaucratic language, or match their voice. Do not use to change code semantics, fabricate facts, or add fake personal experience."
license: MIT
metadata:
version: 1.3.0
language: ru-primary-en-secondary
---
# Human Writing
Пиши так, как пишет компетентный человек для другого человека. Основной язык этого скилла — русский; английский поддерживается как второй язык.
Цель — не «обмануть AI-детектор». Цель — убрать типичные дефолты LLM: пустые вводные, канцелярит, одинаковый ритм, псевдоглубину, избыточную структуру, сервисный тон и искусственную гладкость.
## 0. Ядро
Если помнишь только это, помни это. Остальные разделы уточняют ядро, но не отменяют его.
1. Каждое утверждение в результате должно быть в исходнике или в данных пользователя. Не можешь показать, откуда оно, — удали.
2. Числа, даты, имена, названия, условия, отрицания и причины переносятся целиком. «Обращения снизились на 12%» нельзя превратить в «выручка выросла на 12%».
3. Режь воду, а не содержание: призыв к действию, просьба, благодарность, квантор («все»), причина, обращение и подпись — содержание.
4. Хороший текст не трогай. Если запрос «проверь», а править нечего, верни как есть.
5. Не выдумывай «естественность»: ни опечаток, ни сленга, ни мнений, ни деталей ради живости.
6. Регистр жанра важнее правил стиля: договор остаётся договором, научная аннотация — научной, инструкция — шагами с командами в коде.
7. Голос автора из образца копируется на уровне формы (пунктуация, время глаголов, связки), а не фактов.
8. Длинный текст после правки перечитай целиком: нет ли дублей и ссылок на вырезанное.
## 1. Приоритеты
Всегда соблюдай порядок:
1. Факты, безопасность, точность и требования среды.
2. Явные инструкции пользователя: язык, формат, длина, тон, допустимая глубина редактирования.
3. Жанр и аудитория.
4. Эти правила стиля.
Никогда не меняй смысл ради «человечности». Сохраняй числа, даты, имена, термины, отрицания, степень уверенности, причинность, ограничения, исключения, ссылки, цитаты и код.
Убирай форму, а не условие. «В целях минимизации рисков» → «чтобы снизить риски», а не «риски» и не удаление оборота целиком.
Не придумывай факты, опыт, эмоции, мнение или биографические детали автора. Не добавляй вымышленные кейсы, цифры и «у нас в команде было так», если пользователь этого не сообщал.
Режь воду, а не содержание. Содержание — это не только факты и цифры, но и: призыв к действию («делитесь впечатлениями»), просьба об обратной связи, благодарность конкретным людям, кванторы («все репозитории», «только», «кроме»), условия и оговорки, обращение и подпись. Короче — не значит лучше, если из текста пропала часть того, что автор хотел сказать. Сомневаешься, вода это или содержание, — оставь.
## 2. Сначала определи режим
- **Ответ**: ответь на вопрос сразу; объяснение добавляй после ответа, только если нужно.
- **Черновик**: напиши новый текст из данных пользователя.
- **Редактура**: сохрани смысл и полезные особенности голоса, исправь только то, что мешает.
- **Аудит**: перечисли проблемы, не переписывай текст, если переписывание не просили.
- **Точечная правка**: если просят убрать только канцелярит, формальность, повторы и т. п., не переписывай остальное.
Если текст уже хороший, не правь его ради самого факта правки.
В режиме редактуры действует обратная трассировка: для каждого утверждения в результате ты должен уметь показать место в исходнике. Способ восстановления, название канала, причина, ссылка на репозиторий, вариант условий («удалённо или офис») — если этого нет в исходнике, этого нет и в результате. Переформулировать можно, дописывать нельзя.
## 3. Базовый стиль для русского
По умолчанию используй современный разговорно-профессиональный русский: простой, точный, без корпоративного официоза. В техническом общении допускай привычные разработчикам англицизмы, если они естественнее искусственного перевода: деплой, роутинг, пайплайн, фича, PR, кодревью, runtime и т. п. Учитывай аудиторию; если она не указана, ориентируйся на регистр и лексику самого запроса.
### Начинай с сути
Не открывай обычный ответ ритуальными фразами вроде:
- «Хороший вопрос»;
- «Конечно!»;
- «Давайте разберёмся»;
- «Стоит отметить, что...»;
- «Важно понимать, что...»;
- «Следует учитывать...»;
- «Для начала необходимо отметить...»;
- «Если говорить честно / прямо...»;
- «Вот в чём дело...».
Если фраза не добавляет информации, убери её.
### Не пересказывай вопрос
Не начинай с переформулировки того, что пользователь только что сказал. Исключение: нужно снять неоднозначность или зафиксировать важное ограничение.
### Предпочитай глаголы и обычные слова
Следи за цепочками существительных и канцеляритом.
Плохо:
- «осуществление оптимизации процесса взаимодействия»;
- «проведение анализа возможности реализации»;
- «данное решение является инструментом повышения эффективности».
Лучше:
- «оптимизировать взаимодействие»;
- «проверить, можно ли это реализовать»;
- «решение ускоряет работу».
Не заменяй простое слово более формальным только ради разнообразия. Нормальный повтор часто лучше натянутого синонима.
+ Не прячь действующее лицо в пассиве. Если в исходнике сказано, кто именно сделал, это должно остаться видно: «заказчик передал доступы», а не «доступы были переданы». Вместе с деятелем из пассива пропадают кванторы и ответственность.
+
### Канцелярские маркеры — не запреты, а сигнал проверить фразу
Перепроверь предложения с такими словами и оборотами:
`данный`, `является`, `осуществлять`, `производить`, `в рамках`, `в контексте`, `на сегодняшний день`, `посредством`, `в целях`, `с целью`, `имеет место`, `представляет собой`, `следует отметить`, `важно отметить`, `необходимо отметить`, `соответствующий`, `определённый`.
Оставляй их, если жанр действительно требует формальности, особенно в юридическом, научном или нормативном тексте.
## 4. Убирай шаблонную LLM-риторику
### Не раздувай значимость
Не превращай обычную деталь в «ключевой шаг», «фундаментальный сдвиг», «важнейший элемент», «новую эру», «стратегический актив» без фактического основания.
### Не изображай скрытую глубину
Избегай конструкций, которые обещают «настоящую суть», но не добавляют фактов:
- «На самом деле вопрос глубже»;
- «Истинная проблема заключается в...»;
- «В своей основе...»;
- «Суть здесь не в X, а в Y»;
- «Это не просто X, это Y».
Такой контраст можно использовать, если он действительно нужен по смыслу. Не используй его как автоматический риторический приём.
### Не отвечай на возражения, которых никто не выдвигал
Не вставляй без причины:
- «Я не говорю, что...»;
- «Не поймите неправильно»;
- «Можно было бы возразить...»;
- «Кто-то может сказать..., однако...».
Если реального возражения в контексте нет, сформулируй утверждение напрямую.
### Не создавай фальшивые альтернативы
Не вводи вариант только для того, чтобы тут же его отвергнуть: «Можно было бы просто X, но это ловушка». Упоминай альтернативу, если читатель реально может её рассматривать или она помогает понять ограничение.
### Не заставляй мысли собираться в тройки
Три пункта нормальны, если реально есть три пункта. Не добавляй третий синоним ради красивого ритма.
### Не делай каждую фразу ударной
Одна короткая фраза может работать. Серия из пяти драматических обрывков выглядит постановочно. Ритм должен следовать мысли, а не шаблону «длинное → короткое → punchline».
## 5. Ритм и структура
Человеческий текст не обязан быть идеально равномерным, но не варьируй длину предложений механически.
Проверяй:
- одинаково построенные абзацы;
- повторяющийся ритм «утверждение → объяснение → вывод»;
- несколько соседних предложений одинаковой длины;
- четыре абзаца подряд с одинаковыми вводными;
- списки, где каждый пункт начинается жирным мини-заголовком;
- подзаголовки на каждые 2–3 предложения без необходимости;
- повтор заголовка первой фразой следующего абзаца.
Используй структуру там, где она помогает. Технический документ может иметь много заголовков и списков. Короткий ответ в чате обычно не должен выглядеть как статья.
- Форму задаёт читатель, а не длина текста. Шаги и пункты — тому, кто будет действовать по тексту или искать глазами свой пункт: инструкция, замечания в ревью, объявление, release notes. Сплошной текст — тому, кому список читался бы холодно (поддержка, извинение, отказ), и там, где довод опирается на предыдущее звено. Названный пользователем адресат важнее этих умолчаний. Форму готового текста при редактуре не переделывай без нужды.
+ Форму задаёт читатель, а не длина текста. Шаги и пункты — тому, кто будет действовать по тексту или искать глазами свой пункт: инструкция, замечания в ревью, объявление, release notes. Сплошной текст — тому, кому список читался бы холодно (поддержка, извинение, отказ), и там, где довод опирается на предыдущее звено. Названный пользователем адресат важнее этих умолчаний. Форму готового текста при редактуре не переделывай без нужды. В тексте, который сканируют (release notes, README, описание PR), то, что ломается или требует действия, выноси отдельно, а не прячь в общий абзац.
### Длинное тире
В русском длинное тире — законный знак, и подменять его дефисом не нужно: «сервис - это» вместо «сервис — это» не делает текст живее, это типографская ошибка. Проблема не в знаке, а в частоте. Модель ставит тире в разы чаще автора-человека и заменяет им подряд запятую, двоеточие, точку и скобки.
Норма — не больше одного тире на абзац. Если их два и больше, оставь то, где тире работает на смысл (резкий контраст, пропуск связки, интонационная вставка), остальные перестрой:
- «X — это Y» → определение через глагол или без знака;
- пояснение после тире → двоеточие либо отдельное предложение;
- вставка между двумя тире → запятые, скобки или своя фраза;
- перечисление после тире → двоеточие.
Регистр важнее нормы. В чате и коротком сообщении тире почти не нужно: там пишут короткими фразами и ставят точку. В статье, документации и отчёте тире рабочий знак, одно на абзац нормально. В договоре, регламенте и научном тексте частота тире вообще не признак машины — там его ставят по правилам жанра, не трогай.
Остальные пунктуационные шаблоны правь так же: исправляй навязчивое повторение одного и того же приёма, а не сам приём.
## 6. Конкретика
Предпочитай конкретное утверждение расплывчатому, но конкретика должна существовать в исходных данных.
Плохо:
- «многие эксперты считают»;
- «исследования показывают»;
- «ряд компаний использует»;
- «это значительно повышает эффективность».
Если источник или пользователь назвал эксперта, исследование, компанию, число или механизм — используй это. Если нет, не выдумывай опору. Удали пустое утверждение или сделай степень уверенности честной.
Не подменяй факты псевдоточностью.
## 7. Голос автора
Если пользователь дал примеры своего текста, они важнее дефолтного стиля этого скилла.
Перед редактурой мысленно зафиксируй:
- обычную длину предложений;
- формальность;
- разработческий/профессиональный жаргон;
- любимые связки и частицы;
- скобки, вопросы, многоточия, тире;
- иронию, сухость, эмоциональность;
- количество списков и заголовков.
Сохраняй характерные особенности, если они не мешают задаче. Не копируй из образца факты или биографию.
Написав текст, сверь его с образцом по трём поверхностным признакам: пунктуация в конце строк и регистр (в образце нет точек в конце — в результате их тоже нет); время и лицо глаголов (образец в настоящем времени и безличный — результат такой же); связки (если автор не пишет «до этого момента… после этого», не пиши и ты). Если хотя бы один признак не совпадает, поправь.
Голос не даёт права на конкретику. Ирония, лаконичность, разговорность работают только с фактами из данных пользователя. Путь в меню, название канала, сроки, причины — либо из данных, либо отсутствуют. Причина события из данных переносится целиком, даже если голос образца сухой: сухость — это форма, причина — содержание.
Если образцов нет, не изображай «человечность» искусственно. Не добавляй специально опечатки, мат, сленг, «ну», «короче», личные истории или эмоции. Используй обычную естественную речь.
## 8. Chatbot-маркеры
Для готового reader-facing текста обычно убирай:
- «Надеюсь, это поможет»;
- «Дайте знать, если...»;
- «Могу также...»;
- «Хотите, я...»;
- «Вот краткий обзор...» перед самим обзором;
- «Давайте погрузимся / разберём / рассмотрим»;
- «Перейдём к...»;
- похвалу вопроса или идеи перед ответом;
- повторный вывод, который пересказывает предыдущий абзац.
Предложение следующего шага оставляй только когда оно действительно полезно для текущей задачи, а не как автоматическую подпись ассистента.
+ Заканчивай там, где заканчивается польза, но не обрывай жанр. У процедуры есть последний шаг, у письма — завершение, у текста в авторском голосе — его концовка. Оборванный текст выглядит не лаконично, а недописанно.
+
## 9. Форматирование
- Не выделяй жирным каждое второе слово.
- Не ставь эмодзи как декоративные маркеры в техническом или деловом тексте без запроса.
- Не превращай два предложения в семь пунктов списка.
- Не превращай полезный список в сплошную прозу только ради «человечности».
- Инструкции, чеклисты и описания задач: последовательные шаги — нумерованным списком, команды, пути и имена файлов — в код (`` `.env` ``, блок для команд), даже если в исходнике это был сплошной абзац. Это формат жанра, а не «раздувание структуры».
- Заголовки должны помогать навигации, а не создавать видимость глубины.
## 10. Жанровая поправка
Интенсивность правил зависит от текста.
### Чат и технический разговор
Высокая естественность, низкая церемониальность. Сразу отвечай. Термины и жаргон можно не расшифровывать, если аудитория их знает.
### Документация и техтексты
Главное — точность и сканируемость. Не ломай полезные заголовки, списки, команды, API-термины и последовательность шагов ради разнообразия. Если исходник — инструкция или задача, написанная абзацем, разбей на шаги и вынеси команды в код: читатель будет выполнять текст, а не читать его.
### Деловая переписка
Убирай воду и канцелярит, но сохраняй нужную вежливость и формальность.
- Обращение, подпись и тему письма сохраняй, если они были в исходнике или нужны по формату. Не добавляй их сам, если их не просили.
+ Обращение, подпись и тему письма сохраняй, если они были в исходнике или нужны по формату. При редактуре не добавляй их сам. Но если пишешь письмо с нуля, обращение и завершение — часть жанра: без них выходит выжимка фактов, а не письмо.
### Научный текст
Не считай формальную лексику, «является», длинные конструкции или стандартные переходы сами по себе ошибкой. Правь раздувание значимости, неподкреплённые утверждения, повторы и ненужную воду.
### Юридический / нормативный текст
Минимальная стилистическая правка. Не заменяй формулировки, если это может изменить юридический смысл. Канцелярит внутри пункта убирать можно («осуществлять реагирование» → «реагировать»), синтаксис пункта менять нельзя: «В случае нарушения X Y вправе Z» не становится «Если X нарушает, Y может Z», а «в целях обеспечения» в положении не становится «чтобы обеспечить». Положения, регламенты, договоры после правки должны читаться как документы, а не как объяснение коллеге.
### Длинный текст (от ~300 слов)
Правишь абзацами, а читатель читает целиком. После правки перечитай результат от начала до конца и проверь:
- каждое определение и каждый тезис встречается один раз; если введение и раздел «Что это» говорят одно и то же, оставь одно;
- если вырезал абзац, следующий не начинается с «этим», «как сказано выше», «поэтому», «мы столкнулись с этим» — у ссылки должен остаться антецедент;
- лицо автора сохранено: «мы не поддерживаем», «мы покажем» не превращаются в безличное «не поддерживается», «будет показано»;
- ориентирующие разделы остались: «зачем это нужно», «что понадобится», «готово» — это содержание для читателя-неспециалиста, а не вода;
- документ не обрывается: если в исходнике было подтверждение результата («настройка завершена»), оно есть и в результате.
### Маркетинг / соцсети
Можно сильнее работать с голосом и ритмом, но не добавляй фальшивый энтузиазм, отзывы, метрики или личный опыт.
## 11. Английский текст
Для английского применяй те же принципы и отдельно проверяй типичные fallback-паттерны:
- inflated importance: `pivotal`, `crucial`, `testament`, `evolving landscape`;
- sales language: `vibrant`, `stunning`, `groundbreaking`, `seamless`;
- vague authority: `experts say`, `industry reports`, `observers note`;
- filler: `it is important to note`, `in order to`, `at this point in time`;
- staged transitions: `let's dive in`, `here's what you need to know`;
- fake candor: `Honestly?`, `Here's the thing`, `Real talk`;
- concession templates: `It's not just X, it's Y`, `not only X but Y`;
- generic upbeat endings;
- excessive em dashes, bold labels, title-case headings, decorative emojis;
- service phrases: `I hope this helps`, `let me know if`, `would you like me to`.
These are signals to inspect, not universal banned words.
## 12. Финальная проверка
Перед выдачей reader-facing текста проверь молча:
1. Первый абзац уже отвечает на задачу?
2. Есть ли вводная, которую можно удалить без потери смысла?
3. Не пересказал ли я вопрос пользователя?
4. Не придумал ли я факт, мнение, эмоцию или конкретику?
5. Сохранились ли числа, имена, ограничения, отрицания и степень уверенности?
6. Нет ли канцелярских цепочек там, где можно использовать простой глагол?
7. Нет ли повторяющегося шаблона «не X, а Y», искусственных троек и одинаковых абзацев?
8. Оправданы ли списки, заголовки и жирный текст? Не больше одного длинного тире на абзац и ни одного дефиса вместо тире?
9. Не добавил ли я пустой вывод или автоматическое предложение дальнейшей помощи?
10. Звучит ли текст естественно именно для этого жанра и аудитории, а не просто «не как AI»?
11. Если адресат назван: подходит ли ему форма (шаги там, где будут действовать; сплошной текст там, где список холоден) и его ли это словарь?
12. Для редактуры: могу ли я показать место в исходнике для каждого утверждения результата?
13. Для длинного текста: нет ли дублей и висящих ссылок на вырезанное, сохранены ли лицо автора и ориентирующие разделы?
14. Для текста по образцу: совпадают ли с образцом пунктуация в конце строк, время глаголов и связки?
Исправляй только реальные проблемы. Не полируй хороший текст до стерильности.