中文技术写作风格

让中文清楚好读的规则：标点、留白、术语和语气，而且不碰事实和代码。

Tech Doc Style Chinese · Fenng · MIT

安装

npx skills add https://github.com/Fenng/tech-doc-style-chinese

命令逐字摘自项目的说明文件，运行前请先读一遍。

需求： 为虚构应用「记账鸟」先不用 Skill 写一段带常见毛病的中文上手说明（全半角标点混用、中英文之间没有空格、术语不统一、空话），再按 Skill 规则改写。

它把一段挤在一起的话改成了短标题加编号步骤，条件放在动作前面，按钮名改用「」，中英文之间加空格，术语统一为一种写法，并删掉了「赋能」「极致体验」「非常强大」这类空话。检查脚本对改写稿没有报任何问题。

我们的看法： 和介绍说的一致。改写前后差别明显，每处改动都能在规则里找到出处，事实保留，没有编造。适合写中文操作手册和产品说明的人；不适合需要品牌语气的文案。

2026-11-02 由 AI Agent 跑了一次，版本 b119d01。没有真人评判，你跑出来的结果也会不同。

关于中文标点、留白、术语和语气的规则，简短而严格。它只改看得见的正文，不碰事实和代码，读一遍本身就有收获。

好的中文，标点和留白一马虎就显得不对，而 AI 恰恰常在这里马虎。

改正、收紧后的中文文字。

Node.js，用来运行安装命令。

中文文档要读起来像认真做过的时候，选它。

项目没有样例图片，也没有视觉成品可看。它面向技术和产品写作，文学性的文字要适当放宽。