zan-punct-fix

一个面向 Claude Code / AI Agent 的技能（skill），用来审查并修正文件夹中所有文件里 用错的中文标点 —— 这是 AI 生成内容最典型的毛病：本该用全角的标点 （， 。 ？ ！ ： ； “” （））却写成了半角的 , . ? ! : ;、 直引号、半角括号。

功能

递归扫描一个路径（文本、代码和 .docx 文件），只在标点处于中文上下文时把半角转成 正确的全角形式，并报告每一处改动。

半角	全角	触发条件
,	，	相邻有汉字（且不在数字之间）
,	、（顿号）	分隔 3 个及以上的纯中文短词（产品,渠道,服务）
.	。	前一个实义字符是汉字（且不是小数 / 版本号）
? !	？！	相邻有汉字
: ;	：；	前一个字符是汉字（且不是 12:30 这种时间）
"…" '…' (…)	“…” ‘…’ （…）	引号 / 括号对位于中文之中（仅散文，非代码）
... -- —	…… ——	相邻有汉字

绝不会动的内容

• 围栏代码块、行内代码、URL、邮箱、文件路径、HTML 标签
• 数字：1,000（千分位）、3.14（小数）、12:30（时间）
• 纯英文句子（没有汉字相邻 → 不改动）
• 源代码语法：在 .py / .js / .json 等文件里，会修正中文字符串和注释内部的标点， 但保留作为字符串定界的引号和括号，因此绝不会破坏代码。

使用

# 先预览（推荐）
python3 scripts/fix_punctuation.py <路径> --dry-run

# 应用修改并写出 JSON 报告
python3 scripts/fix_punctuation.py <路径> --json report.json

选项：--dry-run、--json 文件、--no-dash、--no-fullwidth-space、--no-dunhao、 --include-all。完整的行为说明、以及需要由人 / 模型复核的依赖语义的情况，见 SKILL.md。

作为技能安装

克隆到你的技能目录：

git clone git@github.com:BolynWang/zan-punct-fix.git ~/.claude/skills/zan-punct-fix

Agent 会在用户说出类似「帮我检查这个文件夹的标点符号」这样的请求时自动触发它。