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://...
- 邮箱 [e-mail]
- 文件路径 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类错误谱系、四层场景规则、三层处理机制