# 核心文档阶段化写作流程复盘

复盘 ID：FP-ANA-YS-CORE-DOC-STAGED-WRITING-20260627-001  
关联案例：ANA-YS-INDUSTRY-001  
触发来源：用户在有色核心文档返修后继续指出 `有色的产业链总览.md` 仍存在术语不解释、数据线索不展开、具体年份和时间口径缺失等问题。  
当前状态：待审核员 fp 复审  

## 1. 用户原始反馈入口

来源入口：`MBX_SESSION_MARKER:run_20260624002656377_3369482c`

用户本轮原文要点：

1. `LME`、`SMM`、`SHFE`、`Trading Economics` 这些术语是什么意思，不能默认用户知道。
2. “原研报价格库存线索表有 53 条候选、41 张页图已恢复”这种解释等于没解释，应展开说明表里到底有什么、能读出什么。
3. “巨龙铜矿全年铜产量 19.38 万吨、销量 19.37 万吨、净利润 91.41 亿元”缺少年份和具体时间口径。
4. 需要继续和审核员 fp，重点搞清楚：
   - 为什么审核员审核不出来。
   - 写作流程不能要求一次写对，而应拆成多个阶段，每个阶段集中做 1-2 件事，逐步完善输出文档。

## 2. 直接问题

当前返修后的部分核心文档比原来好，但仍有三类用户可读性缺口：

1. 术语解释缺口：市场数据来源、交易所、报价机构、外部数据平台没有在用户首次遇到时解释。
2. 数据展开缺口：把内部证据工作量写给用户看，例如“53 条线索、41 张页图”，但没有翻译成“哪些品种有线索、这些线索说明什么、还不能说明什么”。
3. 时间口径缺口：公司案例和市场数据中出现“全年”“本周”“上周”“Q1”等相对时间或省略年份表达，没有转换为明确年份、报告期或“待核日期”。

这些问题说明：前序“数据要解释”的复盘只解决了“把数据连成因果链”的一部分，还没有形成稳定的“术语、数据展开、时间口径”复查阶段。

## 3. 为什么审核员审核不出来

### 3.1 审核检查点还停在“有没有解释”，没有细到“解释是否足够让用户无需背景知识”

前序审核已经从“有无数据”升级到“是否解释数据”，但审核员主要检查新增段落是否能说明市场、产业链或公司含义。它没有单独检查：

1. 首次出现的专业缩写是否解释。
2. 内部过程数字是否被翻译成用户可理解的行业信息。
3. 相对时间是否改成具体年份或报告期。

所以审核能挡住“只有数据没有解释”，但没挡住“解释仍然像内部工作说明”。

### 3.2 审核对象是抽样批次，未把总览作为“用户第一屏”单独高标准复查

`有色的产业链总览.md` 是用户先读入口，应该比普通子行业或公司页更强调“术语不跳、口径不跳、逻辑不跳”。前序审核把它当作普通核心文档样本的一部分，没有单独设置“总览首读友好度”检查。

结果是：文档局部有因果解释，但用户第一眼仍会遇到缩写、内部统计和时间不清。

### 3.3 审核缺少“反向读者测试”

审核员读文档时带着 ana、研报和证据链背景，因此能理解 `LME`、`SMM`、`SHFE`、`页图恢复`、`线索表` 的含义。但用户不是审核员。审核没有做“假设读者不知道这些词”的反向测试。

这不是单纯审核员粗心，而是审核流程缺少一个明确阶段：站在普通用户视角读一遍，专查不解释的词、不展开的数据和不清楚的时间。

### 3.4 复审目标过宽，导致一次审核想同时看太多维度

前序复审常同时检查数据、案例、传导、边界、风险词、文件状态和证据入口。维度过多时，审核容易抓住“大方向通过”，漏掉细粒度可读性问题。

因此后续审核不应再要求一次复审解决所有质量问题，而应配合写作流程分阶段审核：框架审核看框架，数据审核看数据，口径审核看术语和时间。

## 4. 写作流程根因

### 4.1 我把“核心文档输出”当成一次成稿

我试图在一次返修里同时完成结构、数据、解释、公司含义、边界和审计口径。这导致每一层都做了一些，但没有一层稳定做到位。

### 4.2 没有把“写文档”拆成可复查的中间状态

当前流程里缺少这些中间产物：

1. 框架草稿：先确认用户阅读顺序和每节回答什么问题。
2. 数据落点稿：每个结论后面放哪个数据或案例。
3. 解释稿：每个数据说明什么、传导到哪里。
4. 口径稿：每个术语、时间、单位是否解释清楚。
5. 人读稿：删掉内部流程语言，让普通用户顺着读。

没有中间状态，审核也只能面对“成品文档”一次性判断，天然容易漏。

## 5. 后续阶段化写作流程

后续核心文档不再按“一次写完再审核”的方式推进。每个文档或每个批次按以下阶段执行，每个阶段只集中检查 1-2 件事。

### 阶段 1：框架阶段

目标：只确认文档回答哪些问题、读者按什么顺序读。

只检查两件事：

1. 每一节是否回答一个真实用户问题。
2. 章节顺序是否符合用户阅读习惯。

不在这一阶段纠结数据完整性、措辞润色或证据表细节。

### 阶段 2：数据和案例落点阶段

目标：把每个核心判断后面需要用的数据、案例或证据入口放到正确位置。

只检查两件事：

1. 每个核心判断有没有对应数据、案例或明确 `DATA_GAP_REVIEW`。
2. 数据是否放在它能支撑的判断旁边，而不是堆在文末或证据表里。

