Punct Master

---
name: punct-master
version: "1.0.0"
description: |
  【标点综合治理】AI标点错误全谱系治理，中文为主英文为辅。12类错误检测+自动修正，四类场景（散文/技术文档/双语/社交）差异化规则，代码/URL/机器可读内容100%保护，具备英文标点总编辑处理能力。
  触发：检查标点、修正标点、标点有问题、标点规范、半角改全角、中西空格、标点符号检查、punctuation、fix punctuation。
  Not for：纯英文文本校对（→ 英文编辑工具）、纯代码文件、用户明确说"不要改标点"。
---

# 标点大师（Punct Master）

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

---

## 12类AI常见标点错误谱系

| # | 错误类型 | 错误示例 | 正确写法 | 自动修正 |
|---|---------|---------|---------|---------|
| 1 | 半角逗号 | `今天,明天` | `今天，明天` | ✅ |
| 2 | 半角句号 | `这是一本书.` | `这是一.book。` | ✅ |
| 3 | 半角引号 | `"你好"` | `「你好」` | ✅非代码 |
| 4 | 半角括号 | `见下图(图1)` | `见下图（图1）` | ✅ |
| 5 | 缺少中西空格 | `使用React构建` | `使用 React 构建` | ✅ |
| 6 | 多余中西空格 | `这 是 中 文` | `这是中文` | ✅ |
| 7 | 破折号滥用 | `——即` | `，即` 或删除 | ✅ |
| 8 | 省略号不规范 | `....` `。。。` | `……` | ✅ |
| 9 | 顿号误用 | `苹果，香蕉` | `苹果、香蕉` | ⚠️建议 |
| 10 | 感叹号连用 | `太棒了！！！` | `太棒了！` | ✅ |
| 11 | 英文标点混入中文 | `Hello, world`（中文语境） | `Hello，world` | ⚠️建议 |
| 12 | 中文标点混入英文 | `This is good。` | `This is good.` | ⚠️建议 |

---

## 四类场景规则矩阵

### 场景A：中文散文（公众号/博客/随笔）

```
全角标点强制：，。？！：；（）「」『」『
引号规范：直角引号「」用于概念和对话
破折号：禁用（用逗号/句号/括号替代）
省略号：六个点 ……
顿号：分隔中文并列短词
感叹号：全文≤3处，禁止连用
```

### 场景B：技术文档（API/手册/Runbook）

```
中西文间空格：使用 React 构建 / 调用 API 接口
代码围栏保护：不修改 ``` ``` 内的任何标点
行内代码保护：不修改 ` ` 内的标点
URL保护：不修改 http://... 内的标点
数字保护：1,000 / 3.14 / 12:30 不动
标题层级：# → ## → ### 不超过三级
```

### 场景C：中英混排（双语发布/国际化）

```
排版规则：
- 中文块与英文块之间加空格
- 中文括号内嵌英文：括号全角，内部英文标点半角
- 英文块内嵌中文：英文标点半角，内部中文标点全角

术语一致性：
- 首次出现：保留英文+中文注解
- 后续出现：统一用中文
- 行业通用缩写（SFT/RL/MoE）全程保留
```

### 场景D：社交媒体（小红书/即刻/推特）

```
适度灵活：
- 允许适度使用emoji（每段≤2个）
- 允许适度使用感叹号（表达情绪）
- 允许使用---分隔线

但仍有底线：
- 中文不能用半角标点
- 中西文间仍需空格
- 不能连续3个以上感叹号
```

---

## 英文标点总编辑能力

| 检查项 | 规则 | 修正方式 |
|--------|------|---------|
| 逗号后空格 | `a,b` → `a, b` | 自动 |
| 句号后空格 | `end.Start` → `end. Start` | 自动 |
| 引号方向 | 直引号 `"` → 弯引号 `"` `'` | 自动（非代码） |
| 破折号 | `---` → `—` `--` → `–` | 自动 |
| 省略号 | `...` → `…` | 自动 |
| 首字母大写 | 句首单词大写 | 自动 |
| 连续空格 | `word1  word2` → `word1 word2` | 自动 |

**英文禁止词**：delve、leverage（as verb）、utilize、robust、streamline、harness、navigate（challenges）、unpack、paradigm、synergy、tapestry、landscape、game-changer、moving forward

---

## 代码/机器可读内容保护

```
保护清单（100%不动）：
- 代码围栏 ``` ... ```
- 行内代码 `...`
- URL http://... https://...
- 邮箱 xxx@xxx.com
- 文件路径 a/b/c.ext
- HTML/XML标签 <div>
- 数字 1,000 / 3.14 / 12:30
- 命令行参数 --flag
- JSON键名 "key": "value"

保护策略：
- 上述区域内标点100%不动
- 区域外按场景规则处理
- 边界处上下文判断
```

---

## 执行流程

```
用户输入文本/文件
    │
    ▼
Step 1: 场景识别
    ├── 含代码块/URL/参数 → 场景B（技术文档）
    ├── 中英混排>30% → 场景C（双语）
    ├── 含@/#/emoji → 场景D（社交媒体）
    └── 默认 → 场景A（中文散文）
    │
    ▼
Step 2: 保护标记
    ├── 标记代码围栏 ``` ```
    ├── 标记行内代码 ` `
    ├── 标记URL/邮箱/路径
    ├── 标记数字（千分位/小数/时间）
    └── 标记英文缩写（SFT/RL/MoE等）
    │
    ▼
Step 3: 检测扫描
    ├── 快速扫描（半角标点、中西空格）
    ├── 深度扫描（破折号/省略号/感叹号连用）
    └── 上下文判断（逗号vs顿号、引号方向）
    │
    ▼
Step 4: 三层处理
    ├── 第一层：自动修正（80%）— 半角→全角、中西空格补全
    ├── 第二层：建议修正（15%）— 逗号vs顿号、引号方向
    └── 第三层：人工复核（5%）— 语义模糊项
    │
    ▼
Step 5: 输出
    ├── dry-run模式：只给报告
    └── 执行模式：修正后文本+改动清单
```

---

## 与其他技能的协作

```
┌─────────────────────────────────────────────────────────────┐
│  上游技能                                                    │
│  humanize-ai（去AI味）→ editor-revisor（删废话）              │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│  punct-master（标点治理）                                    │
│  → 场景识别 → 保护标记 → 检测扫描 → 三层处理 → 修正输出       │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│  下游技能                                                    │
│  packaging-workshop（标题/排版/配图/平台适配）                │
└─────────────────────────────────────────────────────────────┘
```

---

## 量化指标

| 指标 | 目标 | 测量 |
|------|------|------|
| 半角标点修正率 | ≥99% | 自动化测试 |
| 中西空格补全率 | ≥95% | 自动化测试 |
| 代码保护准确率 | 100% | 零容忍 |
| 误报率 | ≤2% | 人工抽检 |
| 语义模糊项标记率 | ≥90% | 人工抽检 |

---

## 输出格式

```
【标点检测报告】

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

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

【建议修正】（N处）
- 「原文」→ 「建议修正」 — 需要判断：{原因}

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

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

---

## DO NOT

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

---

*punct-master v1.0.0 — 12类错误谱系、四层场景规则、三层处理机制*