外观
案例 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 章(批量处理)。