ASD-STE100 Skill — упрощённый технический английский для текстов, которые читают агенты
📂 Исходный код на GitHubПравила ASD-STE100 Simplified Technical English, переработанные в скилл для Claude Code: переписывает двусмысленный английский, который читают агенты. Два режима, детерминированный линтер на Python, принцип контролируемого языка без копирования фирменного словаря ASD.
asd-ste100-skill — скилл для Claude Code, который переписывает плотный и двусмысленный английский в упрощённый технический английский. Речь о стандарте ASD-STE100 (Simplified Technical English, STE) — контролируемом языке, который придумали в авиационной и оборонной промышленности. Его задача: чтобы инструкции по обслуживанию самолётов нельзя было понять неправильно.
Автор скилла направил этот стандарт на другого читателя. Не на человека, а на ИИ-агента, который разбирает вывод другого агента, описание инструмента, сообщение об ошибке или инструкцию от одного агента к другому. В этом сценарии человека в цикле нет. Переспросить «вы имели в виду X или Y?» не у кого.
Зачем авиационный стандарт агенту
STE появился потому, что неверно понятая инструкция на самолёте может убить людей. Читали её часто не носители английского, а автора рядом не было. Ответ стандарта: одно значение на слово, активный залог, простые времена, одна инструкция на предложение, короткие предложения, никаких пропущенных слов.
Агент, который разбирает вывод другого агента, живёт в похожих условиях. Бокового канала связи нет. Спросить «что вы имели в виду?» нельзя. Те же правила, которые не дают механику неверно понять момент затяжки болта, не дают агенту неверно понять описание инструмента или сообщение от другого агента.
Пример: до и после
| До | После |
|---|---|
| "This tool will attempt to synchronize state across the various backends that have been configured, and if a conflict is detected it may resolve it automatically depending on the strategy that has been set, or otherwise it will surface the conflict for manual review." | "The tool tries to synchronize state across the configured backends. If it finds a conflict, it reads the configured strategy. If the strategy allows automatic resolution, the tool may resolve the conflict without a user. If the tool does not resolve the conflict, it reports the conflict for manual review." |
| "An error may have occurred while processing your request due to a possible mismatch in the expected data format, which could be caused by an outdated client version." | "Your request may have failed. The cause may be a data format that does not match what the server expects. An outdated client can cause this mismatch. Check your client version." |
Ещё примеры, в том числе разбор самих официальных правил STE, лежат в examples/before-after.md.
Как устроен скилл
Скилл работает в пять шагов:
- Выбирает режим. Строгий режим предназначен для процедур, сообщений об ошибках и описаний инструментов. Свободный режим (STE-flavored) — для README, описаний PR и объяснительного текста. Он держит дисциплину предложений, но без жёсткой фиксации словаря.
- Читает текст и разбирается в его смысле.
- Помечает нарушения по каждому предложению: двусмысленный выбор слов, перфект и сложные времена, пассивный залог без ясного деятеля, несколько инструкций в одном предложении, громоздкие цепочки существительных, пропущенные слова, слишком длинные предложения, фразовые глаголы, номинализации, точки с запятой, нагромождения оговорок, рекламные прилагательные.
- Переписывает каждое помеченное предложение — и не выбрасывает при этом ни факта, ни условия, ни уточнения из оригинала. Если короткая формулировка теряет нужную точность, скилл оставляет длинную и помечает компромисс отдельно, а не упрощает молча.
- Возвращает только переписанный текст — без преамбулы, без анонса режима, без сводки изменений. Если что-то скилл нарочно оставил несупрощённым, он добавляет одну строку «Kept as-is:». По запросу «show the diff» он выдаёт таблицу до/после с названиями нарушенных правил.
Структурные правила механические: можно ткнуть в конкретное слово или знак, который их нарушает. Правила, зависящие от словаря ASD, скилл помечает как рекомендацию, а не жёсткое требование. А решения, где нужен вкус, остаются автору текста.
Детерминированный линтер
В репозитории есть линтер на Python: scripts/ste-lint.py. Он проверяет структурные паттерны, которые можно найти без нейросети:
- точки с запятой;
- короткий список «мягких» фразовых глаголов: spin up, reach out, dive into, kick off, circle back, touch base;
- номинализации — отглагольные существительные;
- рекламные прилагательные;
- пассивный залог;
- формы перфекта, включая неправильные причастия вроде «has run»;
- слишком длинные предложения;
- синонимы для одного и того же понятия;
- висячие союзы в пунктах списков.
Чего линтер не делает. Он не проверяет длину цепочек существительных — для этого нужен разбор частей речи. И не знает фразовых глаголов вне своего списка, так что «take off the panel» пройдёт незамеченным. Слова-оговорки вроде may и might он тоже не помечает.
Забавная деталь: собственный README репозитория не проходит собственный линтер на ноль нарушений. Таблицы правил цитируют запрещённые паттерны, а часть предложений длинновата. Автор честно предлагает команду python scripts/ste-lint.py --baseline 36 SKILL.md и советует читать находки как примеры, а не дефекты.
Чего в скилле нет
Скилл не воспроизводит официальный словарь ASD примерно на 900 разрешённых слов. Стандарт можно получить бесплатно, но нельзя свободно распространять: выпуск 9 разрешает копирование только с письменного разрешения ASD или восьми перечисленным категориям организаций. Этот проект ни к одной из них не относится.
Вместо словаря скилл применяет сам принцип: самое простое доступное слово, всегда в одном значении. Для сертифицированной STE-документации нужен настоящий стандарт.
Установка
Первый вариант — skills CLI. Запуск из корня проекта, клонирование не нужно:
npx skills add danyuchn/asd-ste100-skill
CLI отправляет анонимную телеметрию: имя скилла и время установки, без личных данных. Так скиллы ранжируются на skills.sh. Телеметрию отключает переменная DISABLE_TELEMETRY=1. Обновление — npx skills update.
Второй вариант — клонировать репозиторий в ~/.claude/skills/. Тогда скилл доступен во всех проектах Claude Code:
git clone https://github.com/danyuchn/asd-ste100-skill ~/.claude/skills/asd-ste100
Обновление — обычный git pull.
Как пользоваться
Попросите упростить или прояснить английский текст:
Disambiguate this tool description
Rewrite this error message so an agent can't misparse it
Apply ASD-STE100 to this instruction
Или вставьте текст и попросите «disambiguate this» или «apply STE100 to this». В ответ придёт переписанный текст и больше ничего. Чтобы увидеть, какие правила применились, добавьте «show the diff» или «explain the changes».
Где скилл уместен, а где нет
Заточен под: сообщения между агентами, описания инструментов и функций, сообщения об ошибках, системные промпты, межагентные инструкции. Коротко: любой английский текст, который должна разобрать машина или не-носитель языка, когда человека рядом нет.
Не подходит для художественного текста, маркетинга и всего, где важны голос и нюансы. STE намеренно плоский и буквальный.
Одно ограничение стоит назвать сразу: скилл правит форму текста, а не содержание. Пустой по смыслу абзац выйдет коротким, чистым и всё равно пустым.
Порты и связанные инструменты
ASD-STE100 определяет правила только для английского. Поэтому адаптации для других языков — именно адаптации, а не официальный стандарт:
- Иврит: g4lb/asd-ste100-hebrew-skill, со своим линтером.
- Индонезийский: jshsinaga/asd-ste100-indonesian-skill.
- Русский: erwinete/asd-ste100-ru, тоже с линтером.
Отдельный родственный инструмент — meiluosi/rewrite-fidelity-skill. Он сравнивает оригинал с переписанной версией и помечает изменения смысла и модальности. Основан он на паттернах, поэтому каждый флаг стоит проверять вручную.
Лицензия — MIT, LICENSE. Полный свод правил со ссылками на источники — в references/writing-rules.md. Официальный сайт стандарта — asd-ste100.org.