punct-master

Punct Master

When AI writes Chinese, punctuation is the most common problem: half-width commas, missing CJK-Latin spacing, straight quotation marks, dash overuse... This skill solves it all at once.

---

Spectrum of 12 Common AI Punctuation Errors

#	Error Type	Error Example	Correct Form	Auto-fix
1	Half-width comma	今天,明天	今天，明天	✅
2	Half-width period	这是一本书.	这是一.book。	✅
3	Half-width quotation marks	"你好"	「你好」	✅ Non-code
4	Half-width parentheses	见下图(图1)	见下图（图1）	✅
5	Missing CJK-Latin spacing	使用React构建	使用 React 构建	✅
6	Extra CJK-Latin spacing	这 是 中 文	这是中文	✅
7	Dash overuse	——即	，即 or delete	✅
8	Nonstandard ellipsis	.... 。。。	……	✅
9	Misuse of the enumeration comma	苹果，香蕉	苹果、香蕉	⚠️ Suggestion
10	Repeated exclamation marks	太棒了！！！	太棒了！	✅
11	English punctuation mixed into Chinese	Hello, world(Chinese context)	Hello，world	⚠️ Suggestion
12	Chinese punctuation mixed into English	This is good。	This is good.	⚠️ Suggestion

---

Rule Matrix for Four Scenarios

Scenario A: Chinese prose (WeChat Official Account/blog/essay)

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

Scenario B: Technical documentation (API/manual/Runbook)

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

Scenario C: Chinese-English mixed layout (bilingual publishing/internationalization)

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

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

Scenario D: Social media (Xiaohongshu/Jike/Twitter)

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

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

---

English Punctuation Chief-Editor Capability

Check Item	Rule	Correction Method
Space after comma	a,b → a, b	Automatic
Space after period	end.Start → end. Start	Automatic
Quotation mark direction	Straight quotation mark " → Curly quotation mark " '	Automatic (non-code)
Dash	--- → — -- → –	Automatic
Ellipsis	... → …	Automatic
Initial capitalization	Capitalize the first word of a sentence	Automatic
Consecutive spaces	word1 word2 → word1 word2	Automatic

English Banned Words：delve、leverage（as verb）、utilize、robust、streamline、harness、navigate（challenges）、unpack、paradigm、synergy、tapestry、landscape、game-changer、moving forward

---

Code/Machine-Readable Content Protection

保护清单（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%不动
- 区域外按场景规则处理
- 边界处上下文判断

---

Execution Flow

用户输入文本/文件
    │
    ▼
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模式：只给报告
    └── 执行模式：修正后文本+改动清单

---

Collaboration with Other Skills

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

---

Quantitative Metrics

Metric	Target	Measurement
Half-width punctuation correction rate	≥99%	Automated testing
CJK-Latin spacing completion rate	≥95%	Automated testing
Code protection accuracy	100%	Zero tolerance
False positive rate	≤2%	Manual sampling inspection
Semantically ambiguous item marking rate	≥90%	Manual sampling inspection

---

Output Format

【标点检测报告】

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

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

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

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

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

---

DO NOT

• Modify any punctuation inside code fences
• Modify punctuation inside URLs/emails/paths
• Modify punctuation inside numbers (thousands separators, decimals, times)
• Punctuation flexibility used in advertising copy in technical documentation
• Mandatory disabling of all emojis in social media
• Imposing Chinese punctuation rules on purely English text

---

punct-master v1.0.0 — 12-category error taxonomy, four-layer scenario rules, three-layer processing mechanism