这次练习只解决一个小问题：将普通 Markdown 的二级标题“常见问题”改成“使用问答”。已有结构化 FAQ 的文章保持其结构，格式不完整的文章留待检查。任务不包含扩写答案、改 URL 或新增问题。
三份输入，分别代表三种情况
在一个新的 batch-demo 目录创建 articles 子目录，保存以下三个完整文件。材料都是教学示例。
articles/a.md：
---
title: 导出说明
slug: export
---
# 导出说明
## 常见问题
### 能导出哪些格式？
当前说明仅列出CSV。
articles/b.md：
---
title: 登录说明
slug: login
faq:
- question: 忘记密码怎么办？
answer: 使用登录页的找回入口。
---
# 登录说明
本页问答由渲染器从faq字段生成。
articles/c.md：故意缺少 frontmatter 结束分隔线。
---
title: 账单说明
slug: billing
# 账单说明
## 常见问题
发票问题请联系账单负责人。
先让Claude Code输出这张变更矩阵
只读articles里的全部3份Markdown。按实际结构分类并输出matrix.md。
普通正文只把完整独立行“## 常见问题”改为“## 使用问答”。
已有frontmatter faq字段的文章保持原样；frontmatter无法解析时进入异常队列。
保留title、slug、正文答案、链接和其他标题。先列逐文件计划，不写文件。
| 文件 | 识别结果 | 本轮动作 | 预期变化 |
|---|---|---|---|
| a.md | frontmatter闭合，正文有指定标题 | 改一个标题 | 仅该行变化 |
| b.md | 已有结构化faq | 保留 | 无变化 |
| c.md | frontmatter缺结束分隔线 | 暂停该文件 | 无变化；进入异常队列 |
检查分类成立后，继续要求：“按矩阵处理 a.md，保持 b.md 和 c.md 字节不变；输出变更记录和 exceptions.md，不自动修复 c.md。”
合格的差异应该很小
a.md 应只有：
-## 常见问题
+## 使用问答
exceptions.md 应说明：
articles/c.md：开头存在---，但缺少frontmatter结束分隔线。
本轮未修改。需要作者确认正文起点，修复结构后再重新分类。
不是所有包含“常见问题”的文本都该修改：正文中引用这个词、三级标题、代码块里的示例都不属于这条规则。若真实文件存在这些情况，加入对应样稿后再运行主批次。
扩大范围时，逐文件检查哪些东西
如果项目已经使用 Git，可在该测试目录对应仓库中运行：
git diff --stat -- articles
git diff -- articles
git status --short -- articles
没有 Git 就保存修改前副本，用编辑器逐文件比较。改前和改后都列出文件清单；文件总数一致只能证明没有明显增删，不能证明正文没有被重写。
把验收落到三个具体判断：a.md 标题确实变了且回答没变；b.md 的 faq 字段和正文均保持；c.md 没被模型“顺手修好”，且异常原因可定位。真实批次也应每个文件有“已修改/原样保留/异常待处理”记录，三类之和等于分配范围。
若要用自动脚本替换，先确定解析方法能区分 frontmatter、代码块和普通正文，再执行。不能把这三份小样的成功当作几十种 Markdown 结构均已覆盖。本文提供了完整教学输入与参考差异，未调用 Claude Code 执行批量任务。
资料来源
- Claude Code常用工作流
核对在项目中检查和修改文件的基本工作方式；样稿及规则为教学设计。
下一步
继续阅读与你当前问题相关的教程：
