内容去重与一致性精修记录
本文件记录本轮“内容去重与一致性精修”的执行结果。
1. 执行目标
本轮目标不是继续扩写,而是减少重复、统一结构,并确保“企业案例”和“贯穿案例”之间不互相抢占叙事位置。
重点处理:
- 每章新增的“贯穿案例:CI 失败分析 Agent”与原有企业案例之间的重复;
- 删除重复后章节编号不连续的问题;
- 二级小节编号与父章节编号不一致的问题;
- 第 1~23 章结构一致性检查。
2. 已删除 / 合并的重复案例小节
以下小节与新增的“贯穿案例:CI 失败分析 Agent”内容高度重叠,已删除,由对应章节的贯穿案例小节统一承载:
book/04-context-engineering.md
- 企业研发 Agent 示例:CI 失败分析
book/05-context-components.md
- 企业案例:CI 失败分析上下文
book/06-context-selection.md
- 企业案例:CI 失败分析
book/07-context-compression.md
- 企业案例:CI 日志压缩
book/10-tool-orchestration.md
- 企业案例:CI 失败分析工具计划
book/13-harness-engineering.md
- 企业案例:CI 失败分析 Harness
book/15-memory-engineering.md
- 企业案例:项目经验记忆
book/20-agent-runtime.md
- 企业案例:CI 失败分析 Runtime 流程
保留策略:
- 如果企业案例与 CI 失败分析不是同一场景,则保留,例如多 Agent PR Review、技术选型研究、用户偏好治理等;
- 如果企业案例本身就是 CI 失败分析,则合并到统一的贯穿案例小节;
- 第 23 章已在上一轮合并重复贯穿案例,本轮继续保持单一小节。
3. 章节编号统一
删除重复小节后,已重新编号第 1~23 章所有一级章节标题:
## 1. ...
## 2. ...
## 3. ...
并确保每章编号连续。
检查结果:
H2 sequence bad: none
4. 二级小节编号修复
由于删除部分一级章节后,一些二级小节出现父编号不一致的问题,例如:
## 8. 与其他框架对比
### 9.1 与传统 RAG
本轮已统一修复为:
## 8. 与其他框架对比
### 8.1 与传统 RAG
检查结果:
H3 parent mismatches: 0
5. 贯穿案例一致性检查
第 1~23 章均保留且仅保留一个:
贯穿案例:CI 失败分析 Agent
检查结果:
case count bad: none
6. 模板要素检查
第 1~23 章均已包含:
本章导读
所属部分
本章状态:精修稿
本章主图
贯穿案例:CI 失败分析 Agent
本章小结
实践任务
检查结果:
本章导读 OK
所属部分 OK
精修状态 OK
本章主图 OK
贯穿案例 OK
本章小结 OK
实践任务 OK
7. 当前书稿规模
本轮去重后,book/*.md 总大小约为:
344829 bytes
8. 后续建议
下一轮建议进入“附录与模板补充”:
appendix/glossary.md:面向正式读者的术语表;appendix/agent-engineering-checklist.md:Agent 工程检查清单;appendix/agents-md-template.md:AGENTS.md 模板;appendix/skill-template.md:Skill 模板;appendix/tool-definition-template.md:Tool Definition 模板;appendix/data-structures.md:核心数据结构汇总。