punct-polish

【标点打磨】AI写中文最常见的毛病就是标点:半角逗号、缺少中西空格、直引号、破折号滥用……这个技能一次性解决。覆盖中文散文、技术文档、中英混排、社交媒体四种场景,代码和URL完全不动,还具备英文标点校对能力。 触发:检查标点、修正标点、标点有问题、标点规范、半角改全角、中西空格、标点符号检查、punctuation、fix punctuation。 Not for:纯英文文本校对(→ 英文编辑工具

SKILL.md

GitHub

标点打磨

AI写中文,标点是最常见的毛病:半角逗号、缺少中西空格、直引号、破折号滥用……一次性解决。


AI最常犯的标点错误

按频率排序:

  1. 半角逗号 → 该用,的地方写了, — 极高频率
  2. 半角句号 → 该用。的地方写了. — 极高频率
  3. 缺少中西空格 → 使用React构建 应该是 使用 React 构建 — 高频率
  4. 直引号 → "你好" 应该是 「你好」(非代码) — 高频率
  5. 半角括号 → 见下图(图1) 应该是 见下图(图1) — 高频率
  6. 破折号滥用 → ——即 应该是 ,即 或直接删除 — 中等
  7. 省略号不规范 → .... 或 。。。 应该是 …… — 中等
  8. 顿号误用 → 苹果,香蕉 应该是 苹果、香蕉 — 中等
  9. 感叹号连用 → 太棒了!!! 应该是 太棒了! — 中等
  10. 多余中西空格 → 这 是 中 文 应该是 这是中文 — 低
  11. 英文标点混入中文 → Hello, world(中文语境) — 低
  12. 中文标点混入英文 → This is good。 — 低

其中前5项全自动修正,后7项根据上下文判断后修正或标记建议人工复核。


四种场景的标点规则

中文散文(公众号/博客/随笔)

全角标点强制使用:,。?!:;()「」『」『。破折号禁用,用逗号或句号替代。省略号用六个点……。顿号分隔中文并列短词。感叹号全文不超过3处,禁止连用。

技术文档(API/手册/Runbook)

中文和英文/数字之间加空格:使用 React 构建、调用 API 接口。代码围栏内的标点完全不动。行内代码的标点不动。URL不动。数字不动:1,000、3.14、12:30。标题层级#→##→###不超过三级。

中英混排(双语发布/国际化)

中文块与英文块之间加空格。中文括号内嵌英文时,括号用全角,内部英文标点用半角。英文块内嵌中文时,英文标点用半角,内部中文标点用全角。

术语一致性:首次出现保留英文+中文注解,后续统一用中文。行业通用缩写(SFT/RL/MoE)全程保留。

有稳定中文对译的英文词直接换成中文:context→上下文、state→状态、cache→缓存、claim→断言、runtime→运行时、contract→契约。

社交媒体(小红书/即刻/推特)

适度灵活:允许适度使用emoji(每段不超过2个),允许适度使用感叹号(表达情绪),允许使用---分隔线。

但仍有底线:中文不能用半角标点,中文英文间仍需空格,不能连续3个以上感叹号。


英文标点校对

英文标点的自动修正:

  • 逗号后空格:a,b → a, b
  • 句号后空格:end.Start → end. Start
  • 引号方向:直引号"→弯引号" '(非代码)
  • 破折号:---→— --→–
  • 省略号:...→…
  • 首字母大写:句首单词
  • 连续空格合并

英文AI词汇替换:delve→examine、leverage→use、utilize→use、robust→strong、streamline→simplify、harness→use、navigate→handle、unpack→explain、paradigm→system、synergy→combination、tapestry→mix、landscape→situation、game-changer→significant、moving forward→next。


代码/机器可读内容保护

以下区域标点100%不动:

  • 代码围栏 ``` 和行内代码
  • URL、邮箱、文件路径
  • 数字:千分位1,000、小数3.14、时间12:30
  • HTML/XML标签 <div>
  • 命令行参数 --flag
  • JSON键名 "key": "value"

执行流程

先识别场景,再标记保护区域,然后扫描检测,最后分层修正。

  1. 场景识别:含代码块/URL/参数→技术文档;中英混排>30%→双语;含@/#/emoji→社交媒体;默认→中文散文
  2. 保护标记:标记代码围栏、行内代码、URL、邮箱、数字、英文缩写
  3. 检测扫描:快速扫描半角标点和中西空格→深度扫描破折号/省略号/感叹号→上下文判断顿号和引号
  4. 分层修正:自动修正80%(半角→全角、空格补全)→建议修正15%(顿号、引号方向)→人工复核5%(语义模糊项)

两种输出模式:dry-run只给报告,执行模式输出修正后文本+改动清单。


与其他技能的协作

在去AI味和删废话之后、包装发布之前调用:

plainspoken-writing(去AI味)→ editor-revisor(删废话)→ punct-polish(标点打磨)→ packaging-workshop(包装发布)

量化指标

  • 半角标点修正率 ≥99%
  • 中西空格补全率 ≥95%
  • 代码保护准确率 100%(零容忍)
  • 误报率 ≤2%
  • 语义模糊项标记率 ≥90%

输出格式

【标点检测报告】

场景:{中文散文/技术文档/中英混排/社交媒体}
保护:{代码围栏N处 / URLN处 / 数字N处 / 行内代码N处}

【自动修正】(N处)
- 「原文」→ 「修正后」— 原因

【建议修正】(N处)
- 「原文」→ 「建议修正」— 需要判断:{原因}

【人工复核】(N处)
- 「原文」— 模糊原因:{需要人工判断的内容}

【统计】
- 自动修正:N处 | 建议修正:N处 | 人工复核:N处 | 保护未动:N处

不要这么做

  • 修改代码围栏内的任何标点
  • 修改URL/邮箱/路径内的标点
  • 修改数字(千分位、小数、时间)内的标点
  • 在技术文档中使用广告文案的标点灵活性
  • 在社交媒体中强制禁用所有emoji
  • 将中文标点规则强加于纯英文文本

punct-polish v1.1.0 — 十二类错误、四种场景、代码零误伤