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)
|
||||
- **resume** — резюме, сопроводительное письмо
|
||||
|
||||
Контекст влияет на severity паттернов. Подробности — в `references/patterns.md`, раздел "Матрица severity".
|
||||
Контекст влияет на severity паттернов. Severity для каждого паттерна указана в таблице внутри его описания в `references/patterns.md` (колонки article / message / resume).
|
||||
|
||||
### Шаг 2: Прогнать текст
|
||||
|
||||
@@ -79,4 +79,4 @@ description: "Проверяет текст на признаки AI-генер
|
||||
|
||||
- **Не быть AI-детектором.** Скилл не определяет, написан ли текст AI. Он ищет стилистические паттерны, которые _ассоциируются_ с AI-генерацией. Человек тоже может так писать.
|
||||
- **Русский язык — приоритет.** База паттернов заточена под русскоязычный текст. Английские паттерны включены для смешанных текстов (технические статьи с англицизмами).
|
||||
- **Не трогать содержание.** Скилл проверяет стиль и форму, не фактическую корректность.
|
||||
- **Не трогать содержание.** Скилл проверяет стиль и форму, не фактическую корректность.
|
||||
@@ -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
|
||||
Reference in new issue
Block a user