asd-ste100-skill: делает английские инструкции для ИИ-агентов менее двусмысленными

asd-ste100-skill — навык для Claude Code, который переписывает сложный английский текст так, чтобы следующий ИИ-агент с меньшей вероятностью понял инструкцию двояко. Он пригодится, если вы передаёте агенту описание инструмента, сообщение об ошибке или результат работы другого агента и хотите убрать из текста неясные условия. Навык меняет формулировки, но не проверяет, верны ли сами инструкции.

Как asd-ste100-skill разбирает инструкции для агентов

В основе навыка — принципы ASD-STE100 Simplified Technical English. Это стандарт упрощённого технического английского, созданный для инструкций по обслуживанию авиационной техники. Автор репозитория применил его подход к текстам, которые читает не механик, а программа: ИИ-агент должен понять сообщение без возможности спросить автора, что тот имел в виду.

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

Перед переписыванием навык выбирает режим. Strict предназначен для процедур, сообщений об ошибках и описаний инструментов: там неточность может изменить следующий шаг агента. STE-flavored рассчитан на README, описания запросов на изменение кода — PR — и пояснительный текст. Во втором режиме сохраняется дисциплина коротких и ясных предложений, но нет требования ограничиваться фиксированным словарём.

По README навык сначала разбирает смысл исходного английского текста, затем отмечает нарушения по предложениям и переписывает проблемные места. Он должен сохранять факты, условия и ограничения исходной фразы. Если сокращение уберёт важную оговорку, инструкция навыка требует оставить более длинную формулировку и обозначить компромисс, а не молча выбросить условие.

Обычный ответ — только переписанный текст. Если что-то намеренно осталось без упрощения, навык может добавить строку Kept as-is:. Когда вам нужно увидеть причины правок, попросите show the diff или explain the changes: вместо одного результата вы получите таблицу «до/после» с названиями затронутых правил.

Где пригодится ясный английский, а где он лишний

Представьте, что вы ведёте проект в Claude Code и пишете описание функции для другого агента. В одной длинной фразе у вас смешались действие, условие конфликта и способ его разрешения. Навык помогает разделить их на последовательные предложения, чтобы получатель не принял условную возможность за обязательное действие.

Вторая ситуация — агент получает ошибку от инструмента и должен предложить следующий шаг. Если сообщение смешивает предположение о причине с установленным фактом, переписывание помогает явно отделить «запрос мог завершиться неудачно» от «устаревший клиент может вызвать несовпадение форматов». Оно не устанавливает настоящую причину сбоя: её всё равно нужно проверить отдельно.

Третья ситуация — вы готовите системный промпт или сообщение для передачи между агентами. Здесь полезно проверить, кто выполняет действие, при каком условии и что должно произойти после него. Если вам пока незнаком формат таких расширений, сначала посмотрите, как устроены навыки для Claude и других агентов: этот репозиторий предлагает именно навык, а не MCP-сервер.

Если вы пишете художественный текст или рекламный материал, инструмент вам, скорее всего, не нужен. Автор прямо исключает задачи, в которых важны интонация и оттенки смысла: результат намеренно получается буквальным и сухим. Для русского текста он тоже не заявлен — основной сценарий в README связан с английским.

Установка навыка в проект или во все проекты Claude Code

README предлагает два способа установки. Первый — через skills CLI из корня проекта; он добавляет навык для текущего проекта:

npx skills add danyuchn/asd-ste100-skill

Для последующего обновления через этот способ README приводит отдельную команду:

npx skills update

У skills CLI есть деталь, которую лучше знать заранее: по README он отправляет анонимную статистику установки — название навыка и время установки, без личных данных и сведений об устройстве. Чтобы отказаться от этой передачи, автор предлагает установить переменную окружения со следующим значением:

DISABLE_TELEMETRY=1

Второй способ — клонировать репозиторий в каталог навыков Claude Code. README указывает такой путь и команду:

git clone https://github.com/danyuchn/asd-ste100-skill ~/.claude/skills/asd-ste100

При этом способе навык доступен во всех проектах Claude Code. Автор рекомендует его тем, кто хочет хранить локальную копию репозитория и обновлять её через git pull. README не описывает отдельной настройки API-ключа или подписки для самого навыка. Для проверки текста предусмотрен Python-скрипт, но ставить его ради обычного запроса к навыку README не требует.

Что вводить в Claude Code и какой ответ ждать

Чтобы вызвать навык, README предлагает прямо попросить Claude уточнить английский текст. Например, для описания инструмента используется такой запрос:

Disambiguate this tool description

В демонстрации исходное описание говорит, что инструмент синхронизирует состояние между настроенными системами и может автоматически разрешить конфликт в зависимости от выбранной стратегии. Переписанный вариант раскладывает это на шаги: инструмент ищет конфликт, читает стратегию, при разрешении стратегии может устранить конфликт без пользователя, а иначе сообщает о нём для ручной проверки. Важная часть примера — слово «может» не превращается в обещание обязательного автоматического разрешения.

Для сообщения об ошибке README даёт другой запрос:

Rewrite this error message so an agent can't misparse it

В примере расплывчатая фраза связывает неудачный запрос с возможным несовпадением формата данных и устаревшим клиентом. Переписанный текст разделяет эти утверждения и заканчивается конкретным действием — проверить версию клиента. Это делает цепочку предположений видимой, но не доказывает, что виновата именно версия.

Третий запрос из README применяет правила к инструкции:

Apply ASD-STE100 to this instruction

После него вставьте английский текст, который хотите переписать. Если нужен не только итог, но и объяснение каждой правки, добавьте к запросу show the diff. Тогда, согласно README, навык выдаст таблицу исходных и новых формулировок с указанием правил, вместо ответа, состоящего только из исправленного текста.

Что проверяет линтер и почему результат нужно читать самому

В репозитории есть отдельный линтер — скрипт, который ищет нарушения по заданным текстовым признакам. Его можно запустить на файле; README приводит, в частности, такую команду для собственного SKILL.md проекта:

python scripts/ste-lint.py --baseline 36 SKILL.md

Число 36 здесь относится к примеру проверки файла репозитория, а не к универсальной настройке для ваших документов. Автор предупреждает, что сам SKILL.md не проходит проверку без замечаний: в таблицах правил цитируются запрещённые конструкции, а часть предложений длинная. Находки этого запуска предлагается читать как примеры, а не как доказательство дефектов навыка.

Линтер ищет, среди прочего, точки с запятой, пассивные конструкции, длинные предложения, некоторые формы времени и короткий заданный список разговорных составных глаголов. Он не понимает все такие глаголы, не измеряет длину цепочек существительных и не отмечает слова, выражающие неуверенность. Нулевое число нарушений означает только то, что настроенные структурные проверки ничего не нашли.

Главное ограничение: линтер не сравнивает исходный текст с переписанным и не доказывает сохранность смысла или силы требования. Кроме того, навык не включает официальный словарь ASD-STE100 примерно из 900 разрешённых слов: README объясняет это ограничениями на воспроизведение стандарта. Для документации, которой нужно официальное соответствие STE, автор советует пользоваться настоящим стандартом, а не считать результат навыка сертифицированным.

Репозиторий создан 20 июля 2026 года; на момент обзора у него 5554 звезды, последний коммит датирован 24 октября 2026 года, лицензия — MIT. Это инструмент для редакторской проверки английских инструкций, а не замена проверки логики агентом или человеком. Если вы даёте ему файлы для проверки линтером, скрипт читает выбранный вами текст; если отправляете текст навыку, учитывайте, что именно этот текст получит Claude Code.

Источник: репозиторий danyuchn/asd-ste100-skill.