openakita%2fskills%40chinese-writing（openakita%2fskills%40 中文写作）

中文写作规范

系统化的中文写作规范技能，确保所有中文输出遵循统一的语言风格、排版规则和表达习惯。适用于技术文档、博客文章、UI 文本、错误提示等多种写作场景。

适用场景

• 撰写中文技术文档和 README
• 编写产品 UI 文案（按钮、提示、说明文字）
• 撰写博客文章和教程
• 生成错误信息和异常提示
• 翻译英文内容为规范中文
• 校对和修正已有中文文本
• 编写产品更新日志（Changelog）
• 撰写邮件和通知文案

核心语调

所有中文输出应遵循以下三个语调特征：

禁止的语调：

• 过度热情（堆叠感叹号、滥用 emoji）
• 冷漠生硬（不允许、错误、失败）
• 模糊笼统（某些情况下、可能会）
• 过度谦卑（不好意思打扰了）

盘古之白：中英文间距规则

中文（CJK 字符）与半角字符（ASCII 字母、数字）之间必须加一个空格，这被称为「盘古之白」。

空格规则详表

不加空格的情况

自动检查要点

生成中文文本后，自检以下模式：

1. [汉字][A-Za-z] → 之间需要加空格
2. [A-Za-z][汉字] → 之间需要加空格
3. [汉字][0-9] → 之间需要加空格
4. [0-9][汉字] → 之间需要加空格
5. [汉字] [，。！？；：] → 全角标点前不要有空格

标点符号规范

全角与半角

中文语境下使用全角标点，英文/代码语境下使用半角标点。

引号使用规范

优先使用直角引号，嵌套时交替使用：

第一层：「引用内容」
第二层：「他说『这是重点』」
第三层：「他说『她提到「那个方案」很好』」

特殊场景：

• UI 元素名称使用直角引号：点击「确定」按钮
• 文件名/路径使用反引号：` 打开 config.json 文件 `
• 强调词汇可用粗体：这是一个**重要**功能

标点禁则

段落结构规范

段落长度

• 每段控制在 3-5 行（约 100-200 字）
• 超过 5 行的段落考虑拆分
• 单句不成段（除非是强调句）

段落组织原则

1. 一段一主题：每段围绕一个核心观点展开
2. 首句概括：段落第一句点明要旨
3. 逻辑递进：段落间有清晰的逻辑关系
4. 过渡自然：使用连接词衔接段落

常用过渡词：

列表使用规范

• 3 项以上的并列内容使用列表
• 有序列表用于步骤或优先级
• 无序列表用于并列项目
• 列表项句末不加句号（除非是完整句子）
• 列表项保持结构一致（都用动词开头，或都用名词开头）

主动语态优先

中文写作优先使用主动语态，被动语态仅在主语不重要或无法确定时使用。

场景化写作指南

场景一：博客文章

风格要求：

• 语调亲切但不随意
• 可以使用第一人称（我、我们）
• 适当使用口语化表达增加可读性
• 技术名词保留英文原文

结构模板：

标题（明确+吸引）
引言（为什么写这篇/背景）
正文章节（3-5 个，有小标题）
总结（核心要点回顾）
延伸阅读/参考链接

示例对比：

差 ❌：

本文将会对 React 18 的并发特性进行一个详细的介绍和分析，
希望能够对读者有所帮助。

好 ✅：

React 18 引入了并发渲染，这是自 Fiber 架构以来最大的变化。
本文通过实际案例，带你理解它的工作原理和应用场景。

场景二：错误提示信息

核心原则： 告诉用户发生了什么 + 为什么 + 怎么解决

格式模板：

[现象描述]。[原因说明（可选）]。[解决建议]。

示例对比：

错误信息禁忌：

• 不使用技术术语（NullPointerException）
• 不使用全大写（ERROR）
• 不使用叹号（失败！）
• 不使用消极否定（不能→暂时无法）
• 不归咎用户（你的操作有误→输入格式不匹配）

场景三：UI 文案

核心原则： 简短、明确、可操作

按钮文案：

提示文案：

文案长度限制：

场景四：技术文档

风格要求：

• 使用第三人称或无主语句（配置完成后，重启服务）
• 保持客观中立的语调
• 所有技术名词首次出现时给出中文翻译
• 代码和命令使用反引号包裹

术语处理：

文档结构：

# 标题
> 一句话描述功能

## 概述
简要说明用途和适用场景

## 前置要求
- 环境要求
- 依赖项

## 快速开始
最小可用示例

## 详细配置
完整参数说明

## 常见问题
FAQ

## 参考
相关链接

数字和单位规范

常见错误自查清单

生成中文内容后，按以下清单逐项检查：

• 中英文之间有空格（盘古之白）
• 中文与数字之间有空格
• 使用全角标点（中文语境下）
• 引号使用直角引号「」
• 没有连续感叹号或问号
• 段落长度在 3-5 行以内
• 使用主动语态
• 列表项结构一致
• 错误提示包含解决建议
• 技术名词首次出现有中文注释

输出示例

输入

Write an error message when the user's upload exceeds the file size limit.

输出

上传失败：文件大小为 25 MB，超过了 10 MB 的限制。

请压缩文件或拆分为多个小文件后重新上传。支持的格式：JPG、PNG、PDF。

分析

• ✅ 盘古之白：25 MB、10 MB
• ✅ 全角标点：：、。
• ✅ 主动语态
• ✅ 包含现象+原因+解决方案
• ✅ 具体数值（25 MB → 10 MB）