标点大师（Punct Master）

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

12类AI常见标点错误谱系

四类场景规则矩阵

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

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

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

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

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

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

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

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

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

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

英文标点总编辑能力

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

代码/机器可读内容保护

保护清单（100%不动）：
- 代码围栏 ``` ... ```
- 行内代码 `...`
- URL http://... https://...
- 邮箱 [email protected]
- 文件路径 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（标题/排版/配图/平台适配）                │
└─────────────────────────────────────────────────────────────┘

量化指标

输出格式

【标点检测报告】

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

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

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

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

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

DO NOT

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

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