Выжимка ru-text для коротких русских отчётов / findings / статусов / комментариев. Для агентов с малой русской выдачей (verifiers, reviewers, status-сообщения). НЕ для копирайтинга — там используй полный ru-text.
Instrucciones de origen · Vista previa de solo lectura
name
ru-text-quick
description
Выжимка ru-text для коротких русских отчётов / findings / статусов / комментариев. Для агентов с малой русской выдачей (verifiers, reviewers, status-сообщения). НЕ для копирайтинга — там используй полный ru-text.
ru-text-quick — Дисциплина короткого русского текста
Дистилляция ~/.claude/skills/ru-text/ для агентов, чья выдача — отчёты, findings, статусы, комментарии. Не для статей, лендингов, маркетинга — там ru-text.
1. Когда применять / не применять
Применять:
Verdict / Summary / Notes в verifier-отчёте
Findings в code review
Status-сообщения («Сделал X, осталось Y»)
Любая prose-выдача в YAML-полях summary, notes, detail, fix_suggestion
Однострочные комментарии к результатам проверок
НЕ применять:
JSON / YAML / XML / код / логи — там свой синтаксис
Английские токены внутри кода (переменные, функции, пути)
2. Длинная цепочка родительных падежей
❌ «Результат проверки корректности валидации данных формы»
✅ «Валидация формы прошла — данные корректны»
3. Пассивный залог без актора
❌ «Тест был прогнан, ошибки были обнаружены»
✅ «Прогнал тест — нашёл 3 ошибки»
4. Безликие формулы вместо конкретики
❌ «В ходе проведённого анализа установлено наличие ряда проблем»
✅ «Анализ выявил 2 проблемы: X и Y»
5. Модальные смягчения
❌ «Возможно, имеет смысл рассмотреть вариант добавления»
✅ «Добавь X — это исправит Y»
5. Типографика (обязательно)
Элемент
Ошибка
Правильно
Длинное тире
Слово - слово
Слово — слово (U+2014, с пробелами)
Дефис в переносе строки
Москва-столица
остаётся - (составное слово)
Диапазон чисел
10-15 тестов
10–15 тестов (en dash, U+2013, без пробелов)
Кавычки основные
"текст"
«текст» (ёлочки)
Кавычки вложенные
«"вложенные"»
«„вложенные"» (лапки)
Многоточие
... (3 точки)
… (U+2026, один символ)
Неразрывный пробел
5 кг, 100 %
5 кг, 100 % (U+00A0 между числом и единицей)
Неразрывный пробел инициалы
А. С. Пушкин
А. С. Пушкин (nbsp между инициалами)
Неразрывный пробел перед тире
слово — слово
пробел перед — должен быть неразрывным
Числа от 10 000
1000000
1 000 000 (тонкий пробел U+202F)
Проценты
5 %
5% — без пробела (принятый технический стиль)
Порядковые числительные
1ый, 2ой
1-й, 2-й
Аббревиатуры
т.д.
т. д. (с пробелом и nbsp)
Правило для агентов: в plain-text / Markdown ставь реальные символы: —«»…. Не --, не "", не ....
6. Паттерны структуры
Verifier-отчёт
✅ Прошло: 47 / ❌ Провалилось: 3 / ⚠️ Предупреждений: 2
Провалилось:
- auth.ts:82 — отсутствует проверка подписи вебхука
- payments.ts:140 — сумма сравнивается как float, не в копейках
- webhook.ts:201 — дублирующийся вебхук не de-duplicated
Предупреждения:
- Нет rate limit на POST /webhook (не блокирует деплой)
Status-сообщение
Формула: Сделал X → проверил Y → осталось Z (или что нашёл).
Прогнал полный тест-сьют (187 тестов, 4 m 12 s).
Нашёл 3 падения — все в auth-модуле, связаны с новым middleware.
Остальное зелёное. Детали в findings ниже.
Bug finding
Что: двойное списание при повторном вебхуке
Где: src/payments/webhook.ts:201, функция handlePaymentConfirmed
Почему: отсутствует проверка уникальности transaction_id перед записью
Как чинить: добавить уникальный индекс на transaction_id и проверять перед вставкой
7. Self-check (5 секунд)
Перед отдачей любого русского текста — 6 пунктов:
Нет запрещённых слов из anti-cliché (качественный, эффективный, комплексный…)
Нет цепочек родительных падежей длиннее двух уровней
Нет пассивного залога без явного актора
Цифры вместо расплывчатых эпитетов (много/быстро/долго)
Модальных смягчений нет («возможно», «как бы», «стоит рассмотреть»)
9. Правила общения оркестратора (dev-orchestrator) с пользователем
Пользователь является не-программистом (маркетинг, бизнес). Любые технические действия, отчеты и сообщения оркестратора или воркеров должны переводиться на понятный человеческий язык.
Принципы:
Никакого парада внутренних механизмов: не показывай названия MCP-инструментов, полные пути к глубоким файлам (например, вместо src/lib/agent/handlers/init.ts пиши «обработчик инициализации»), хеши коммитов, PM2-команды, сырые JSON-логи.
Краткость и фокус: при запросе расшифровки термина («что такое PR?») отвечай одной простой фразой и сразу возвращайся к работе.
Зеркальный регистр: если пользователь сам переходит на технический жаргон («сделай detect_changes», «чекни PR #35»), можно отвечать в его терминологии. В остальных случаях — строго plain language.
Готово.
Что сделали:
- <одна-две строки человеческим языком: что изменилось для пользователя>
Где увидеть:
- <URL продакшна или путь к экрану в UI>
- Изменения на проде с HH:MM <timezone>
- <N> тестов прошли, ничего не сломали
Если что не так — скажи, откачу.
Запрещенные термины в отчетах (требуют замены/перевода)
По умолчанию в отчетах не должны появляться слова: коммит, merge, push, PR, worktree, PM2, branch, rebase, force-push, deploy.
Если пользователь сам использует их в текущей сессии — можно зеркалить их в ответах. В остальных случаях переводи их на русский человеческий язык.
Сделал 3 из 8 задач. Все тесты проходят. Безопасность нашла 2 мелких
замечания — добавил в TODO, не блокеры. Иду к задаче 4.
10. Sources
Выжимка из ~/.claude/skills/ru-text/ (Arseniy Kamyshev, talkstream/ru-text).
Полный канон: ~/.claude/skills/ru-text/SKILL.md и references/.
Применяй ru-text (полный) когда нужен copywriting, UX-текст, статьи.
Быстрый старт: что читать первым
Раздел 2 (7 правил) — даёт рабочую основу за 30 секунд.
Раздел 3 (anti-cliché) — сверяй с каждым прилагательным в выдаче.
Раздел 7 (self-check) — 6 галочек перед отдачей.
Если сомневаешься в примере — references/examples-before-after.md.
