When to use
当用户需要对 Hugo 博客文章的 Markdown 文件进行格式与语言校对时使用。
How to use
对指定的 Hugo Markdown 文件(content/posts 下)执行格式与语言校对,生成问题清单与 patch。默认 dry-run:生成变更提案并展示 diff;用户确认后可就地覆盖原文件(或按 --backup 生成备份)。
hooks / flow
- •前置:验证 path 存在且位于 content/posts/ 下。
- •建立 ToDo 列表以追踪发现的问题与修复动作。
- •快速扫描文件,定位可能的异常段落(包括:中英混排、异常标点、疑似错别字和病句)。
- •对全文执行详尽校对,输出:问题清单(行号 + 类型)、每处的修复建议、以及可直接 apply 的 patch 或完整修复后的 Markdown。
- •列出修改动作(dry-run),并将变更保存在 ToDo 中供预览。
- •后置:展示 diff,询问用户是否 apply;若确认:就地覆盖原文件(并在需要时写入备份)。
Notes
- •校对重点:中/英文间距、全半角标点、错别字、语法病句、Markdown 标题/列表/代码块格式、图片/链接路径有效性(可选)。
- •默认行为为 dry-run,用户需显式确认 apply。
Interaction Example
- •用户:检查 content/posts/2025/draft.md
- •系统:扫描并输出问题清单 + 预览修复 → 用户确认 apply → 系统就地覆盖文件并返回修改摘要