mzopedia

Simplified Technical Chinese — Development skill for Claude Code

Development community

简明技术中文 / Simplified Technical Chinese: a controlled language for Chinese technical writing, modelled on ASD-STE100. 40 rules, a one-meaning-one-word vocabulary, a zero-dependency checker, and an agent.

How to install Simplified Technical Chinese

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mzopedia/simplified-technical-chinese and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Simplified Technical Chinese does

Alternatives in Development

Codex Claude Academic Skills — 本仓库包含三个面向学术科研人员的Skills，覆盖从文献阅读、论文写作到科学计算的完整研究工作流 3.2k ★
Asd Ste100 Skill — ASD-STE100 Simplified Technical English rules, repurposed as a Claude Code skill for rewriting ambiguous agent 1.5k ★
Sandbox-agent (Rivet) — Run Claude Code and other coding agents in sandboxes controlled over HTTP 1.2k ★

README

简明技术中文

[![tests](https://github.com/mzopedia/simplified-technical-chinese/actions/workflows/test.yml/badge.svg)](https://github.com/mzopedia/simplified-technical-chinese/actions/workflows/test.yml) [English](README.en.md)

Simplified Technical Chinese（STC）。一套受控的中文写法，用于技术说明、操作步骤、接口文档和 AI 的解释性回答。目标是读者读一遍就不会读错。

它借鉴 [ASD-STE100](https://www.asd-ste100.org/)（Simplified Technical English）的方法：限制用词，限制句式，一句一事。它不是 ASD-STE100 的译本，与 ASD 没有关系。

**English.** STC is a controlled language for Chinese technical writing, modelled on the method of ASD-STE100: a numbered rule set, a controlled vocabulary (one meaning, one word), and a zero-dependency checker. It is not a translation of STE and is not affiliated with ASD. The rules are written for the ambiguities of Chinese: nominalised verbs (进行 + verb), long pre-nominal modifiers, the inclusive/exclusive ambiguity of 以上/以下, permission vs ability of 可以, and object restrictions on 打开/关闭/启动.

一个例子

节选自 [examples/before.md](examples/before.md)：

改写前：用户首先需要登陆到目标服务器，然后切换到 /opt 目录并且创建一个用于存放采集器配置文件以及运行时产生的临时数据的工作目录。

节选自 [examples/after.md](examples/after.md)：

登录目标服务器。
切换到 /opt 目录。
创建工作目录 /opt/collector。工作目录存放配置文件和临时数据。

检查脚本对改写前那一句的输出：

examples/before.md:11: [1.1][必须] 「登陆」改用「登录」（进入登录状态）
examples/before.md:11: [2.1][必须] 操作句 56 字，不超过 25 字
examples/before.md:11: [4.1][必须] 禁用词「然后」，改用：拆成编号步骤
examples/before.md:11: [4.1][必须] 禁用词「并且」，改用：拆句；只有真正同时发生时用「同时」

整篇改写前的文档有 40 多条【必须】级别的发现，改写后是 0 条。

为什么做这个

2026 年 10 月，Andrej Karpathy [发帖](https://x.com/karpathy/status/2105819303471976479)说，让大模型用 ASD-STE100 来解释东西，读起来清楚得多。ASD-STE100 是航空维修手册用的受控英语：53 条写作规则，加一本约 900 个词的词典，每个词只有一个意思。

中文没有对应的东西。已有的中文技术写作规范管排版、标点和文档结构，见[和现有项目的区别](#和现有项目的区别)。它们都没有做 STE 的核心：编号规则、受控词表、可以自动检查的句法约束。本项目补这一块。

内容

文件	内容
规范.md	写作规则。6 节，40 条，每条带「不批准 / 批准」例句。规则分【必须】和【建议】两级
词表.md	受控词表。禁用词及替换、选词表（一个意义一个词）、一词一义限定。约 150 条
tools/check.py	检查脚