mcpField
C
chinese-style-guide

chinese-style-guide

github.com/rightcapitalhq文档处理120291 次安装11 周前更新
代码仓库

关于 chinese-style-guide

chinese-style-guide 是用于修正中文文档、邮件和消息格式的 Skill,面向需要统一中文排版的写作者。它强调只改格式、不改语义,并提供规则参考和格式检查脚本。

主要功能

  1. 01中英文及数字间距修正
  2. 02标点与括号格式统一
  3. 03数字、日期和电话格式化
  4. 04保留原意与作者语气
  5. 05提供格式检查脚本

适用场景

  1. 01校对中文文档排版
  2. 02统一中英文混排格式
  3. 03整理中文邮件和消息
  4. 04检查技术文档格式

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rightcapitalhq/chinese-style-guide --skill chinese-style-guide

安装后在 Claude Code 中输入/chinese-style-guide确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

examples/
before-after.md
references/
quick-reference.md
style-guide-full.md
scripts/
check_format.py

详细介绍

来自项目 README

中文写作排版风格指南 Skill

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

核心原则

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

触发场景

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

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

修正范围

应该修正
  • 中英文之间的空格
  • 全角/半角标点符号
  • 数字格式(千位分隔符等)
  • 日期时间格式
  • 电话号码格式
  • 货币格式
  • 引号类型
  • 括号类型(全角/半角)
不应修改
  • 文章的语义和表达
  • 用词选择(除非明显的错别字)
  • 句子结构
  • 段落组织

快速参考:关键规则

空格规则
场景规则正确示例
汉字与英文之间添加空格这是 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

修正工作流程

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

  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(英文部分)

评论

支持 Markdown