stc

STC (Simplified Technical Chinese) · 简明技术性中文

中文 | English

介绍视频 · 环境要求 · 快速开始 · 两种用法 · 更新版本

STC 简明技术性中文是给 AI 用的中文写作规范。项目提供写作规则、词表和 agent 工具。默认表达自然、简短、准确，同一个意思只用一个词。

名字里的 Simplified 指写法上的简化，不是简体字。

English summary. STC (Simplified Technical Chinese) is a Chinese writing specification for AI. It is for people and for AI agents. It has writing rules, a dictionary, and tools that let agents write and check Chinese text. "Simplified" refers to simplified writing, not to Simplified Chinese characters. STC follows the approach of ASD-STE100 Simplified Technical English. STC is an independent work and contains no text from ASD-STE100. Full English README: README.en.md.

介绍视频

在 YouTube 观看

环境要求

• 单独 skill 的生成、改写和语义审阅由现有 Agent 执行。规则和词表是纯文本，可直接读取。
• CLI 和随 skill 提供的机器检查需要 Node.js 18 以上版本。安装 CLI 或运行技能安装器需要 npm；直接下载 skill 包可以手动安装。
• 自动安装和默认配置需要 Agent 能写入选定目录。机器检查没有第三方运行时依赖，安装后可离线运行。

快速开始

同一个仓库提供两条安装路径。CLI 适合需要终端检查和 CI 的用户；skill 适合让 Agent 直接生成、改写和审阅中文。

npm 安装 CLI

npm install -g @daimonia/stc@latest
stc init

init 安装 skill 和按需入口。确认默认使用后，运行 stc init --defaults。检查文件用 stc check <文件>。也可以用 npx --yes @daimonia/stc@latest init 临时运行。

给 Agent 粘贴的安装指令：

请在当前项目安装 STC：https://github.com/daimonia-ai/STC-Simplified-Technical-Chinese。使用 npm 安装 @daimonia/stc@latest，再运行 stc init。装好后读取 ONBOARDING.md，建议设为默认中文输出规则，等我确认；也可以由我指定材料体验一次审阅。

单独安装 skill

使用技能安装器，按提示选择 Agent 和项目范围：

npx skills add daimonia-ai/STC-Simplified-Technical-Chinese --skill stc

可用 --agent codex、--agent claude-code 或 --agent hermes-agent 指定入口，--global 安装到个人技能目录。技能安装器文档说明其他选项。

也可以从 GitHub Releases 下载 stc-skill-0.2.0.zip，将包里的 stc/ 放到 Agent 的技能目录。

给 Agent 粘贴的安装指令：

请单独安装 STC skill：https://github.com/daimonia-ai/STC-Simplified-Technical-Chinese。为当前 Agent 选择合适的技能目录。装好后读取 ONBOARDING.md，建议设为默认中文输出规则，等我确认；审阅材料由我指定或授权挑选。

skill 包含规则、词表、引导与检查脚本。只装 skill 时，Agent 已能使用内置的自然、简短表达原则。运行机器检查可用 node <skill目录>/tools/cli.mjs check <文件>。

默认表达

每次使用 STC，都会同时执行这套表达原则：

• 用自然语序和完整句子，直接给出答案或结果。
• 删除客套、重复、空话和读者不需要的解释。
• 保留事实、数字、名称、否定词、权限和真实不确定性。
• 按任务需要展开，完整文稿和详细解释必须满足请求。
• 成品从采用的结果写起，制作和复核记录放在内部。

自然表达和精简方法已内置于 skill 与默认配置。具体规则见 G14、G15、G20、G21、G22 和场景规则。

两种用法

可以只用一种，也可以两种一起用。一起用时，默认输出规则让 agent 一开始就按 STC 写，审阅时再找出漏掉的问题。

用法一：设成 agent 的默认输出规则

把这段话直接贴给 agent：

请在当前项目安装或更新 STC 简明技术性中文：https://github.com/daimonia-ai/STC-Simplified-Technical-Chinese，并设为默认中文输出规则，让表达自然、简短、准确。保留其他项目配置，完成后说明生效范围。

这段指令已授权设置默认规则。生效后可以直接提出写作任务，例如：

请根据以下要点写一份项目进展说明：【粘贴要点】

手动配置时，按以下步骤操作：

在项目里运行 stc init，装好 skill、规则和词表。首次安装登记按需使用入口。

用户确认后，运行 stc init --defaults，将核心规则写入项目上下文。之后 agent 写中文时，先判断场景，再读取规则。

安装后的引导见 Onboarding for Agents。已启用默认规则的项目再次运行 init 时，会保留该状态。

单独安装 skill 时，按 ONBOARDING.md 用实际安装路径启用默认规则。只有安装授权时，先等待用户选择；上面的默认使用指令已经包含启用授权。

用法二：让 agent 审阅并优化已有内容

安装后，把这段话和待处理文字一起贴给 agent：

请按 STC 审阅并优化以下中文，保留事实、数字、名称和原意，给出改写稿并简要说明主要改动：【粘贴文字】

审阅项目文件时，可以这样说：

请按 STC 审阅【文件路径】，列出主要问题和具体改法，保留源文件。

需要 agent 挑选首次体验的材料时，可以直接授权：

请从当前项目挑选一份中文文档，说明选择理由，再按 STC 做一次只读审阅并给出具体改法。

此用法可按需调用，无须启用默认输出规则。

对 agent 说“按 STC 审一下这份文档”。agent 会用 STC 的 skill 审阅用户指定或授权挑选的材料，给出问题、原因和改法。用户要求修改时，agent 再按授权修改。人也可以自己运行 stc check <文件或目录>。这条命令找出机器能判断的问题，每条问题带规则编号。发现错误时返回退出码 1，可以放进 CI。

