ASD-STE100 Skill ZH
Скилл переписывает китайский технический текст в контролируемый язык: одно действие на фразу, активный залог, один термин.
- 96 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл только переписывает текст по правилам, а линтер читает файлы и ничего в них не меняет.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/asd-ste100-skill-zhОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл только переписывает текст по правилам, а линтер читает файлы и ничего в них не меняет.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл превращает расплывчатый и многословный китайский технический текст в контролируемый: одна фраза описывает одно действие, глаголы стоят в активном залоге, одно слово держит одно значение. Из текста уходят отглагольные существительные, маркетинговые прилагательные и ритуальные обороты. Адресат — тот, кто не сможет переспросить: другой агент, конвейер перевода, читатель не на родном языке или вы сами через полгода. Правила написаны заново под китайский язык: типичные сбои там отличаются от английских: пустые глаголы, синонимы вперемешку, цепочки через точку с запятой. Длина указания ограничена 25 знаками, пояснения 40. Модальность вроде «возможно» скилл не трогает: уверенность считается частью содержания.
Для кого. Авторам документации и промптов на китайском, чьи тексты читают агенты, переводчики и коллеги вне вашей команды.
Подходит, если
- Сообщение об ошибке или описание инструмента двусмысленно, и агент его неверно понимает.
- README читается тяжело и нужна редакторская правка.
- Инструкции для другого агента надо избавить от неоднозначности.
- Текст перед передачей на перевод должен стать однозначным.
Не подходит, если
- Нужна правка английского текста: для него есть оригинальный скилл ASD-STE100.
- Тон художественного текста важнее однозначности.
- Необходимо сохранить стиль автора, включая оговорки и осторожные формулировки.
Пример запроса к агенту
Перепиши эту ошибку по правилам контролируемого китайского и покажи нарушенные правила в таблице.Ограничения
Скилл дает правила и примеры до и после, а проверку выполняет модель, поэтому результат зависит от агента. Встроенный линтер `scripts/ste-lint-zh.py` только механический: он использует стандартную библиотеку Python 3.8 или новее и ловит формальные нарушения вроде длины фраз и стоп-оборотов. Смысловую правку линтер заменить не может. По умолчанию скилл возвращает только переписанный текст, таблицу нарушений и исходных фраз выдают по просьбе показать diff. Для Codex правила вставляют в `AGENTS.md`, отдельной установки скилла там нет.
Как отключить. Удалите папку скилла из каталога скиллов агента или запись правил из `AGENTS.md`. Файлы, которые агент уже переписал, остаются в проекте.
Частые вопросы
Чем скилл отличается от английского ASD-STE100?
Это не перевод, правила написаны заново под типичные сбои китайского текста: пустые глаголы, чередование синонимов, цепочки через точку с запятой и калька с английского. Список отличий лежит в NOTICE.md.
Какую длину фраз задают правила?
Для указаний до 25 знаков, для пояснений до 40.
Меняет ли скилл оговорки вроде «возможно»?
Нет. Модальность остается: уверенность автора считается содержанием текста.
Как увидеть, что изменилось?
Попросите показать diff или нарушенные правила. Скилл выдаст таблицу из трех колонок: правило, исходная фраза, переписанный вариант.
Как поставить в Codex?
Вставьте блок правил из README в `AGENTS.md` проекта или в общий файл инструкций. Для механической проверки пригодится линтер.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл переписывает плотный и двусмысленный английский по правилам упрощенного технического языка ASD-STE100, чтобы текст не мог прочитать неправильно другой аге
Скилл переписывает техтексты на упрощенный английский ASD-STE100: короткие фразы, активный залог, предупреждение перед шагом.
Скилл задает контролируемый китайский для техтекстов: 40 правил, словарь запретных слов и скрипт проверки по ASD-STE100.
Скилл для китайских технических текстов: правит документацию, интерфейсные строки и описания API, держит факты и проверяет выдачу линтером
Скилл учит агента писать документацию и ответы простым английским по правилам ASD-STE100: короткие фразы, один термин, условие перед командой
Скилл переводит англоязычные и франкоязычные учебные материалы на китайский и собирает HTML, DOCX или Markdown с терминами.
Коротко о README
Репозиторий дает рабочее руководство для переписывания китайских текстов, сравнения до и после и линтер без зависимостей. Описаны установка для Claude Code, Codex и DSH, где скилл регистрируется локальным плагином.
Бейдж для README
Исходный SKILL.md
--- name: ste-zh description: 把含糊、啰嗦、容易被误读的中文技术文本改写成受控中文（一句一动作、主动语态、一词一义、去名词化、去营销形容词与套话），用于工具描述、报错信息、agent 间指令、system prompt、状态汇报、README。含 Strict / 中文-顺 两档与确定性 linter。触发：受控中文、中文去歧义、STE100 中文化、把这段话写清楚、"让别的 agent 读不错"。不用于创意、营销、文学文案。 version: 1.0.0 --- # 受控中文技术写作（ASD-STE100 中文化） ASD-STE100 是航空业为了「维修工不可能读错」而做的受控英语：一个词只有一个意思，一句话只有一种结构。 本技能把同一条纪律搬到中文，读者换成**没有追问机会的另一方**：另一个 agent、翻译管线、非母语读者、 半年后的你自己。 中文的歧义来源和英语不同。英语主要栽在「一个词多个意思」和「一句话多种结构」上；中文主要栽在四件事： **虚动词**（进行 / 加以 / 作出 + 名词）、**套话**（需要注意的是、在一定程度上）、**同义轮换** （用户 / 客户 / 使用者 混用）、**一句串三件事**（用分号、破折号、「并且 / 同时 / 从而」串起来）。 所以下面的规则按中文重写，不是把英文规则逐条翻译过来。 规则分两类，本技能只能把其中一类做到「可核对」： - **结构规则**：讲句子形状，读完描述就能执行，可以放心硬性套用。 - **词汇规则**：需要一个受控词表才算标准。中文没有（也不该有）官方词表，所以词汇规则降级成 「方向」——挑最普通、最常见的说法，并在输出里说明这是方向而不是合规声明。 ## 什么时候用 - 一段中文说明、报错、日志、工具描述读起来含混、术语堆砌、或者绕。 - 文本要交给另一个 agent、翻译管线、非母语读者解析，**读错有代价**。 - 你在写 prompt、system message、工具描述，想在模型看到之前先消掉歧义。 - 你想要**前后对照**，看清违反了哪条规则、改完为什么更好。要就说 —— 默认输出只有改写后的正文。 不用在：创意文案、营销文案、文学、需要语气与节奏的地方。受控中文是故意平淡、字面化的。 ## 两档模式 改写前先选档。用户没说就按文本类型推断，并在输出里用一句话说明选了哪档。 **Strict（严格）** —— 程序步骤、报错信息、工具与函数描述、agent 间指令、安全相关文本。 凡是读错有代价的地方，全部规则执行，包括硬性句长上限和「一词一义」。 **中文-顺（STE-flavored）** —— README、PR 描述、变更日志、解释性文章。结构规则全执行， 词汇规则只作为方向：句长上限、主动语态、简单体貌、不用分号、去名词化、去营销形容词都保留， 但不锁死用词 —— 说明文需要一点弹性，全锁死读起来像换了个作者，而不是变清楚了。 两档和「结构 / 词汇」这条分界线是同一件事的两个方向：分界线说的是**哪些规则不依赖词表也能核对**， 两档说的是**对某类文本该执行到哪一步**。