punctuation-fix

标点符号规范化命令

自动批量修复 Markdown 文件中的标点符号，确保符合项目翻译标准。

使用方式

/punctuation-fix [路径]

参数:

• 路径 (可选): 要处理的文件或目录路径，默认为项目根目录下所有 .md 文件

执行步骤

1. 确定处理范围

根据参数确定要处理的文件:

• 如果未指定路径，处理项目根目录下所有 .md 文件（排除 .git/, spec-kit/, node_modules/ 等目录）
• 如果指定的是文件，仅处理该文件
• 如果指定的是目录，处理该目录下所有 .md 文件

2. 执行标点符号规范化

使用 sed 或 perl 进行批量替换，处理以下规则:

中文标点 → 英文标点:

中文标点	英文标点	说明
，	,	逗号后添加空格
。	.	句号后添加空格
：	:	冒号后添加空格
；	;	分号后添加空格
！	!	感叹号后添加空格
？	?	问号后添加空格
、	,	顿号替换为逗号并添加空格

空格处理规则:

• 标点后如果是中文字符，添加一个空格
• 标点后如果是英文/数字，检查是否已有空格，避免重复
• 标点后如果是换行符，不添加空格
• 标点后如果已经是空格，不重复添加

保护特殊内容 (不处理):

• 代码块 (```...```)
• 行内代码 (`...`)
• URL 和链接
• HTML 标签

3. 生成执行脚本

生成并执行 shell 脚本，示例:

#!/bin/bash

# 标点符号规范化脚本
# 处理指定目录下的 Markdown 文件

TARGET_DIR="${1:-.}"

# 使用 perl 进行替换（更好的 Unicode 支持）
find "$TARGET_DIR" -name "*.md" \
  -not -path "*/.git/*" \
  -not -path "*/spec-kit/*" \
  -not -path "*/node_modules/*" \
  -not -path "*/.venv/*" \
  -type f -exec perl -CSD -i -pe '
    # 保护代码块（先替换为占位符）
    # ... 保护逻辑 ...

    # 中文标点转英文标点（后跟非空白字符时添加空格）
    s/，(\S)/, $1/g;    # 逗号
    s/。(\S)/. $1/g;    # 句号
    s/：(\S)/: $1/g;    # 冒号
    s/；(\S)/; $1/g;    # 分号
    s/！(\S)/! $1/g;    # 感叹号
    s/？(\S)/? $1/g;    # 问号
    s/、(\S)/, $1/g;    # 顿号

    # 标点后已经是空白的情况（只替换标点）
    s/，(\s)/,$1/g;
    s/。(\s)/.$1/g;
    s/：(\s)/:$1/g;
    s/；(\s)/;$1/g;
    s/！(\s)/!$1/g;
    s/？(\s)/?$1/g;
    s/、(\s)/,$1/g;

    # 恢复代码块
    # ... 恢复逻辑 ...
  ' {} \;

echo "标点符号规范化完成"

4. 验证和报告

执行完成后:

1. 显示处理的文件数量
2. 显示修改的统计信息
3. 如果有无法自动处理的情况，列出需要人工检查的位置

注意事项

• 执行前会自动创建备份（可选）
• 不会处理代码块内的内容
• 不会处理 URL 中的标点
• 建议在执行后进行 diff 检查

示例

处理前:

这是一个示例，包含中文标点。包括：冒号、顿号等！

处理后:

这是一个示例, 包含中文标点. 包括: 冒号, 顿号等!

输出格式

执行完成后输出:

📝 标点符号规范化报告

处理文件: 42 个
修改文件: 15 个

修改统计:
  ，→ ,   : 128 处
  。→ .   : 86 处
  ：→ :   : 34 处
  ；→ ;   : 12 处
  ！→ !   : 8 处
  ？→ ?   : 5 处
  、→ ,   : 23 处

✅ 标点符号规范化完成