punct-polish
【标点打磨】AI写中文最常见的毛病就是标点:半角逗号、缺少中西空格、直引号、破折号滥用……这个技能一次性解决。覆盖中文散文、技术文档、中英混排、社交媒体四种场景,代码和URL完全不动,还具备英文标点校对能力。 触发:检查标点、修正标点、标点有问题、标点规范、半角改全角、中西空格、标点符号检查、punctuation、fix punctuation。 Not for:纯英文文本校对(→ 英文编辑工具)、纯代码文件、用户明确说"不要改标点"。
Install
npx skills add https://github.com/taxueseek/plainspoken-writing/tree/main/skills/punct-polish
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install taxueseek-plainspoken-writing@llmmart
git clone https://github.com/taxueseek/plainspoken-writing.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole taxueseek/plainspoken-writing collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
标点打磨
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味和删废话之后、包装发布之前调用:
plainspoken-writing(去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 — 十二类错误、四种场景、代码零误伤
Files (plainspoken-writing)
-
references
-
ai-common-mistakes.md 1.7 KB
Loading… -
en-copyedit.md 1.9 KB
Loading… -
scene-rules.md 2.7 KB
Loading…
-
-
SKILL.md 6.3 KB
--- name: punct-polish version: "1.10.0" description: | 【标点打磨】AI写中文最常见的毛病就是标点:半角逗号、缺少中西空格、直引号、破折号滥用……这个技能一次性解决。覆盖中文散文、技术文档、中英混排、社交媒体四种场景,代码和URL完全不动,还具备英文标点校对能力。 触发:检查标点、修正标点、标点有问题、标点规范、半角改全角、中西空格、标点符号检查、punctuation、fix punctuation。 Not for:纯英文文本校对(→ 英文编辑工具)、纯代码文件、用户明确说"不要改标点"。 --- # 标点打磨 > AI写中文,标点是最常见的毛病:半角逗号、缺少中西空格、直引号、破折号滥用……一次性解决。 --- ## AI最常犯的标点错误 按频率排序: 1. **半角逗号** → 该用`,`的地方写了`,` — 极高频率 2. **半角句号** → 该用`。`的地方写了`.` — 极高频率 3. **缺少中西空格** → `使用React构建` 应该是 `使用 React 构建` — 高频率 4. **直引号** → `"你好"` 应该是 `「你好」`(非代码) — 高频率 5. **半角括号** → `见下图(图1)` 应该是 `见下图(图1)` — 高频率 6. **破折号滥用** → `——即` 应该是 `,即` 或直接删除 — 中等 7. **省略号不规范** → `....` 或 `。。。` 应该是 `……` — 中等 8. **顿号误用** → `苹果,香蕉` 应该是 `苹果、香蕉` — 中等 9. **感叹号连用** → `太棒了!!!` 应该是 `太棒了!` — 中等 10. **多余中西空格** → `这 是 中 文` 应该是 `这是中文` — 低 11. **英文标点混入中文** → `Hello, world`(中文语境) — 低 12. **中文标点混入英文** → `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"` --- ## 执行流程 先识别场景,再标记保护区域,然后扫描检测,最后分层修正。 1. **场景识别**:含代码块/URL/参数→技术文档;中英混排>30%→双语;含@/#/emoji→社交媒体;默认→中文散文 2. **保护标记**:标记代码围栏、行内代码、URL、邮箱、数字、英文缩写 3. **检测扫描**:快速扫描半角标点和中西空格→深度扫描破折号/省略号/感叹号→上下文判断顿号和引号 4. **分层修正**:自动修正80%(半角→全角、空格补全)→建议修正15%(顿号、引号方向)→人工复核5%(语义模糊项) 两种输出模式:dry-run只给报告,执行模式输出修正后文本+改动清单。 --- ## 与其他技能的协作 在去AI味和删废话之后、包装发布之前调用: ``` plainspoken-writing(去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 — 十二类错误、四种场景、代码零误伤*
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.