chinese-style-guide
Installation
SKILL.md
中文写作排版风格指南 Skill
本技能用于对中文文档、文章、邮件、消息等正式文本进行格式和排版修正。
核心原则
- 只修正格式和排版:不改变作者的表达内容和语义
- 保持原文风格:尊重作者的用词和语气
- 遵循规范:严格按照《中文写作排版风格指南》执行
触发场景
当用户进行以下操作时应用此技能:
- 撰写或编辑中文文档
- 写中文邮件或消息
- 中英文混排内容的编辑
- 请求格式检查或排版修正
修正范围
应该修正
- 中英文之间的空格
- 全角/半角标点符号
- 数字格式(千位分隔符等)
- 日期时间格式
- 电话号码格式
- 货币格式
- 引号类型
- 括号类型(全角/半角)
不应修改
- 文章的语义和表达
- 用词选择(除非明显的错别字)
- 句子结构
- 段落组织
快速参考:关键规则
空格规则
| 场景 | 规则 | 正确示例 |
|---|---|---|
| 汉字与英文之间 | 添加空格 | 这是 English 文本 |
| 汉字与数字之间 | 添加空格 | 共 100 个 |
| 汉字标点与英文之间 | 不加空格 | 在《Book》中 |
| 汉字与半角标点之间 | 不加空格 | 100 美元/月 |
| 格式化内容与汉字之间 | 不加空格 | 这是**重点**内容 |
标点符号
| 标点 | 中文句子使用 | Unicode |
|---|---|---|
| 句号 | 。 | U+3002 |
| 逗号 | , | U+FF0C |
| 问号 | ? | U+FF1F |
| 感叹号 | ! | U+FF01 |
| 冒号 | : | U+FF1A |
| 分号 | ; | U+FF1B |
| 引号 | "" | U+201C/U+201D |
| 书名号 | 《》 | U+300A/U+300B |
| 括号 | () | U+FF08/U+FF09 |
| 破折号 | —— | 两个 U+2014 |
| 省略号 | …… | 两个 U+2026 |
括号选择规则
- 括号内外都是英文:使用半角括号
() - 其他情况:使用全角括号
()
正确示例:
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
修正工作流程
执行格式修正时遵循以下步骤:
- 识别文档类型:确定是纯中文还是中英文混排
- 扫描格式问题:按以下顺序检查
- 空格问题(中英文/中数字之间)
- 标点符号问题
- 数字格式问题
- 日期时间格式
- 其他排版问题
- 逐项修正:保持修改的最小化原则
- 复核:确保未改变原文语义
常见错误修正示例
空格问题
- 这是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 只显示警告,不返回错误退出码
脚本检查项:
- 中英文之间缺少空格
- 中文与数字之间缺少空格
- 半角标点在中文句子中
- 直引号替代弯引号
- 省略号
...替代…… - 破折号
--替代—— - 时间使用全角冒号
- 书名号/括号内多余空格
- 大数字缺少千位分隔符
参考文件
详细规则和完整示例请查阅:
references/style-guide-full.md- 完整的风格指南规则references/quick-reference.md- 快速参考卡片
示例文件
examples/before-after.md- 修正前后对比示例
重要提醒
- 尊重原意:格式修正不应改变作者想表达的内容
- 最小修改:只修正明确违反规范的地方
- 保持一致:同一文档内保持格式一致性
- 解释修改:如有重大格式调整,向用户说明原因
标准参考
本技能基于以下标准:
- GB/T 15834 标点符号用法
- GB/T 15835 出版物上数字用法
- GB 3100/3101/3102 量和单位
- Chicago Manual of Style(英文部分)