Упрощенный технический русский (УТР)

Установка

git clone https://github.com/loadkpi/simplified-technical-russian-skill ~/.claude/skills/simplified-technical-russian

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл переносит на работу с кодом правила раздела 8.2 ГОСТ Р 58049-2017: короткие предложения до 20 слов, действительный залог, прямой порядок слов, один термин на одно понятие. Он работает в четырех режимах: пишет текст, правит с таблицей изменений, проверяет без правки и держит правила всю сессию. Правила применяются только к русскому тексту. В комплекте линтер на Python без зависимостей: 18 правил, режимы для документов и комментариев в коде, вывод в JSON, глоссарий проекта и хук PostToolUse для Claude Code.

Для кого. Для разработчиков и технических писателей, которым нужны однозначные русские комментарии, README и сообщения об ошибках.

Пример запроса к агенту

Упрости комментарии в этом файле и покажи таблицу правок

Ограничения

Установка сама по себе не включает правила для всего текста: нужна строка в CLAUDE.md или хук. Линтер ищет признаки эвристиками, поэтому часть предупреждений о причастиях и страдательном залоге ложные. Соответствие ГОСТ скилл не сертифицирует. Нужен Python 3.7 и новее для линтера.

Как отключить. Удалите папку ~/.claude/skills/simplified-technical-russian, строки про УТР из CLAUDE.md и хук utr_lint.py из settings.json.

Проверка безопасности

• Линтер запускается как Python-скрипт и читает файлы проекта
• Опциональный хук выполняется после каждой записи файла

Коротко о README

README объясняет, что такое УТР и почему агенту полезны его ограничения, и перечисляет файлы скилла: правила по пунктам ГОСТ, адаптацию к коду, словарь замен, чек-лист и примеры. Дана установка для Claude Code, Codex через AGENTS.md, Cursor, Windsurf и Cline. Отдельно описано, как включить правила постоянно через CLAUDE.md или принудительно через хук. Приведена таблица 18 правил линтера, способы подавления проверок и работа с глоссарием.

SKILL.md

---
name: simplified-technical-russian
description: >-
  Упрощает и проясняет русский технический текст: одно значение на слово,
  действительный залог, прямой порядок слов, не более 20 слов в предложении
  (УТР, ГОСТ Р 58049—2017). Применяйте, только если упрощаемый или создаваемый
  текст написан по-русски; язык запроса значения не имеет. Триггеры: упрости,
  кратко, короче, проще, понятнее, простым языком, по УТР. К тексту на других
  языках не применяйте.
license: MIT
version: 1.1.0
---

# Упрощённый технический русский (УТР, ГОСТ Р 58049—2017)

УТР — контролируемый технический язык: подвид естественного языка, полученный
через систему ограничений лексики и грамматики. Цель ограничений — максимальная
однозначность восприятия (пункт 3.14). Стандарт создан по образцу ASD-STE100
(Simplified Technical English) и вводит те же ограничения для русского языка.

Навык переносит правила раздела 8.2 на техническую работу с кодом и
документацией. Читатель здесь другой: разработчик, переводчик, машинный
переводчик или другой ИИ-агент. Ошибка чтения стоит так же дорого, как в
инструкции по техническому обслуживанию.

## Проверка языка — до всего остального

**Сначала определите язык текста, который правите или пишете. Правила
применяйте только к русскому тексту.**

Язык запроса значения не имеет. Просьба «упрости этот комментарий», заданная
по-русски, относится к УТР только тогда, когда сам комментарий написан
по-русски.

## Режимы работы

| Режим | Когда включать | Что выдавать |
|---|---|---|
| **Письмо** | Просят написать русский текст | Только готовый текст. Без таблиц и пояснений |
| **Правка** | Дали текст и просят упростить или сократить | Исправленный текст, затем таблицу правок |
| **Аудит** | Просят проверить текст | Только таблицу нарушений. Текст не меняют |
| **Постоянный** | Просят применять правила ко всей сессии | Каждый русский ответ по правилам. Без таблиц |

Похожие