中文写作排版风格指南 Skill

本技能用于对中文文档、文章、邮件、消息等正式文本进行格式和排版修正。

核心原则

1. 只修正格式和排版：不改变作者的表达内容和语义
2. 保持原文风格：尊重作者的用词和语气
3. 遵循规范：严格按照《中文写作排版风格指南》执行

触发场景

当用户进行以下操作时应用此技能：

• 撰写或编辑中文文档
• 写中文邮件或消息
• 中英文混排内容的编辑
• 请求格式检查或排版修正

修正范围

应该修正

• 中英文之间的空格
• 全角/半角标点符号
• 数字格式（千位分隔符等）
• 日期时间格式
• 电话号码格式
• 货币格式
• 引号类型
• 括号类型（全角/半角）

不应修改

• 文章的语义和表达
• 用词选择（除非明显的错别字）
• 句子结构
• 段落组织

快速参考：关键规则

空格规则

标点符号

括号选择规则

• 括号内外都是英文：使用半角括号 ()
• 其他情况：使用全角括号 （）

正确示例：

RightCapital (a fintech company) 的手机应用（app）于近日发布。

数字规则

• 四位及以上数字：使用千位分隔符 3,000,000
• 不超过 10 的数字：推荐中文数字
• 10 及以上：使用阿拉伯数字
• “万””亿”可配合阿拉伯数字：300 万
• 其他中文单位只用汉字数字：三百

日期时间

• 中文日期：2020 年 3 月 31 日 或 2020-03-31
• 时间分隔使用半角冒号：9:05
• 年份使用 4 位数

电话号码

• 手机：139-1234-5678（3-4-4 分组）
• 座机：010 6123-4567 或 (010) 6123-4567
• 国际号码：+86 10 6123-4567

修正工作流程

执行格式修正时遵循以下步骤：

1. 识别文档类型：确定是纯中文还是中英文混排
2. 扫描格式问题：按以下顺序检查
   • 空格问题（中英文/中数字之间）
   • 标点符号问题
   • 数字格式问题
   • 日期时间格式
   • 其他排版问题
3. 逐项修正：保持修改的最小化原则
4. 复核：确保未改变原文语义

常见错误修正示例

空格问题

- 这是English文本
+ 这是 English 文本

- 共100个
+ 共 100 个

- 在《 Book 》中
+ 在《Book》中

标点问题

- 请问,这是什么?
+ 请问，这是什么？

- 他说:"好的"
+ 他说："好的"

- 北京-上海高铁
+ 北京—上海高铁

数字问题

- 3000000 行代码
+ 3,000,000 行代码

- 03 月 31 日
+ 3 月 31 日

英文部分规则要点

当文档包含英文段落时，英文部分遵循：

• 拼写：使用美式英语（color, center, canceled）
• 标点：使用英文标点，撇号用 '（U+2019），引号用 ""
• 牛津逗号：在三个及以上并列词组中使用
• 破折号：使用 em dash —，左右不留空格
• 区间：使用 en dash –（2018–2019）

代码格式规则

在技术文档中：

• 变量名、函数名、类名格式化为代码：`$id`
• 字面量格式化为代码：`null`、`255`
• 数据库字段类型格式化为代码：`TINYINT UNSIGNED`

附加资源

自动检查脚本

使用 Python 脚本自动检查格式问题：

python .claude/skills/chinese-style-guide/scripts/check_format.py <file.md>

# 选项
--skip-tables     跳过 Markdown 表格行
--warnings-only   只显示警告，不返回错误退出码

脚本检查项：

1. 中英文之间缺少空格
2. 中文与数字之间缺少空格
3. 半角标点在中文句子中
4. 直引号替代弯引号
5. 省略号 ... 替代 ……
6. 破折号 -- 替代 ——
7. 时间使用全角冒号
8. 书名号/括号内多余空格
9. 大数字缺少千位分隔符

参考文件

详细规则和完整示例请查阅：

• references/style-guide-full.md – 完整的风格指南规则
• references/quick-reference.md – 快速参考卡片

示例文件

• examples/before-after.md – 修正前后对比示例

重要提醒

1. 尊重原意：格式修正不应改变作者想表达的内容
2. 最小修改：只修正明确违反规范的地方
3. 保持一致：同一文档内保持格式一致性
4. 解释修改：如有重大格式调整，向用户说明原因

标准参考

本技能基于以下标准：

• GB/T 15834 标点符号用法
• GB/T 15835 出版物上数字用法
• GB 3100/3101/3102 量和单位
• Chicago Manual of Style（英文部分）