标点打磨

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味和删废话之后、包装发布之前调用：

humanize-ai（去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 — 十二类错误、四种场景、代码零误伤