fix(skills): ai-text-lint, калибровка типографики и границы правки

- Зачем:
  - калибровка была неверной в обе стороны: скилл снимал находку в
    статье, считая, что текст прошел через редактор с автозаменой, и
    одновременно ловил букву «ё», которая маркером не является вовсе.
  - в режиме правки не было запрета доводить текст до идеала, поэтому
    вычитка делала его ровнее и машиннее исходника.
- Что:
  - линза Клавиатура переписана вокруг простой причины: этих знаков нет
    на клавиатуре. Главным тестом стало не наличие тире, а равномерность:
    умный редактор подставляет неровно, модель безупречно везде.
  - markdown отделен от статьи в Word: подставлять знаки там нечему,
    поэтому тире и елочки в .md машинные сразу.
  - «ё» выведена из маркеров как личная стилистика; вместо нее записано
    предпочтение владельца скилла ее не писать, с исключениями на
    смыслоразличение и имена.
  - эмодзи вне переписки подняты до безусловного маркера и вместе с
    тире в markdown вынесены в блок «везде, среда роли не играет».
  - в Решетку добавлен третий слой, ровность правильности; в границы
    правки добавлены «не вычищать до блеска» и запрет добавлять ошибки.
- Проверка:
  - прогон скилла на секции «Дизайн-решения» из README.md, который и
    вскрыл обе ошибки калибровки.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Dmitriy DementievandClaude committed 2026-08-21 11:15:38 +03:00
1 parent 12a8d419ec
commit 31f7fddcde
1 file changed
+32 -10
+32 -10
View File
@@ -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, а не доводить текст до идеала: мелкие огрехи автора оставлять на месте.
**Ошибки не добавлять никогда.** Из того, что шероховатость есть признак руки, не следует, что её надо производить. Подделанная опечатка — такая же имитация, как безупречная типографика, просто с другой стороны. Человеческий след даёт Голос: мнение автора, его случай, его цифра. Мусор в тексте его не заменяет.
### Режим отчёта (когда просят диагностику)
«Проверь», «что тут не так», «прогони и покажи находки» — значит не трогать текст.