ASD-STE100 Skill — упрощённый технический английский для текстов, которые читают агенты

· 6 мин чтения
skills writing claude-code prompt-engineering ai-agents
📂 Исходный код на GitHub

Правила ASD-STE100 Simplified Technical English, переработанные в скилл для Claude Code: переписывает двусмысленный английский, который читают агенты. Два режима, детерминированный линтер на Python, принцип контролируемого языка без копирования фирменного словаря ASD.

ASD-STE100 Skill — упрощённый технический английский для текстов, которые читают агенты

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.

Как устроен скилл

Скилл работает в пять шагов:

  1. Выбирает режим. Строгий режим предназначен для процедур, сообщений об ошибках и описаний инструментов. Свободный режим (STE-flavored) — для README, описаний PR и объяснительного текста. Он держит дисциплину предложений, но без жёсткой фиксации словаря.
  2. Читает текст и разбирается в его смысле.
  3. Помечает нарушения по каждому предложению: двусмысленный выбор слов, перфект и сложные времена, пассивный залог без ясного деятеля, несколько инструкций в одном предложении, громоздкие цепочки существительных, пропущенные слова, слишком длинные предложения, фразовые глаголы, номинализации, точки с запятой, нагромождения оговорок, рекламные прилагательные.
  4. Переписывает каждое помеченное предложение — и не выбрасывает при этом ни факта, ни условия, ни уточнения из оригинала. Если короткая формулировка теряет нужную точность, скилл оставляет длинную и помечает компромисс отдельно, а не упрощает молча.
  5. Возвращает только переписанный текст — без преамбулы, без анонса режима, без сводки изменений. Если что-то скилл нарочно оставил несупрощённым, он добавляет одну строку «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 определяет правила только для английского. Поэтому адаптации для других языков — именно адаптации, а не официальный стандарт:

Отдельный родственный инструмент — meiluosi/rewrite-fidelity-skill. Он сравнивает оригинал с переписанной версией и помечает изменения смысла и модальности. Основан он на паттернах, поэтому каждый флаг стоит проверять вручную.

Лицензия — MIT, LICENSE. Полный свод правил со ссылками на источники — в references/writing-rules.md. Официальный сайт стандарта — asd-ste100.org.

Источник: https://github.com/danyuchn/asd-ste100-skill