Simplified Technical Chinese — скилл

Скилл задает контролируемый китайский для техтекстов: 40 правил, словарь запретных слов и скрипт проверки по ASD-STE100.

  • 82 ★ репозитория
  • Последний коммит
Скилл

Минимальный доступ

Почему такой уровень

  • Скилл меняет только текст и запускает локальный скрипт проверки, внешних вызовов нет.
Все причины и проверки

mzopedia/simplified-technical-chinese

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/simplified-technical-chinese

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скилл меняет только текст и запускает локальный скрипт проверки, внешних вызовов нет.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Simplified Technical Chinese (STC, 简明技术中文) — контролируемый китайский для технических описаний, пошаговых инструкций, документации API и пояснительных ответов моделей. Цель: читатель понимает текст с первого раза. Метод взят у ASD-STE100, контролируемого английского для авиационных руководств: пронумерованные правила, словарь, где одно значение равно одному слову, и ограничения на предложения, которые проверяет скрипт. В репозитории 40 правил двух уровней (обязательные и рекомендуемые), словарь запретов и замен, скрипт `tools/check.py` на Python 3.9 без зависимостей и скилл для Claude Code, Codex и Cursor. Правила учитывают особенности китайского: глаголы с 进行, длинные определения перед существительным, неоднозначность 以上 и 以下, различие 可以 и 支持. Инструкция не длиннее 30 единиц, описание не длиннее 40.

Для кого. Авторам китайской технической документации и командам, которые просят модель объяснять по-китайски коротко и однозначно.

Подходит, если

  • Пошаговую инструкцию по установке сервера надо переписать на однозначные короткие шаги.
  • Документацию API проверяют на запретные слова, длинные предложения и пассив.
  • Модель должна отвечать по-китайски в режиме STC, без `请` и `您`.
  • Перед публикацией текст прогоняют скриптом `check.py` с флагом `--strict`.

Не подходит, если

  • Текст не на китайском: правила и словарь написаны для китайского.
  • Нужна проверка фактов, выбора терминов и логики: скрипт проверяет только синтаксис.
  • Нужна редактура рекламных и художественных текстов: STC рассчитан на техническую речь.

Пример запроса к агенту

Перепиши эту инструкцию по развертыванию на упрощенном техническом китайском и проверь результат скриптом `tools/check.py`.

Ограничения

Версия 0.2. Словарь охватывает общую техническую письменность, около 150 записей в таблицах, и не отраслевую терминологию. Скрипт ловит запретные слова, синонимы, длину предложений и абзацев, пассив, двойное отрицание и открытые списки с 等, но не судит факты, выбор терминов, логику и ограничения значений. Контролируемого исследования скорости чтения нет: калибровка измеряла ложные срабатывания на 3,5 млн знаков документации. Русскоязычному пользователю нужно читать по-китайски, чтобы оценить правки. STC не связан с ASD.

Как отключить. Удалите папку `simplified-technical-chinese` из каталога скиллов агента. Системную подсказку «нормального режима» уберите из настроек проекта.

Частые вопросы

Как подключить скилл?

Выполните `npx skills add mzopedia/simplified-technical-chinese` или клонируйте репозиторий в каталог скиллов: `git clone --depth 1 https://github.com/mzopedia/simplified-technical-chinese.git ~/.claude/skills/simplified-technical-chinese`.

Что делать без скилла?

Вставьте в системную подсказку сокращенный набор правил («нормальный режим») из README. Полный набор лежит в файле `规范.md`.

Какие параметры у скрипта проверки?

`--strict` дает код выхода 1 при обязательных замечаниях, `--json` выводит JSON, `--kind` задает тип предложения, `--max-op` и `--max-desc` меняют пределы длины.

Что скрипт пропускает?

Код, строчный код, комментарии HTML, текст в 「」, заголовок YAML и все между `<!-- stc:off -->` и `<!-- stc:on -->`.

Чем STC отличается от ASD-STE100?

Метод тот же, но правила написаны для китайского языка. STC не перевод STE и не связан с ASD.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл для китайских технических текстов: правит документацию, интерфейсные строки и описания API, держит факты и проверяет выдачу линтером

СкиллМинимальный доступ1,6 тыс.Звезды репозитория

Скилл переписывает китайский технический текст в контролируемый язык: одно действие на фразу, активный залог, один термин.

СкиллМинимальный доступ96Звезды репозитория

Скилл для китайской технической документации: короткие фразы, факты вместо эпитетов и чистка 14 примет ИИ-текста по правилам Жуань Ифэна

СкиллРасширенный доступ415Звезды репозитория

Simplified Technical English Skill

simplified-technical-english

Скилл заставляет модель писать на Simplified Technical English (ASD-STE100), контролируемом английском для технической документации. Неофициальный

СкиллМинимальный доступ1 тыс.Звезды репозитория

Скилл учит агента писать документацию и ответы простым английским по правилам ASD-STE100: короткие фразы, один термин, условие перед командой

СкиллРасширенный доступ4,4 тыс.Звезды репозитория

Скилл переписывает плотный и двусмысленный английский по правилам упрощенного технического языка ASD-STE100, чтобы текст не мог прочитать неправильно другой аге

СкиллМинимальный доступ6,4 тыс.Звезды репозитория

Коротко о README

README показывает пример переписывания, объясняет мотивацию (пост Карпатого про STE в октябре 2026), состав набора, главные правила, использование с агентом, команды проверки и пределы.

Бейдж для README

Исходный SKILL.md

---
name: simplified-technical-chinese
description: 用简明技术中文(STC)写或改写中文技术内容:操作步骤、安装部署、故障排查、接口和参数说明、技术概念解释、给人读的解释性回答。用户提到「简明技术中文」「STC」「受控中文」「像 ASD-STE100 那样写中文」「一词一义」时使用;用户要求把中文技术说明「写清楚」「别有歧义」时也可使用。不用于营销文案、叙事、法律原文和代码。
---

# 简明技术中文

目标:读者读一遍就不会读错。做法:限制用词,限制句式,一句一事。

完整规则见 [规范.md](规范.md),词表见 [词表.md](词表.md)。本文件只列最常用的部分。

## 模式

- 常规模式(默认):执行全部【必须】规则和词表的自动检查条目。【建议】规则只在明显时处理。
- 严格模式:用户说「严格」「全部规则」时,执行全部规则。

用户没有说明时用常规模式。

## 写之前先分类

- 操作句:告诉读者做什么。放在编号列表里,动词开头,不超过 30 字。
- 描述句:其他句子。不超过 40 字。

字数算法:每个汉字计 1,每个英文单词或数字串计 1,行内代码计 1,标点不计。

## 必须遵守的规则

词:

- 一个概念全文只用一个词。不换同义词。(1.1)
- 不用「进行」「加以」「作出」「予以」加动词。直接用动词。(1.4)
- 不用没有数值的程度词:「很」「非常」「较」「大量」「尽快」「及时」。写数值或条件。(1.5)
- 缩写首次出现写全称并括注,之后固定写法。(1.6)
- 不用黑话:「赋能」「抓手」「闭环」「拉通」「沉淀」「痛点」「对标」「打法」「拉齐」。(1.7)

句:

- 一句只说一件事。分号不能用来把两句并成一句。(2.2)
- 操作句用祈使句,不写「请」「您」「用户需要」「应该」。(2.3)
- 用主动句,写出执行者。「被」「由」「受到」是信号。(2.4)

Сообщить о проблеме