diff --git a/agents/.agents/skills/ai-text-lint/SKILL.md b/agents/.agents/skills/ai-text-lint/SKILL.md index 9159075..3221f14 100644 --- a/agents/.agents/skills/ai-text-lint/SKILL.md +++ b/agents/.agents/skills/ai-text-lint/SKILL.md @@ -19,11 +19,24 @@ description: "Оптика для вычитки текста на slop — пр ### Клавиатура — набрал ли это человек руками? -Стоимость набора. Символ, который требует лишнего движения и ничего не даёт взамен, человек не ставит: em dash (Alt+0151), «ё» в дальнем углу, ёлочки, неразрывный пробел, троеточие одним символом, безупречно расставленные запятые в чате. Модель ставит всё это по умолчанию, потому что училась на отредактированных текстах. +**Половины типографики нет на клавиатуре.** Тире, длинное тире, ёлочки, неразрывный пробел, троеточие одним знаком набираются только Alt-кодом, которого никто не помнит. Человек ставит дефис, лапки и три точки. -Линза генеративна: она порождает не список символов, а вопрос «сколько усилий стоило это набрать». Новый типографский изыск попадёт под неё без обновления скилла. +Взяться в тексте они могут из двух источников, и различаются те по **равномерности**: -Среда решает всё. В Telegram и Slack автозамены нет, поэтому em dash там — чужой след. В статье текст прошёл через редактор с автозаменой, поэтому **в article клавиатура не находка вообще**, кроме случая, когда точно известно, что текст набирался в plain-text. +- **Умный редактор.** Word, Google Docs и часть CMS подставляют знаки сами, но неровно: где-то подстановка сработала, где-то нет, в одном абзаце ёлочки, в соседнем лапки. Эта неаккуратность и есть человеческий след. +- **Модель.** Ставит правильный знак везде и без пропусков. Безупречная типографика по всему тексту, без единой осечки, машинная. + +В markdown, README и редакторе кода умного редактора нет, подставлять знаки нечему. Там любое тире или ёлочка машинные сразу, равномерность разбирать не нужно. + +Второй слой слабее: знаки, которые на клавиатуре есть, но требуют лишнего движения. Все запятые на местах в чате. + +**Буква «ё» не маркер.** Это личное предпочтение: либо стоит по всему тексту, потому что автор её любит, либо не стоит нигде, потому что автор её пропускает. Оба варианта допустимы по правилам языка, и ни один ничего не говорит про происхождение текста. + +**Владелец скилла ё не пишет** и делает это не задумываясь, поэтому правка молчаливая: убрать и не выносить в отчёт. + +Два исключения, где ё остаётся. Первое: слова, в которых она различает смысл (всё/все, узнаём/узнаем, нёбо/небо, передохнём/передохнем). Второе: имена и фамилии (Фёдор, Артём, Королёв). В именах пропуск ё аукается в документах и при транслитерации, и это единственное место, где привычка её опускать реально вредит. + +Линза генеративна: она порождает не список символов, а вопрос «есть ли это на клавиатуре, и если есть, то ровно ли расставлено». Новый типографский изыск попадёт под неё без обновления скилла. ### Голос — этот ли человек говорит? @@ -39,6 +52,8 @@ description: "Оптика для вычитки текста на slop — пр Второй слой — синтаксическая решётка: подряд идущие предложения по одной схеме, одинаковые зачины, буллеты «**жирный заголовок** — расшифровка» без единого исключения, форсированные триады («быстро, надёжно, удобно») там, где естественная группа — две вещи или четыре. +Третий слой — **ровность правильности**. Живой текст содержит опечатку, пропущенную запятую, слово, повторённое дважды подряд, термин, названный в двух местах по-разному, мысль, которая начата и брошена. Текст на две страницы без единой шероховатости ровен так же неестественно, как абзацы одинаковой длины. Немного ошибок — признак руки. + ### Вода — прибавилось ли информации? Тест: убрать фразу и посмотреть, изменилось ли что-нибудь. Не изменилось — вода. Ловит канцелярит («является», «данный», «в рамках», «осуществлять»), раздувание важности, impact-фразы без цифр, стопки баззвордов, связки-пустышки («кроме того», «вместе с тем», «стоит отметить»), ложные диапазоны («от стартапов до корпораций»), хеджирование в три слоя. @@ -47,24 +62,27 @@ description: "Оптика для вычитки текста на slop — пр ### Ассистент — не чат-бот ли это отвечает? -Артефакты интерфейса помощника, протёкшие в авторский текст: церемония на входе («В современном мире...», «Давайте разберёмся»), церемония на выходе («Надеюсь, это поможет», «Буду рад помочь»), подведение итогов там, где никто не просил, декоративные эмодзи в заголовках и буллетах, вступительное двоеточие перед каждым списком. +Артефакты интерфейса помощника, протёкшие в авторский текст: церемония на входе («В современном мире...», «Давайте разберёмся»), церемония на выходе («Надеюсь, это поможет», «Буду рад помочь»), подведение итогов там, где никто не просил, вступительное двоеточие перед каждым списком. + +**Декоративные эмодзи — самый однозначный маркер из всех.** В русском тексте вне переписки их не ставят: ни в заголовках, ни в буллетах, ни в README, ни в документации. Конвенции «так принято на GitHub» не существует, есть привычка моделей украшать структуру. Одна 🚀 в заголовке весит больше десятка стилистических подозрений. Самая механическая из пяти, ловится почти поиском по подстроке. ## Калибровка по средам -Severity — свойство среды, а не находки. Одна и та же клавиатура: в статье не считается, в чате красный флаг. +Severity в основном свойство среды. Но три маркера не зависят от неё вообще, и они же самые надёжные. + +**Везде 🔴, среда роли не играет:** +декоративные эмодзи вне переписки · тире и ёлочки в markdown · безупречно ровная типографика по всему тексту · «не X, а Y» / «не просто X, но и Y» **article** (статья, блог-пост, README) — вес на **Голосе** и **Воде**. -🔴 нет позиции автора · размытая ссылка на авторитет · раздувание важности · «В современном мире» · эмодзи в заголовках · буллеты «жирный заголовок + расшифровка» +🔴 нет позиции автора · размытая ссылка на авторитет · раздувание важности · «В современном мире» · буллеты «жирный заголовок + расшифровка» **message** (Slack, Telegram, email коллеге) — вес на **Клавиатуре** и **Ассистенте**. Голос почти не считается: в чате нужна краткость, а не позиция. -🔴 em dash · сплошная «ё» · плотный канцелярит · «давайте разберёмся» · «буду рад помочь» · итоги в конце сообщения · связки «кроме того / вместе с тем» · безличное «рекомендуется» +🔴 плотный канцелярит · «давайте разберёмся» · «буду рад помочь» · итоги в конце сообщения · связки «кроме того / вместе с тем» · безличное «рекомендуется» · безупречная пунктуация в чате **resume** (резюме, сопроводительное) — вес на **Воде** и **Решётке**. -🔴 impact-фраза без цифр · стопка баззвордов · однородные буллеты в опыте · причастные хвосты («...значительно упростив») · хеджирование · em dash · «ё» - -**Везде 🔴:** «не X, а Y» / «не просто X, но и Y». +🔴 impact-фраза без цифр · стопка баззвордов · однородные буллеты в опыте · причастные хвосты («...значительно упростив») · хеджирование Красные списки — это калибровка, которую из общих соображений не вывести. Остальное взвешивать самому: насколько уверенное срабатывание и насколько мешает в этой среде. Механического правила понижения нет — уверенная находка по неглавной линзе спокойно бывает важнее вялой по главной. @@ -108,6 +126,10 @@ Severity — свойство среды, а не находки. Одна и т Границы правки: меняется форма, не смысл. Термины, числа, факты, ссылки — неприкосновенны. Авторские особенности (короткие рубленые фразы, мат, необычная пунктуация как приём) — это голос, а не slop, их не выравнивать. +**Не вычищать до блеска.** Опечатка, пропущенная запятая, дважды повторённое слово, термин, названный в двух местах по-разному — следы руки. Убирать slop, а не доводить текст до идеала: мелкие огрехи автора оставлять на месте. + +**Ошибки не добавлять никогда.** Из того, что шероховатость есть признак руки, не следует, что её надо производить. Подделанная опечатка — такая же имитация, как безупречная типографика, просто с другой стороны. Человеческий след даёт Голос: мнение автора, его случай, его цифра. Мусор в тексте его не заменяет. + ### Режим отчёта (когда просят диагностику) «Проверь», «что тут не так», «прогони и покажи находки» — значит не трогать текст.