refactor(ai-text-lint): переработана структура patterns.md
- Зачем: - устранена дублирующая сводная матрица severity, которая устаревала при изменении паттернов. - улучшена навигация по документу за счёт группировки паттернов в категории. - Что: - добавлены разделы категорий: Структура и форматирование, Тон и авторская позиция, Резюме-специфичные паттерны. - переупорядочены паттерны S05 и S06 внутри категории Структура. - обновлена ссылка на severity в SKILL.md с указанием inline-таблиц. - Проверка: - git diff agents/.agents/skills/ai-text-lint/
This commit is contained in:
1 parent
27370b92ba
commit
ee474c9825
2 files changed
+29
-35
No files matched your search
@@ -23,7 +23,7 @@ description: "Проверяет текст на признаки AI-генер
|
|||||||
- **message** — переписка с коллегами (Slack, Telegram, email)
|
- **message** — переписка с коллегами (Slack, Telegram, email)
|
||||||
- **resume** — резюме, сопроводительное письмо
|
- **resume** — резюме, сопроводительное письмо
|
||||||
|
|
||||||
Контекст влияет на severity паттернов. Подробности — в `references/patterns.md`, раздел "Матрица severity".
|
Контекст влияет на severity паттернов. Severity для каждого паттерна указана в таблице внутри его описания в `references/patterns.md` (колонки article / message / resume).
|
||||||
|
|
||||||
### Шаг 2: Прогнать текст
|
### Шаг 2: Прогнать текст
|
||||||
|
|
||||||
@@ -79,4 +79,4 @@ description: "Проверяет текст на признаки AI-генер
|
|||||||
|
|
||||||
- **Не быть AI-детектором.** Скилл не определяет, написан ли текст AI. Он ищет стилистические паттерны, которые _ассоциируются_ с AI-генерацией. Человек тоже может так писать.
|
- **Не быть AI-детектором.** Скилл не определяет, написан ли текст AI. Он ищет стилистические паттерны, которые _ассоциируются_ с AI-генерацией. Человек тоже может так писать.
|
||||||
- **Русский язык — приоритет.** База паттернов заточена под русскоязычный текст. Английские паттерны включены для смешанных текстов (технические статьи с англицизмами).
|
- **Русский язык — приоритет.** База паттернов заточена под русскоязычный текст. Английские паттерны включены для смешанных текстов (технические статьи с англицизмами).
|
||||||
- **Не трогать содержание.** Скилл проверяет стиль и форму, не фактическую корректность.
|
- **Не трогать содержание.** Скилл проверяет стиль и форму, не фактическую корректность.
|
||||||
@@ -267,6 +267,10 @@ AI-модели же подставляют типографически кор
|
|||||||
| message | 🟡 medium |
|
| message | 🟡 medium |
|
||||||
| resume | 🔴 high |
|
| resume | 🔴 high |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Категория: Структура и форматирование
|
||||||
|
|
||||||
### S01: Negative parallelism ("не X, а Y")
|
### S01: Negative parallelism ("не X, а Y")
|
||||||
|
|
||||||
**Что:** Конструкция «Это не просто X — это Y», «It's not about X, it's about Y».
|
**Что:** Конструкция «Это не просто X — это Y», «It's not about X, it's about Y».
|
||||||
@@ -333,21 +337,6 @@ AI-модели же подставляют типографически кор
|
|||||||
| message | 🟢 low |
|
| message | 🟢 low |
|
||||||
| resume | 🟡 medium |
|
| resume | 🟡 medium |
|
||||||
|
|
||||||
### S06: Balanced pros/cons ("Преимущества / Недостатки")
|
|
||||||
|
|
||||||
**Что:** Структура с симметричными секциями плюсов и минусов, часто с одинаковым количеством пунктов в каждой.
|
|
||||||
**Почему:** AI обожает "сбалансированную" подачу — 4 преимущества, 4 недостатка, аккуратно разложенные по полочкам. Человек обычно пишет асимметрично: «мне понравилось X и Y, но бесит Z» — в потоке текста, а не в табличке.
|
|
||||||
**Примеры маркеров:**
|
|
||||||
- Секция "Преимущества" с 4 пунктами, затем секция "Недостатки" с 4 пунктами
|
|
||||||
- «С одной стороны... С другой стороны...» как организующая структура всего текста
|
|
||||||
**Рекомендация:** Если сравнение нужно — сделать его асимметричным. Написать в потоке текста, а не раскладывать по секциям. Или честно сказать: «плюсов больше, минус один, но существенный».
|
|
||||||
|
|
||||||
| Контекст | Severity |
|
|
||||||
|----------|----------|
|
|
||||||
| article | 🟡 medium |
|
|
||||||
| message | 🟢 low |
|
|
||||||
| resume | 🟢 low |
|
|
||||||
|
|
||||||
### S05: Bullet points с жирным заголовком + расшифровка
|
### S05: Bullet points с жирным заголовком + расшифровка
|
||||||
|
|
||||||
**Что:** Списки, где каждый пункт — **Жирное слово/фраза**: а потом то же самое другими словами.
|
**Что:** Списки, где каждый пункт — **Жирное слово/фраза**: а потом то же самое другими словами.
|
||||||
@@ -363,6 +352,21 @@ AI-модели же подставляют типографически кор
|
|||||||
| message | 🟡 medium |
|
| message | 🟡 medium |
|
||||||
| resume | 🟡 medium |
|
| resume | 🟡 medium |
|
||||||
|
|
||||||
|
### S06: Balanced pros/cons ("Преимущества / Недостатки")
|
||||||
|
|
||||||
|
**Что:** Структура с симметричными секциями плюсов и минусов, часто с одинаковым количеством пунктов в каждой.
|
||||||
|
**Почему:** AI обожает "сбалансированную" подачу — 4 преимущества, 4 недостатка, аккуратно разложенные по полочкам. Человек обычно пишет асимметрично: «мне понравилось X и Y, но бесит Z» — в потоке текста, а не в табличке.
|
||||||
|
**Примеры маркеров:**
|
||||||
|
- Секция "Преимущества" с 4 пунктами, затем секция "Недостатки" с 4 пунктами
|
||||||
|
- «С одной стороны... С другой стороны...» как организующая структура всего текста
|
||||||
|
**Рекомендация:** Если сравнение нужно — сделать его асимметричным. Написать в потоке текста, а не раскладывать по секциям. Или честно сказать: «плюсов больше, минус один, но существенный».
|
||||||
|
|
||||||
|
| Контекст | Severity |
|
||||||
|
|----------|----------|
|
||||||
|
| article | 🟡 medium |
|
||||||
|
| message | 🟢 low |
|
||||||
|
| resume | 🟢 low |
|
||||||
|
|
||||||
### S07: Двоеточие перед каждым списком
|
### S07: Двоеточие перед каждым списком
|
||||||
|
|
||||||
**Что:** Вводная фраза с двоеточием перед каждым bullet-списком: «Основные преимущества:», «Ключевые особенности:», «Что мы сделали:».
|
**Что:** Вводная фраза с двоеточием перед каждым bullet-списком: «Основные преимущества:», «Ключевые особенности:», «Что мы сделали:».
|
||||||
@@ -382,6 +386,10 @@ AI-модели же подставляют типографически кор
|
|||||||
| message | 🟡 medium |
|
| message | 🟡 medium |
|
||||||
| resume | 🟡 medium |
|
| resume | 🟡 medium |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Категория: Тон и авторская позиция
|
||||||
|
|
||||||
### T01: Vague attribution (размытые ссылки на авторитет)
|
### T01: Vague attribution (размытые ссылки на авторитет)
|
||||||
|
|
||||||
**Что:** «Эксперты отмечают», «По мнению специалистов», «Согласно исследованиям», «Многие разработчики считают» — без указания, кто именно.
|
**Что:** «Эксперты отмечают», «По мнению специалистов», «Согласно исследованиям», «Многие разработчики считают» — без указания, кто именно.
|
||||||
@@ -461,6 +469,10 @@ AI-модели же подставляют типографически кор
|
|||||||
| message | 🟡 medium |
|
| message | 🟡 medium |
|
||||||
| resume | 🟢 low |
|
| resume | 🟢 low |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Категория: Резюме-специфичные паттерны
|
||||||
|
|
||||||
### R01: Абстрактные impact-фразы без цифр
|
### R01: Абстрактные impact-фразы без цифр
|
||||||
|
|
||||||
**Что:** «Значительно повысил эффективность», «Оптимизировал бизнес-процессы», «Внёс существенный вклад в развитие».
|
**Что:** «Значительно повысил эффективность», «Оптимизировал бизнес-процессы», «Внёс существенный вклад в развитие».
|
||||||
@@ -541,21 +553,3 @@ AI-модели же подставляют типографически кор
|
|||||||
| article | 🟡 medium |
|
| article | 🟡 medium |
|
||||||
| message | 🟡 medium |
|
| message | 🟡 medium |
|
||||||
| resume | 🔴 high |
|
| 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
|
|
||||||
Reference in new issue
Block a user