DTL-20260828-01 | 需求分析方法论提炼（ref 可复用知识文档）¶
执行人：听写（DT） 执行时间：2026-08-28 任务来源：TL 指令（用户：要求阅读理解需求分析/原型/用例文档，总结可复用的需求分析方法经验） 关联文档：需求分析方法技巧、RQD 目录、UCL、MSC-FE、RAR
一、任务目标¶
通读本项目核心需求分析、业务用例、原型、需求评审、前端设计方法论文档，提炼「从战略到具体功能实现」的可复用需求分析方法论，输出为 ref\DOC-M10互联网应用平台需求分析方法技巧.md，供其他互联网应用平台项目复用。
二、执行过程¶
步骤 1：通读需求分析三层文档¶
- 操作：读 docs/需求分析/README.md（三层结构索引）+ 战略级/业务级/执行级需求
- 结果：确认三层法（S 战略=做什么为什么/SPO；B 业务=做多少怎么做/BO + 需求编号表；O 执行=何时做谁来做/PO-TL-OL）与编号体系（QSV-01/CPT-05/MDS-14 等）
步骤 2：通读业务用例库与原型体系¶
- 操作：读 UCL README（V1.2）+ CPT-QSV 用例样例；读 原型 README + 原型设计索引卡片
- 结果：确认用例模板（编号/分类/触发/关联原型/主流程带数据样例/异常分支）、三角关联（
data-comp-id↔用例↔RQD-XX-NN需求编号）、字段映射表（UI 控件→DTO→UAT 断言如 final_price 1141.60）
步骤 3：通读需求评审闭环¶
- 操作：读 RAR README + RAR-01（EVAL 差值评审 21 项 P0 8 + P1 13）+ RAR-02（CCRR 交叉一致性审查 14 问题）
- 结果：确认「一线真实资料 vs 设计文档」差值分析法、跨文档一致性审查、修改条目回写需求编号的闭环流程
步骤 4：通读 MSC-FE 前端设计方法论¶
- 操作：读 DOC-P33（五层框架 + 6 条设计原则 + 信息-利益-风险三维分析）
- 结果：确认前端设计本质=信息流动效率、标准场景识别三判断（≥3 干系方/效率损失/高频）
步骤 5：撰写输出文档¶
- 操作：新建
ref\DOC-M10互联网应用平台需求分析方法技巧.md，按「四维闭环」组织（1 需求分层 / 2 用例库 / 3 原型交互 / 4 评审验证）+ 编号体系大动脉 + 闭环设计要点 + 可复用检查清单 + 经验教训 - 结果：全文成文，含 Mermaid 主框架图 + 各维度方法表 + 检查清单 + HKDIP 文档导航供他人溯源
步骤 6：按 TL 反馈调整（DOC-M10 前缀 + 原型层 + 用例覆盖与用例图）¶
- 操作：① 文档重命名加前缀 DOC-M10；② §1.1 需求分层增加第 4 层「原型」（承接执行要求→操作实践、业务目标→操作约束），新增 §1.5 原型层要点、原编号体系顺延 §1.6；③ §2.2 覆盖原则改为「每服务 ≥2 个典型用例」；④ §2.3 主流程增加 UML 用例图（mermaid 格式）及绘制规范，新增 §2.3.1 用例图示例；同步更新概览图、检查清单 A/B、附录导航
- 结果：四处调整全部落地，全文一致（四层需求 / ≥2 典型用例 / mermaid 用例图）
步骤 7：按 TL 反馈调整（各层内容性质·目标读者·分层评审规则）¶
- 操作：① §1.1 后新增 §1.2「各层内容性质与目标读者」——四层内容性质表（含反向边界「不应包含」列）+ 10 角色读者关注度矩阵（决策者/管理者/操作人员/PM/架构师/前后端工程师/测试/设计/运营）；② 新增 §1.3「分层评审规则」——每层主审角色、越界红线、评审要点、通过标准四栏评审表 + mermaid 越界判定回退流程 + 跨层一致性同步规则（B↔P / O↔P / 编号不变）；③ 原 §1.2~§1.6 顺延为 §1.4~§1.8；④ 检查清单 A 补充内容性质与分层评审两条；⑤ 修复历史遗留错误引用 §五.4 → §4.5④
- 结果：评审规则落地，防止各层内容越界；10 类读者角色纳入分级阅读视角
步骤 8：校对修复¶
- 操作：Grep 定位 2 处笔误（
ämä乱码、标题尾部多余引号）及 1 处失效引用（§五.4） - 结果：已修复
步骤 9：按 TL 反馈调整（执行级语义更正 + DOC-P33 MSC-FE 深度融合）¶
- 操作：
- 纠正「执行级」语义（用户明确指示：战略级/业务级/执行级 = 用户侧三个群体；执行级 = 基层最终操作用户 = Operational Requirements / 操作型需求，与原型操作过程直接对应；保留术语不改名）：
- §1.1 新增术语澄清框（语义基石说明 + RQD-O 官方标题佐证 + 不改名理由）；§1.1 O 行重写
- §1.2 O 行重写（内容性质=操作型需求；目标读者以用户组织操作人员为核心；反向边界=战略/业务/工期排期）
- §1.3 O 行重写（主审角色增加用户组织操作人员；评审要点=操作覆盖+对应原型+异常处置；通过标准=仅凭操作需求+原型可直接执行）
- §1.6 全部重写为操作需求导向（5 条：按干系方出操作需求明细/覆盖任务执行全环节/与原型对应/异常处置/操作权限绑定；边界说明区分交付管理配套与本体）
- §1.7 承接执行级措辞对齐（"操作要求 → 操作实践"）
- 读者矩阵 O 列调整：操作人员 ○→●●●，后端/前端/测试 ○→●●●，运营/客服 ○→●●●，决策者 ●●→●
- §1.3 跨层一致性同步规则 O↔P 对齐（"回写执行级操作需求"）；B 评审规则"工期排期"不再"下放执行层"改"归入交付管理配套"
- 概览图 line2 "(何时做/谁来做)"→"(操作用户的实操)"
- 将 DOC-P33 MSC-FE 深度抽象融入 §三：全文重写为 Layer 1（干系方图谱分析）→ Layer 2（信息-利益-风险三维分析，含抽象模板表）→ Layer 3（核心交互场景设计，识别三标准+设计四原则+输出模板）→ Layer 4（信息一致性保障：一份数据多视图/变更知会/三处枚举同源）→ 六条设计原则（抽象化，剥离 HKDIP 实例）→ Layer 5（端到端功能架构覆盖矩阵）→ 三层映射（界面→需求/界面→接口/字段→业务计算，抽象模板）→ 原型验收标准；全部剥离 HKDIP 具体内容（无 CST/WKR/HKD 等具体值）
- 检查清单 C 扩展为 MSC-FE 五层法 + 三层映射 + 六原则检查项（新增 6 条）
- 附录前段设计方法论行标注"本文档 §三 已抽象融合为通用方法"
- Grep 清理残留"执行要求/执行层"措辞（§1.1 关键收益 2 处 + §5.2 1 处 + §1.7 复用技巧 1 处），全文统一为"操作要求/操作需求"
- 结果：术语语义纠正完成；DOC-P33 方法论已抽象通用化融入；全文交叉引用与术语一致
三、关键决策¶
| 决策点 | 选项 | 最终选择 | 依据 |
|---|---|---|---|
| 文档定位 | 项目内部记录 vs 通用可复用方法论 | 通用方法论（明确标注「可复制到其他平台」） | 用户要求"总结经验方便复用" |
| 文档结构 | 按文档目录平铺 vs 按方法论维度组织 | 四维闭环框架（分层/用例/原型/评审）+ 编号大动脉贯穿 | 覆盖用户关注的"战略→功能闭环、确认与验证" |
| 引用方式 | 绝对路径 vs 相对路径 | 相对路径 + 服务文档导航附录 | 遵守 AGENTS.md 路径规范，且便于其他项目替换 |
四、验证结果¶
| 验证项 | 期望 | 实际 | 判定 |
|---|---|---|---|
| 输出文件存在 | ref\DOC-M10互联网应用平台需求分析方法技巧.md | 已创建 | ✅ |
| 笔误清零 | 无乱码/符号错误 | ämä、标题多余引号、失效引用 §五.4 已修复 |
✅ |
| 三点反馈落地 | DOC-M10 前缀 / 第4层原型 / ≥2典型用例 / mermaid用例图 | 已全部同步（含概览图与检查清单） | ✅ |
| 内容性质+读者+评审规则 | 各层内容性质/目标读者/反向边界 + 10 角色矩阵 + 分层评审规则 | 已落地 §1.2 / §1.3，旧 §1.2~1.6 顺延 1.4~1.8 | ✅ |
| 全文精炼无冗余 | 方法要点可执行 | 含检查清单 + 经验教训 + 文档导航 | ✅ |
| 执行级语义更正 | 执行级=操作型需求（基层操作用户），与原型对应 | §1.1 术语澄清 + §1.2/§1.3/§1.6 重写 + 读者矩阵 O 列调整 + 检查清单 A 同步 | ✅ |
| DOC-P33 融合 | MSC-FE 五层+六原则抽象融入、剥离 HKDIP 内容 | §三 重写为 Layer 1~5+六原则+三层映射+验收标准（通用模板，无 HKDIP 具体实例）；检查清单 C 扩展 | ✅ |
| 术语一致性 | 全文无"执行要求/执行层"残留误用（业务评审"工期排期"不再下放执行层） | Grep 清理 4 处残留，已统一 | ✅ |
| 编写 DTL | 立即留痕 | 本条 L-20260828-01（含步骤 9） | ✅ |
五、留痕同步¶
- 无跨 AI 协作，无需 COLLAB
- 关联产物：
ref/DOC-M10互联网应用平台需求分析方法技巧.md