机器判断不了的规则（比如事实有没有出处），由 agent 按 skill 审查，或由人审稿。不装任何东西也可以直接读 rules/ 和 dictionary/，用来审稿、培训或自己写工具。

Anti-Echo 交付检查

Anti-Echo 要求每句话服务当前读者，覆盖多余排除、制作说明和结尾自证。必要的价格范围、权限限制和安全提示必须保留。

stc check 文档.md --profile for-document --anti-echo

命令发现未复核的 G20 疑点时返回 1。Agent 必须改写，或结合上下文记录具体保留理由；语义复核还须检查规则未匹配到的内容。复核文件与 CI 用法。

Codex 和 Claude Code 可按需配置 Stop hook，对回复中的疑点发起一次补审。

更新版本

按安装方式更新。

CLI 安装

先更新 npm 命令行包，再刷新项目里的 skill 和规则。

把这段话贴给 agent：

请把 STC 的 npm 命令行工具更新到最新版，并刷新当前项目实际引用的 STC skill 和规则，保留已启用的默认规则、其他项目配置和项目术语，最后核对两处版本。

手动更新时，在已安装 STC 的项目根目录运行：

npm install -g @daimonia/stc@latest
stc --version
stc init
node .claude/skills/stc/tools/cli.mjs --version

npm install 更新本机 CLI。stc init 将新版文件复制到当前项目，并保留已有的默认设置。两条版本命令的结果须一致。

• 每个已安装 STC 的项目都需要运行一次 stc init。
• 安装时用了 --dir，更新时须使用相同目录。第二条版本命令也须改为该目录。
• --dir 只改变 skill 的位置；项目配置仍写在当前目录。

临时运行最新版并刷新当前项目，也可以用：

npx --yes @daimonia/stc@latest init

单独 skill 安装

用技能安装器安装的项目 skill，在项目根目录运行：

npx skills update stc

全局 skill 使用 npx skills update stc --global。下载包装的 skill，下载新包后替换原技能目录。更新时保留项目术语和现有默认配置。

给 Agent 粘贴的更新指令：

请按原来的安装方式更新 STC skill，核对实际技能目录和版本，保留已有默认规则、项目术语及其他配置。使用新的 ONBOARDING.md 核对启用状态。

skill 的检查脚本可用 node <skill目录>/tools/cli.mjs --version 核对版本。技能与 npm 从同一份源文件发布。

为什么做

大模型写中文，常见的问题是写得多、写法散。同一个东西换着叫法，程度词代替数字。“进行优化”“赋能”“闭环”这类词把句子撑长，代词也指代不清。还常加读者不需要的说明，比如“西红柿炒鸡蛋（没有东坡肉）”。读的人要花时间猜，agent 之间传话也会走样。

英文有 ASD-STE100：53 条写作规则，加一本约 900 个许可词的词典，每个词只有一个意思、一个词性。ASD-STE100 在 1986 年首次发布，用于航空维修手册，现行版本是 2025 年发布的第 9 版。中文输出也需要这样的表达规范。

STC 给中文补上这一套，从一开始就按 AI agent 能直接使用来设计。

对谁有用

日常使用 AI 聊天、写文档的人可以用 STC。回复少些废话，文档把意思讲清楚。

也可用于这些专业工作：

• 开发 AI 产品、编写 agent 的团队：系统提示词、规则文件、agent 的输出
• 写产品界面文字的人：按钮、提示、报错、说明
• 写技术文档、报告的人
• 需要一份中文写作标准、并且要求机器能检查的团队

组成

四个场景

写之前先判断在写哪类文字，再用“通用规则 + 对应场景的规则”。

仓库结构

ONBOARDING.md   安装后建议默认使用，提供一次文档审阅体验
SKILL.md        skill 入口：判断场景，读规则和词表，写、改写、审查
rules/          规则：通用规则与四个场景
dictionary/     词表：推荐词、不推荐写法、项目术语表模板
snippets/       贴进 AGENTS.md / CLAUDE.md 的核心规则
tools/          命令行工具 stc：init 安装，check 检查
evals/          skill 的测试任务

词表怎么定

词条按真实的 AI 中文输出中的出现次数排定先后。例句使用通用名称，不含可识别的个人或企业信息。

和 ASD-STE100 的关系

STC 参考 ASD-STE100 的结构：写作规则、词义明确的词表、允许项目自建术语表。规则和词条由 STC 独立编写，不翻译、不摘抄 ASD-STE100 的正文、规则原文或词典条目。针对大模型输出中文的常见问题，STC 补充了表达规则和词表。例如 G20 要求删掉读者不需要的排除说明。

ASD-STE100 的版权归 ASD（Aerospace, Security and Defence Industries Association of Europe）所有，“ASD-STE100 Simplified Technical English”是 ASD 的欧盟注册商标。STC 不是 ASD-STE100 的官方中文版本，本仓库不分发 ASD-STE100 的文本。需要原文请到官网免费申请：https://www.asd-ste100.org/

英文写作可以直接使用 ASD-STE100。

其他参考

• GB/T 1.1—2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》：条款的助动词
• GB/T 15834—2011《标点符号用法》
• GB/T 15835—2011《出版物上数字用法》

同类项目

• lemonhall/asd-ste100-skill-zh：中文改写 skill 与检查脚本
• RinStel/cste-zh：中文写作 skill

STC 和这两个项目的差别：STC 以词表为核心，并按 for chat、for document、for web dev、for instruction writing 四个场景分别给出规则。

许可

• 规则与词表：CC BY 4.0，可以复制、修改、商用，必须注明出处
• 代码（命令行工具、skill、配置示例）：MIT

维护

由 代梦智能（Daimonia） 发起并维护。STC 是开源项目，欢迎一起共建：提交词条、规则和 issue 都可以。