punct-master

【标点综合治理】AI标点错误全谱系治理,中文为主英文为辅。12类错误检测+自动修正,四类场景(散文/技术文档/双语/社交)差异化规则,代码/URL/机器可读内容100%保护,具备英文标点总编辑处理能力。 触发:检查标点、修正标点、标点有问题、标点规范、半角改全角、中西空格、标点符号检查、punctuation、fix punctuation。 Not for:纯英文文本校对(→ 英文编辑工具)、纯

SKILL.md

GitHub

标点大师(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模式:只给报告
    └── 执行模式:修正后文本+改动清单

与其他技能的协作

┌─────────────────────────────────────────────────────────────┐
│  上游技能                                                    │
│  plainspoken-writing(去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类错误谱系、四层场景规则、三层处理机制