| name | punct-polish |
| version | 1.1.0 |
| description | 【标点打磨】AI写中文最常见的毛病就是标点：半角逗号、缺少中西空格、直引号、破折号滥用……这个技能一次性解决。覆盖中文散文、技术文档、中英混排、社交媒体四种场景，代码和URL完全不动，还具备英文标点校对能力。
触发：检查标点、修正标点、标点有问题、标点规范、半角改全角、中西空格、标点符号检查、punctuation、fix punctuation。
Not for：纯英文文本校对（→ 英文编辑工具）、纯代码文件、用户明确说"不要改标点"。
|
标点打磨
AI写中文，标点是最常见的毛病：半角逗号、缺少中西空格、直引号、破折号滥用……一次性解决。
AI最常犯的标点错误
按频率排序：
- 半角逗号 → 该用
，的地方写了, — 极高频率
- 半角句号 → 该用
。的地方写了. — 极高频率
- 缺少中西空格 →
使用React构建 应该是 使用 React 构建 — 高频率
- 直引号 →
"你好" 应该是 「你好」（非代码） — 高频率
- 半角括号 →
见下图(图1) 应该是 见下图（图1） — 高频率
- 破折号滥用 →
——即 应该是 ，即 或直接删除 — 中等
- 省略号不规范 →
.... 或 。。。 应该是 …… — 中等
- 顿号误用 →
苹果，香蕉 应该是 苹果、香蕉 — 中等
- 感叹号连用 →
太棒了！！！ 应该是 太棒了！ — 中等
- 多余中西空格 →
这 是 中 文 应该是 这是中文 — 低
- 英文标点混入中文 →
Hello, world（中文语境） — 低
- 中文标点混入英文 →
This is good。 — 低
其中前5项全自动修正，后7项根据上下文判断后修正或标记建议人工复核。
四种场景的标点规则
中文散文（公众号/博客/随笔）
全角标点强制使用：，。？！：；（）「」『」『。破折号禁用，用逗号或句号替代。省略号用六个点……。顿号分隔中文并列短词。感叹号全文不超过3处，禁止连用。
技术文档（API/手册/Runbook）
中文和英文/数字之间加空格：使用 React 构建、调用 API 接口。代码围栏内的标点完全不动。行内代码的标点不动。URL不动。数字不动：1,000、3.14、12:30。标题层级#→##→###不超过三级。
中英混排（双语发布/国际化）
中文块与英文块之间加空格。中文括号内嵌英文时，括号用全角，内部英文标点用半角。英文块内嵌中文时，英文标点用半角，内部中文标点用全角。
术语一致性：首次出现保留英文+中文注解，后续统一用中文。行业通用缩写（SFT/RL/MoE）全程保留。
有稳定中文对译的英文词直接换成中文：context→上下文、state→状态、cache→缓存、claim→断言、runtime→运行时、contract→契约。
社交媒体（小红书/即刻/推特）
适度灵活：允许适度使用emoji（每段不超过2个），允许适度使用感叹号（表达情绪），允许使用---分隔线。
但仍有底线：中文不能用半角标点，中文英文间仍需空格，不能连续3个以上感叹号。
英文标点校对
英文标点的自动修正：
- 逗号后空格：
a,b → a, b
- 句号后空格：
end.Start → end. Start
- 引号方向：直引号
"→弯引号" '（非代码）
- 破折号：
---→— --→–
- 省略号：
...→…
- 首字母大写：句首单词
- 连续空格合并
英文AI词汇替换：delve→examine、leverage→use、utilize→use、robust→strong、streamline→simplify、harness→use、navigate→handle、unpack→explain、paradigm→system、synergy→combination、tapestry→mix、landscape→situation、game-changer→significant、moving forward→next。
代码/机器可读内容保护
以下区域标点100%不动：
- 代码围栏
``` 和行内代码
- URL、邮箱、文件路径
- 数字：千分位
1,000、小数3.14、时间12:30
- HTML/XML标签
<div>
- 命令行参数
--flag
- JSON键名
"key": "value"
执行流程
先识别场景，再标记保护区域，然后扫描检测，最后分层修正。
- 场景识别：含代码块/URL/参数→技术文档；中英混排>30%→双语；含@/#/emoji→社交媒体；默认→中文散文
- 保护标记：标记代码围栏、行内代码、URL、邮箱、数字、英文缩写
- 检测扫描：快速扫描半角标点和中西空格→深度扫描破折号/省略号/感叹号→上下文判断顿号和引号
- 分层修正：自动修正80%（半角→全角、空格补全）→建议修正15%（顿号、引号方向）→人工复核5%（语义模糊项）
两种输出模式：dry-run只给报告，执行模式输出修正后文本+改动清单。
与其他技能的协作
在去AI味和删废话之后、包装发布之前调用：
humanize-ai（去AI味）→ editor-revisor（删废话）→ punct-polish（标点打磨）→ packaging-workshop（包装发布）
量化指标
- 半角标点修正率 ≥99%
- 中西空格补全率 ≥95%
- 代码保护准确率 100%（零容忍）
- 误报率 ≤2%
- 语义模糊项标记率 ≥90%
输出格式
【标点检测报告】
场景：{中文散文/技术文档/中英混排/社交媒体}
保护：{代码围栏N处 / URLN处 / 数字N处 / 行内代码N处}
【自动修正】（N处）
- 「原文」→ 「修正后」— 原因
【建议修正】（N处）
- 「原文」→ 「建议修正」— 需要判断：{原因}
【人工复核】（N处）
- 「原文」— 模糊原因：{需要人工判断的内容}
【统计】
- 自动修正：N处 | 建议修正：N处 | 人工复核：N处 | 保护未动：N处
不要这么做
- 修改代码围栏内的任何标点
- 修改URL/邮箱/路径内的标点
- 修改数字（千分位、小数、时间）内的标点
- 在技术文档中使用广告文案的标点灵活性
- 在社交媒体中强制禁用所有emoji
- 将中文标点规则强加于纯英文文本
punct-polish v1.1.0 — 十二类错误、四种场景、代码零误伤