不要求这一阶段解释得很漂亮，但不能无数据下结论。

### 阶段 3：解释和传导阶段

目标：把数据翻译成用户能懂的行业、市场或公司含义。

只检查两件事：

1. 每组数据后面是否回答“这说明什么”。
2. 是否说明它如何传导到价格、库存、利润、产业链环节或公司。

这一阶段重点解决“只给数据不解释”的问题。

### 阶段 4：术语和口径阶段

目标：消除用户读不懂的专业缩写、数据来源和时间口径。

只检查两件事：

1. 首次出现的专业词、机构缩写、指标缩写是否用中文解释。
2. 年份、报告期、日期、单位、币种、相对时间是否明确；不能明确时是否写成“待核日期/待核口径”。

例如：

1. `LME`：伦敦金属交易所，主要看海外金属价格和库存。
2. `SHFE`：上海期货交易所，主要看国内期货价格和交易所库存。
3. `SMM`：上海有色网，常用于国内现货价格、社会库存和行业报价。
4. `Trading Economics`：宏观和商品价格数据聚合平台，只能作为外部价格参考，不能替代交易所或原始报价源。

### 阶段 5：人读润色阶段

目标：把内部工作语言改成用户报告语言。

只检查两件事：

1. 删除或改写内部统计和流程语言，例如“事实句覆盖”“53 条线索”“41 张页图”。
2. 把它改成用户关心的话：有哪些品种、哪些数据、能读出什么、还不能判断什么。

示例：

不写：“原研报价格库存线索有 53 条，41 张页图已恢复。”  
改写为：“你提供的研报里，铜、铝、锂、镍、锡锑等品种已经能看到价格或库存线索。铜和铝最适合先读，因为它们既有价格库存，也能落到供给、成本和公司利润；锂钴镍目前更适合做观察池，因为价格有线索，但供需再平衡和库存口径还不够完整。”

### 阶段 6：审核分阶段复查

审核员不再只看最终成稿是否“总体可读”。后续复审应按提交阶段检查：

1. 框架稿：只审阅读顺序和问题覆盖。
2. 数据落点稿：只审判断是否有数据/案例或缺口。
3. 解释稿：只审数据是否被解释和传导。
4. 术语口径稿：只审专业词、日期、单位、币种和相对时间。
5. 人读稿：只审是否还残留内部工作语言、是否普通用户能读。

这不是增加更多审核轮次，而是避免一次审核同时看太多维度。实际执行时，一个批次可以合并阶段，但送审时必须说明本轮重点是哪 1-2 件事。

## 6. 对当前有色文档的最小修复建议

不立即全量重写 57 个文档。先拿 `有色的产业链总览.md` 作为阶段化流程样本返修，因为它是用户第一入口。

样本返修只做三件事：

1. 增加“先解释几个数据来源”的小节，解释 LME、SMM、SHFE、Trading Economics。
2. 把“53 条线索、41 张页图”改写为按品种展开的市场线索说明。
3. 把巨龙铜矿案例补上明确时间口径：2025 年全年产量、销量和净利润；2026 年 1 月 23 日二期建成投产；30-35 万吨为达产后年产量线索。

样本通过后，再把同一流程用于市场总览、子行业市场分析和公司页。

## 7. 不加码边界

1. 不要求一次性重写全部 57 个文档。
2. 不要求重新读取全部 359 份 raw。
3. 不重启 PASS-017。
4. 不新增同类旧缺口补证 PASS。
5. 不把每个小修都拆成 6 次送审；阶段可以合并，但每次必须说明本轮重点。
6. 不要求把所有术语做成百科，只解释影响当前判断的必要词。

## 8. 待审核员复审的问题

请审核员重点复审：

1. 本复盘是否解释清楚“为什么审核员没审出来”。
2. 阶段化写作流程是否能解决“一次成稿导致漏项”的问题。
3. 每阶段只查 1-2 件事的做法是否可执行、不过度加码。
4. 是否同意先以 `有色的产业链总览.md` 做样本返修，而不是立刻全量改文档。

## 9. 复审和样本返修回执

### 2026-06-27 11:40 fp 复盘方案复审

审核入口：`AUDIT-ANA-YS-CORE-DOC-STAGED-WRITING-FP-20260627-001`

审核结论：有条件通过。审核员确认审核漏检原因成立，阶段化写作流程可执行，并允许下一步只以 `有色的产业链总览.md` 为样本文档，先修术语解释、数据线索展开和时间口径。

### 2026-06-27 11:48 样本文档返修复审

审核入口：`AUDIT-ANA-YS-STAGED-WRITING-SAMPLE-20260627-001`

审核结论：通过。`有色的产业链总览.md` 已完成三项样本返修：

1. 解释 `LME`、`SHFE`、`SMM`、`Trading Economics` 的中文含义和用户阅读方式。
2. 把“53 条线索、41 张页图”从内部工作量语言改为按铜、铝、镍钴锂、锡锑钨、金银展开的阅读说明。
3. 补齐巨龙铜矿案例的时间口径：2025 年全年产量、销量、净利润；2026 年 1 月 23 日二期投产；二期达产后矿产铜年产量 30-35 万吨。

该通过不关闭 `ISSUE-ANA-YS-CORE-DOC-STAGED-WRITING-20260627-001`，也不代表全部 57 个核心文档完成最终阅读质量闭环。后续批次必须继续说明阶段重点，避免一次送审混入框架、数据、解释、术语、润色和全量质量闭环。