AgentSkillsCN

proofread

校对 Markdown 文章

SKILL.md
--- frontmatter
name: proofread
description: 校对 Markdown 文章

When to use

当用户需要对 Hugo 博客文章的 Markdown 文件进行格式与语言校对时使用。

How to use

对指定的 Hugo Markdown 文件(content/posts 下)执行格式与语言校对,生成问题清单与 patch。默认 dry-run:生成变更提案并展示 diff;用户确认后可就地覆盖原文件(或按 --backup 生成备份)。

hooks / flow

  1. 前置:验证 path 存在且位于 content/posts/ 下。
  2. 建立 ToDo 列表以追踪发现的问题与修复动作。
  3. 快速扫描文件,定位可能的异常段落(包括:中英混排、异常标点、疑似错别字和病句)。
  4. 对全文执行详尽校对,输出:问题清单(行号 + 类型)、每处的修复建议、以及可直接 apply 的 patch 或完整修复后的 Markdown。
  5. 列出修改动作(dry-run),并将变更保存在 ToDo 中供预览。
  6. 后置:展示 diff,询问用户是否 apply;若确认:就地覆盖原文件(并在需要时写入备份)。

Notes

  • 校对重点:中/英文间距、全半角标点、错别字、语法病句、Markdown 标题/列表/代码块格式、图片/链接路径有效性(可选)。
  • 默认行为为 dry-run,用户需显式确认 apply。

Interaction Example

  • 用户:检查 content/posts/2025/draft.md
  • 系统:扫描并输出问题清单 + 预览修复 → 用户确认 apply → 系统就地覆盖文件并返回修改摘要