跳到正文

案例 4:批量修正文档格式

难度:⭐⭐ | 场景:批量处理 | 涉及章节:第 3、11 章

场景

你导出了一批 Markdown 文档(比如从旧系统迁移的 30 个文件),格式混乱:标题层级不对、代码块没闭合、有乱码、链接格式不统一。人工改 30 个文件要一下午。

指令(可直接照做)

docs/legacy/ 下有 30 个 Markdown 文件,格式混乱。
请帮我统一修正:
1. 标题层级规范化(一级标题唯一,二级以下递进)
2. 代码块补全(``` 未闭合的修复)
3. 链接统一为相对路径格式
4. 检测并报告乱码(不自动改,先列出清单)
5. 修改前先备份到 docs/legacy_backup/
6. 输出修正日志:每个文件改了什么

我的做法(逐步拆解)

① 先抽查 3 个文件,摸清"混乱模式"(几类问题、各占多少)
② 汇总问题类型 → 给出修正规则(你确认规则,避免误伤)
③ 备份全部原文件到 backup 目录
④ 批量修正(脚本处理)→ 每类问题单独跑,别混在一起
⑤ 输出修正日志(文件 → 改了什么 → 成功/失败)
⑥ 抽查 3 个修正后的文件,确认规则生效、无副作用

交付物

  • docs/legacy/ 下已修正的 30 个文件;
  • docs/legacy_backup/ 原始备份;
  • 修正日志(每个文件的改动明细);
  • 乱码清单(待你决定如何处理)。

复盘要点

环节关键点
先摸模式批量修正前必须先抽查,搞清楚"有哪几类问题",否则规则会误伤
备份先行批量修改=不可逆,备份是一切的前提
分类执行每类问题单独修正,日志清晰、出错好定位

可复用资产

  • 修正规则集:标题/代码块/链接三类规则可复用到任何批量修正;
  • 沉淀建议:做成"文档格式统一" Skill;
  • 关联章节:第 3 章(工具)、第 11 章(批量处理)。

返回案例库

以真实任务为主线的 MomaWork 助手实战读本