zentao-flow/.agents/skills/pmassist-v3/references/dar.md

DAR 模板（缺陷分析报告）— pmassist-v3

使用说明：按 8D/根因分析思路组织，所有结论需引用证据。 涉及代码问题时优先查阅 CodeMap/DomainMap，支持精准根因定位。

---

0. 文档信息

字段	内容
缺陷编号	BUG-xxx
版本	v1.0
状态	分析中 / 已修复 / 已验证
作者
创建日期
最后更新

---

1. 缺陷概述

1.1 问题描述

简要描述缺陷现象，用一句话概括。

1.2 影响范围

维度	说明
影响用户数
影响业务功能
影响系统/服务
影响时间窗口

1.3 严重级别与优先级

项目	值
严重级别	P0（紧急）/ P1（严重）/ P2（一般）/ P3（轻微）
处理优先级	立即修复 / 本迭代修复 / 下迭代修复

---

2. 复现信息

2.1 复现步骤

1. 步骤一
2. 步骤二
3. 步骤三

2.2 期望结果 vs 实际结果

	描述
期望结果
实际结果

2.3 环境信息

项目	值
系统版本
分支/Tag
设备/网络
账号/角色

2.4 相关证据

类型	路径/描述
日志	[SRC-001]
截图	[SRC-002]
接口请求	[SRC-003]
监控数据

---

3. 时间线

时间	事件	操作人
	首次发现
	问题升级
	临时止损
	根因确认
	修复上线
	验证通过

---

4. 临时遏制措施（Containment）

4.1 当前止损方案

4.2 影响控制范围

---

5. 根因分析

5.1 直接原因

5.2 根本原因（5 Whys）

层次	Why	分析	证据
第1层	为什么出现缺陷？		[SRC-001]
第2层	为什么第1层原因存在？
第3层	为什么第2层原因存在？
第4层	为什么第3层原因存在？
第5层	根本原因

5.3 根因类型分类

• 代码逻辑错误
• 边界条件未处理
• 需求理解偏差
• 测试覆盖不足
• 配置/环境问题
• 第三方依赖问题
• 数据质量问题
• 其他：______

5.4 触发条件与边界

graph TD
    A[触发条件] --> B{边界判断}
    B -->|条件A| C[正常路径]
    B -->|条件B| D[Bug触发路径]
    D --> E[问题结果]

5.5 代码根因定位

引用 CodeMap/DomainMap 精准定位。

文件/类	方法	行号（约）	问题说明	证据
				[CODEMAP:...]

---

6. 纠正措施（Corrective Action）

6.1 修复方案

方案	描述	影响范围	风险	结论
方案 A（选定）				✅ 采用
方案 B				❌ 放弃

6.2 修复影响评估

维度	影响说明
影响模块
数据迁移	需要 / 不需要
接口变更	有 / 无
回归范围

6.3 回归验证要点

验证项	说明	负责人

---

7. 效果验证

7.1 验证方式与结果

验证项	方式	结果	时间
	自动化测试/手工测试	✅/❌

7.2 监控/指标变化

指标	修复前	修复后	变化

---

8. 预防措施与改进

8.1 预防机制

类型	措施	负责人	完成时间
监控告警
测试补充
流程改进
代码规范

8.2 长期改进计划

改进项	优先级	计划时间	负责方
	P1

---

9. 经验总结

9.1 经验教训

类别	教训	对应改进措施
研发
测试
运维
产品

9.2 可复用的规则/检查项

归纳为可在未来需求中复用的防范规则。

• {检查项1}
• {检查项2}

---

10. 证据与引用

• 引用 materials_index.md 中的 SRC-xxx
• CODEMAP/DOMAINMAP/RUNTIME 证据引用

---

11. 证据映射表（强制）

章节	关键结论	证据	状态
复现信息
根因分析
纠正措施
效果验证

---

12. 系统资产引用（强制）

资产类型	路径	用途
CodeMap
DomainMap
Runtime

---

图表要求（强制检查）

• 至少 1 个 mermaid 图（根因路径/修复流程/时间线任选）
• 至少 1 张表（影响范围/根因层次/预防措施等）