Живой русский

write-native-russian — скилл для Codex, который помогает писать и редактировать русский текст без машинной кальки, канцелярита и гладких фраз без смысла.

Он сохраняет смысл, термины, голос автора и степень уверенности. Скилл учитывает жанр и не превращает любой текст в технический отчёт или аналитическую статью.

Что умеет скилл

• писать русский текст с нуля по смысловому каркасу;
• переписывать машинный или переводной русский;
• редактировать интерфейсы, письма, документацию, технические и учебные материалы;
• находить неверное управление и неестественную сочетаемость;
• возвращать субъект действия в предложения, где «таблица объясняет», а «метод понимает»;
• отличать стилистическую проблему от дыры в содержании;
• подключать отдельный аналитический профиль только для соответствующего жанра.

Пример

До:

В рамках работы механизма осуществляется автоматическое сохранение пользовательского ввода.

После:

Редактор сохраняет черновик каждые десять секунд. Если вкладка закроется, текст можно восстановить.

Установка

Попросите Codex установить скилл из репозитория:

Установи скилл из https://github.com/x0rium/write-native-russian

Или клонируйте его вручную:

git clone https://github.com/x0rium/write-native-russian.git \
  "${CODEX_HOME:-$HOME/.codex}/skills/write-native-russian"

Использование

Сошлитесь на скилл явно:

Используй $write-native-russian и перепиши этот фрагмент естественным русским.
Сохрани термины, тон и степень уверенности автора.

Можно сформулировать задачу и обычным языком:

• «Убери из текста нейрослоп и канцелярит».
• «Проверь, звучит ли этот раздел как текст носителя языка».
• «Перепиши инструкцию по-русски, не меняя технический смысл».
• «Сделай сообщение интерфейса коротким и понятным».
• «Отредактируй деловое письмо, сохранив спокойный прямой тон».

Как он работает

Скилл проверяет восемь классов проблем:

1. управление;
2. лексическую сочетаемость;
3. семантическую совместимость;
4. ложный субъект действия;
5. гладкую фразу без проверяемого смысла;
6. подвешенные обороты;
7. канцелярские цепочки;
8. пустые усиления.

Подробные правила лежат в references/. При обычной редактуре скилл не скачивает датасеты и не запускает внешний анализ.

Жанровые профили

Универсальные правила не требуют от любого текста доказательств, гипотез или аналитической структуры. Для аналитических материалов и учебника по аналитике есть отдельный профиль references/analytical-prose.md. Он загружается только для этого жанра.

Структура

.
├── SKILL.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── analytical-prose.md
│   ├── dataset-derived-error-patterns.md
│   ├── native-russian-patterns.md
│   ├── native-russian-rulebook.md
│   └── russian-error-resources.md
└── scripts/
    ├── analyze_error_datasets.py
    └── validate_skill.py

• SKILL.md задаёт поведение и условия срабатывания скилла.
• references/ содержит универсальные правила, паттерны ошибок, жанровые профили и сведения об источниках.
• analyze_error_datasets.py нужен только для развития правил по локально полученным корпусам.
• validate_skill.py проверяет структуру репозитория без сторонних зависимостей.

Разработка

Проверить структуру и smoke-тест анализатора:

python3 scripts/validate_skill.py
python3 scripts/analyze_error_datasets.py --help

Новые правила лучше добавлять в формате «плохая фраза → тип ошибки → несколько естественных замен → границы применимости». Не превращайте единичный пример в универсальный запрет.

Лицензия

MIT