AI 写中文技术文档最大的问题不是写不出来，而是写出来不像技术文档：宣传味太重、空话太多、中英文混排别扭、状态词直译生硬。Chinese Tech Doc Style 就是针对这个问题的中文技术写作规范，它不是一款桌面软件，而是一份交给 AI 编程助手执行的 Skill 文件，目标是让 AI 稳定地写出克制、准确、易读的中文技术内容。
这份规范面向的场景很具体：中文技术文档、产品文案与界面文案。它不追求把所有文章套进同一个模板，而是针对高频写作毛病给出可执行的规则，适合长期维护文档、产品页面、帮助中心或开发者文档的团队直接采用，也可以作为团队内部文案标准的参考。
中文技术写作先治四个毛病
第一个毛病是空泛与宣传化。“打造行业领先体验”“全面提升用户效率”“赋能企业数字化转型”这类句子放在营销页无妨，放在技术文档里等于没说信息。规范要求回归事实：功能是什么、解决什么问题、有什么限制、怎么使用，四点说清即可。
第二个毛病是中英文与数字混排。技术文档里中文、英文术语、数字版本、代码名称经常同段出现，空格与数字写法处理不好，读起来就费劲。规范把混排可读性列为重点，统一了中文与英文、数字之间的排版处理。
第三个毛病是英文状态词机械直译。Success、Invalid、Bad Request 这类词如果直译成中文，常常不符合中文技术语境，在 API 文档、错误码说明和系统提示里尤其误事。规范明确要求避免机械直译，保留符合语境的表达。
第四个毛病是互联网黑话。“赋能”“抓手”“闭环”“打通”在商业宣传里常见，但在技术文档里会拉低信息密度。规范的态度是：能用具体描述说清的，就不用黑话代替。
覆盖哪些文档类型：从首页到按钮文案
这份 Skill 覆盖的范围比一般写作模板宽：文档首页、落地页与首屏文案；接口文档、参数说明、错误码说明、更新日志；产品能力介绍、解决方案页、能力说明页；以及界面文案、按钮文案、导航标签、提示信息。也就是说，开发者文档和产品团队的用户界面文字，都在它的管辖内。
以技术项目首页为例，很多首页的问题是“介绍了许多，但用户不知道重点”。按规范调整后，项目定位、能力描述、功能介绍、使用说明会更接近技术产品说明，而不是营销宣传页。
核心规则：事实、引号与语气三条线
最重要的一条是保留事实、限制与确定程度。原文写“支持部分场景”，就不能改写成“全面支持所有场景”，因为后者改变了原始信息。改写可以换表达，不能升级承诺。
其次是中文引号统一使用直角引号「」。这是细节规范，但长期维护时一致性就是靠这类细节攒出来的。
再次是语气控制：默认避免不必要的直接称呼，同时允许项目按自身情况覆盖语气，避免所有项目文档读起来一个腔调。
对于操作、排查与运维文档，规范还提供受控中文技术写作方法：步骤清晰、条件明确、避免歧义。这类文档最怕“一句话两种理解”，规则的价值正在于此。
明确不适用范围：机器标识不动
规范也划了边界，避免误用：代码字面量、JSON 键名、URL、API 路径、数据库字段名等机器可读标识符不在改写范围内。它优化的是自然语言表达，不是改程序里的固定标识。这一点写在前面，能省去很多“AI 把字段名也改了”的返工。
怎么用：把它交给支持 Skill 的 AI 助手
使用方式与普通软件不同：它不提供独立运行的桌面程序，也不需要启动服务，而是作为 AI Agent 的行为规范文件，让支持 Skill 机制的工具在生成或修改中文技术文档时遵循预设规则。主要面向 Codex、Claude Code 以及其他支持 Skill 机制的 AI 编程助手，使用前先确认自己的助手支持加载 Skill 文件。
在 Codex 中使用时，把项目 Skill 文件放入对应的 Skill 目录，让 Codex 在处理中文技术文档任务时自动读取规则，之后直接下达任务即可，例如“按照 Chinese Tech Doc Style 规范优化下面这段 API 文档”。在 Claude Code 中同样是把项目目录放入可识别的 Skill 路径，确认 SKILL.md 存在后，再调用中文文档优化任务。项目 README 明确说明，SKILL.md 是正式技能入口。
四个场景：README、接口文档、产品说明、界面文案
场景一是优化开源项目 README。很多 README 的问题是介绍过长、功能描述像宣传稿、安装步骤混乱、使用限制不明确。按规范调整项目定位、功能介绍、安装说明与使用方式后，结构会更接近专业开源项目。
场景二是编写 API 文档。一个参数描述错误就可能导致开发者误解。规范要求保留事实、明确条件、避免模糊表达，例如把“接口可以快速返回用户信息”改成“调用该接口后返回用户基本信息，包括用户 ID、名称和创建时间”，对象、范围、结果都交代清楚。
场景三是整理产品功能说明。功能介绍页、帮助中心、用户指南都容易写成营销稿，降低营销化表达比例后，产品说明会更清晰。
场景四是优化界面文案。按钮、导航标签、提示信息都要帮用户完成操作，而不是制造口号，例如把“立即开启极致体验”改成“开始使用”。
适合谁：维护文档的人比写单篇文章的人更需要它
如果你只是偶尔让 AI 写一段中文介绍，这份规范的感知不会很强；但如果你长期维护 GitHub README、开发者文档、产品说明或 AI Agent 项目，需要反复提醒 AI“不要营销化、不要夸大、不要改变事实、不要随意替换技术术语”，把它固化成 Skill 就能省去大量重复提醒。它的价值不在于让 AI 写更多文字，而在于让 AI 写出更像专业技术团队产出的中文文档。
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
