From ee474c98250fed19de8bea1295201cd9cad1d9b0 Mon Sep 17 00:00:00 2001 From: Dmitriy Dementiev Date: Mon, 15 Jun 2026 15:30:22 +0300 Subject: [PATCH] =?UTF-8?q?refactor(ai-text-lint):=20=D0=BF=D0=B5=D1=80?= =?UTF-8?q?=D0=B5=D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=B0=D0=BD=D0=B0=20=D1=81?= =?UTF-8?q?=D1=82=D1=80=D1=83=D0=BA=D1=82=D1=83=D1=80=D0=B0=20patterns.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - устранена дублирующая сводная матрица severity, которая устаревала при изменении паттернов. - улучшена навигация по документу за счёт группировки паттернов в категории. - Что: - добавлены разделы категорий: Структура и форматирование, Тон и авторская позиция, Резюме-специфичные паттерны. - переупорядочены паттерны S05 и S06 внутри категории Структура. - обновлена ссылка на severity в SKILL.md с указанием inline-таблиц. - Проверка: - git diff agents/.agents/skills/ai-text-lint/ --- agents/.agents/skills/ai-text-lint/SKILL.md | 4 +- .../ai-text-lint/references/patterns.md | 60 +++++++++---------- 2 files changed, 29 insertions(+), 35 deletions(-) diff --git a/agents/.agents/skills/ai-text-lint/SKILL.md b/agents/.agents/skills/ai-text-lint/SKILL.md index d0a26dc..2364f4f 100644 --- a/agents/.agents/skills/ai-text-lint/SKILL.md +++ b/agents/.agents/skills/ai-text-lint/SKILL.md @@ -23,7 +23,7 @@ description: "Проверяет текст на признаки AI-генер - **message** — переписка с коллегами (Slack, Telegram, email) - **resume** — резюме, сопроводительное письмо -Контекст влияет на severity паттернов. Подробности — в `references/patterns.md`, раздел "Матрица severity". +Контекст влияет на severity паттернов. Severity для каждого паттерна указана в таблице внутри его описания в `references/patterns.md` (колонки article / message / resume). ### Шаг 2: Прогнать текст @@ -79,4 +79,4 @@ description: "Проверяет текст на признаки AI-генер - **Не быть AI-детектором.** Скилл не определяет, написан ли текст AI. Он ищет стилистические паттерны, которые _ассоциируются_ с AI-генерацией. Человек тоже может так писать. - **Русский язык — приоритет.** База паттернов заточена под русскоязычный текст. Английские паттерны включены для смешанных текстов (технические статьи с англицизмами). -- **Не трогать содержание.** Скилл проверяет стиль и форму, не фактическую корректность. \ No newline at end of file +- **Не трогать содержание.** Скилл проверяет стиль и форму, не фактическую корректность. diff --git a/agents/.agents/skills/ai-text-lint/references/patterns.md b/agents/.agents/skills/ai-text-lint/references/patterns.md index a0c3253..73cfb68 100644 --- a/agents/.agents/skills/ai-text-lint/references/patterns.md +++ b/agents/.agents/skills/ai-text-lint/references/patterns.md @@ -267,6 +267,10 @@ AI-модели же подставляют типографически кор | message | 🟡 medium | | resume | 🔴 high | +--- + +## Категория: Структура и форматирование + ### S01: Negative parallelism ("не X, а Y") **Что:** Конструкция «Это не просто X — это Y», «It's not about X, it's about Y». @@ -333,21 +337,6 @@ AI-модели же подставляют типографически кор | message | 🟢 low | | resume | 🟡 medium | -### S06: Balanced pros/cons ("Преимущества / Недостатки") - -**Что:** Структура с симметричными секциями плюсов и минусов, часто с одинаковым количеством пунктов в каждой. -**Почему:** AI обожает "сбалансированную" подачу — 4 преимущества, 4 недостатка, аккуратно разложенные по полочкам. Человек обычно пишет асимметрично: «мне понравилось X и Y, но бесит Z» — в потоке текста, а не в табличке. -**Примеры маркеров:** -- Секция "Преимущества" с 4 пунктами, затем секция "Недостатки" с 4 пунктами -- «С одной стороны... С другой стороны...» как организующая структура всего текста -**Рекомендация:** Если сравнение нужно — сделать его асимметричным. Написать в потоке текста, а не раскладывать по секциям. Или честно сказать: «плюсов больше, минус один, но существенный». - -| Контекст | Severity | -|----------|----------| -| article | 🟡 medium | -| message | 🟢 low | -| resume | 🟢 low | - ### S05: Bullet points с жирным заголовком + расшифровка **Что:** Списки, где каждый пункт — **Жирное слово/фраза**: а потом то же самое другими словами. @@ -363,6 +352,21 @@ AI-модели же подставляют типографически кор | message | 🟡 medium | | resume | 🟡 medium | +### S06: Balanced pros/cons ("Преимущества / Недостатки") + +**Что:** Структура с симметричными секциями плюсов и минусов, часто с одинаковым количеством пунктов в каждой. +**Почему:** AI обожает "сбалансированную" подачу — 4 преимущества, 4 недостатка, аккуратно разложенные по полочкам. Человек обычно пишет асимметрично: «мне понравилось X и Y, но бесит Z» — в потоке текста, а не в табличке. +**Примеры маркеров:** +- Секция "Преимущества" с 4 пунктами, затем секция "Недостатки" с 4 пунктами +- «С одной стороны... С другой стороны...» как организующая структура всего текста +**Рекомендация:** Если сравнение нужно — сделать его асимметричным. Написать в потоке текста, а не раскладывать по секциям. Или честно сказать: «плюсов больше, минус один, но существенный». + +| Контекст | Severity | +|----------|----------| +| article | 🟡 medium | +| message | 🟢 low | +| resume | 🟢 low | + ### S07: Двоеточие перед каждым списком **Что:** Вводная фраза с двоеточием перед каждым bullet-списком: «Основные преимущества:», «Ключевые особенности:», «Что мы сделали:». @@ -382,6 +386,10 @@ AI-модели же подставляют типографически кор | message | 🟡 medium | | resume | 🟡 medium | +--- + +## Категория: Тон и авторская позиция + ### T01: Vague attribution (размытые ссылки на авторитет) **Что:** «Эксперты отмечают», «По мнению специалистов», «Согласно исследованиям», «Многие разработчики считают» — без указания, кто именно. @@ -461,6 +469,10 @@ AI-модели же подставляют типографически кор | message | 🟡 medium | | resume | 🟢 low | +--- + +## Категория: Резюме-специфичные паттерны + ### R01: Абстрактные impact-фразы без цифр **Что:** «Значительно повысил эффективность», «Оптимизировал бизнес-процессы», «Внёс существенный вклад в развитие». @@ -541,21 +553,3 @@ AI-модели же подставляют типографически кор | article | 🟡 medium | | message | 🟡 medium | | resume | 🔴 high | - ---- - -## Матрица severity (сводная) - -Ниже — быстрая справка для определения, какие паттерны критичны в каком контексте. - -### article (статьи, Хабр, документация) -🔴 high: P04 (эмодзи в заголовках), L03 (inflated significance), L04 (AI-зачины), S01 (negative parallelism), S05 (bold bullet headers), T01 (vague attribution), T03 (стерильная нейтральность) -🟡 medium: P01, P03, P05, L01, L02, L05, L06, S02, S03, S04, S06, S07, T02, T05, R01, C01, C02 - -### message (переписка) -🔴 high: P01 (длинное тире), P05 (буква ё), L01 (AI vocabulary RU), L04 (AI-зачины), L05 (вводные приглашения), S01, S03 (compulsive summary), T04 (вежливые обрамления), C01 (conjunctive phrases) -🟡 medium: P02, P03, P04, P06 (слеш), L03, L06, S02, S07, T01, T02, T05, C02 - -### resume (резюме) -🔴 high: P01 (длинное тире), P04 (эмодзи), P05 (буква ё), L01, L02, L03, L06, S01, R01 (abstract impact), R02 (buzzword stacking), R03 (однородные bullets), T02 (причастные оценки), C02 (false range) -🟡 medium: P03, P06 (слеш), L04, S02, S03, S04, S07, T04, T05, C01 \ No newline at end of file