Punct Polish

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

# 标点打磨

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