| 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类错误谱系、四层场景规则、三层处理机制
