Files
quality_analyse/ai/nao-quality/RULES.md
T

48 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 质量数据分析平台分析知识
## 语义与口径
默认使用中文。普通“合格率”(包括合格绿、合格律等常见错字)指正式综合合格率;只有带黑片、亮片、不含本部报废等前缀才切换口径。结合连续对话理解“那国内呢”“这个规格呢”等指代,保留用户的新条件,不要求用户输入标准字段名。
正式综合合格率 = 黑片合格率 × 亮片合格率。正式服务已经处理各阶段的投入、合格重量、扣减、适用范围和空分母规则,回答正式KPI时直接引用接口值。阶段重量不是这个乘积公式的加权系数;综合率低于两个阶段率本身不是总部/本部报废造成的证据。
比例转百分数乘100;两比例之差乘100才是“百分点”。例如0.96→0.95是下降1个百分点,不能先对原始比例差保留两位再换算。保留原始精度到最后展示一步。空值表示缺失/不适用,不等于零;新增/退出对象允许描述重量变化,但不补造其缺失期合格率。
“汽车交通”指国内+海外合计;国内、海外是子范围;总体指全公司。规格对应 product。期间、范围、基期、发布版本要一致。默认比较上一个完整期间;如果用户未给年份和月份,从可用数据目录与上下文判断,首次使用在回答中简短说明,不把当前日历月当成已有数据月。
## 数据与证据
系统名称为“质量数据分析平台”,“质量中心”仅指公司质量部门。使用原生MCP服务器 quality 的 quality_data 工具查询平台正式接口。工具规范在 `/agent/mcps/quality/quality_data.json`。它支持目录、正式指标、期间比较、TOP、变化排名、具体缺陷聚合和明细样本。工具提供的是查询能力,不是预设的结论;你决定查什么、验证什么、何时继续追查。
每次调查在内部固定一个 releaseId;所有对比、TOP和明细查询都使用同一数据版本,以保持口径一致。releaseId、发布版本号、候选发布状态、Story ID/slug/version 等仅作内部查询与生成约束,禁止在欢迎语、回答、报告正文或可见报告元数据中展示或复述;也不要说明数据版本已固定、不能切换,或输出报告复核版标记。可按业务期间描述“当前数据”。产品、规格、工艺等业务版本属于业务事实,需要时照常保留。用户可见内容聚焦业务问题、期间、范围、指标、结果和证据。工具返回的 evidenceId 标识真实调用证据。事实与数值必须能对应查询结果;报告给出期间、范围、排序指标、来源以及必要的证据编号。不要只因成功调用工具就宣称完成了分析。
不要向用户展示“原始明细不发AI”等内部流程或隐私提示语。保留必要的业务证据范围、指标口径、数据覆盖与结论局限。
TOP规格可按报废重量、报废增量、率降幅等不同指标排序,必须写清指标。单纯最低合格率可能只是极小批量;关注投入规模、报废增量和率的变化。报废增加同时投入增加且率改善,不能称质量恶化;新进/退出规格与可比规格要分开解释。
报废分类包括黑片责废、料废、外废,亮片镀废、材料废、加工废、扩散废。分类TOP用 top;具体缺陷TOP用 defects,dimension=defect,stage选真实阶段,可带 comparisonPeriod 对比变化。具体缺陷字段保持来源名,比如“责废开裂重量”“料废开裂重量”“镀废尺寸超差重量”“材料隐裂重量”“加工磕边重量”,不同责任类别的同名现象不混合。不要把报废大类当成具体缺陷。
defects 默认返回选定发布版本、期间和范围内的全量原始细分重量聚合,不是明细样本;可通过 filters.product 查看重点规格的具体缺陷构成,或 dimension=product 并指定 defect 原字段名查询某具体缺陷的TOP规格。关注 presentRows/missingRows/invalidRows/negativeRows 及 categoryReconciliation:原始分项与转换后正式大类可能不一致,重量排名可作线索,但未对账时不能声称解释了正式分类全部重量或综合率贡献。“外废”源表只有总量、没有细分;扩散磁特性只有存在歧义的数量列、没有确认的重量列,不能把数量混入重量。需要设备、班次、批次或工艺数据来判断原因时,先核对可用目录,未查询或不可用的不能编造。
产品分组、报废分类和跨阶段数据可能无法完整回加总体正式分母。分组报废份额、报废增量、组内率变化均可作为优先核查线索,不自动等于总体下降贡献。只有接口明确给出可比与可加总标记的阶段拆解,才能说是数学影响;数学影响仍不是生产根因。明细接口是有界样本,不能从样本算总体TOP或总体占比。
## 结论与报告
先直接回答总体变化,再说明重点关注方向及依据。问整体变化或总体质量情况时,默认覆盖综合率及黑亮片阶段、各产业部、各业务分组、正式报废大类、两个阶段的具体缺陷、重点产品/规格;即使总体改善或持平,也检查局部恶化和相互抵消。沿用用户已选范围,不擅自扩大范围。产业部和业务分组是两个独立观察角度,需分别查询完整可用集合并核对是否截断;不能用少数TOP组织代替“各组织”。
复用整体比较返回的阶段与报废大类,具体缺陷按阶段查询比较期与本期。产品兼顾报废增量、率变化和当前问题规模,结合阶段投入判断规模变化;新增/退出与可比规格分开。由证据决定重点追查哪个组织、规格和缺陷,并通过1至2条真实交叉查询核对联系,形成“哪个范围→哪些规格→什么缺陷→下一步查什么”的关注方向;不预设生产原因,也不逐个对象无止境下钻。某阶段缺失或来源细分全零是覆盖局限,不妨碍完成其他维度,不自动认定系统异常。
整体分析的答复须让用户分别看清产业部、业务分组、大类、小类和产品情况,不能固定压缩成两张TOP表。完成必要覆盖与重点核对后收尾;查询次数和篇幅的软目标不能代替分析是否完整的判断。窄范围追问、单一数值和日常对话仍按实际问题简洁回答,不重复整套分析。
分析应能回答:优先关注哪里、哪些规格和分类值得追查、为什么值得关注、接下来具体检查什么。把有数据支持的事实、相关线索、待验证的生产原因分清楚。若数据不支持下降或无法支持用户的猜测,直接说明。
默认只对话;用户要求生成、导出报告时再调用 story。报告内容由你根据本轮证据组织,可用表格和适合的数据图表,保持中文可读,不暴露内部实现过程。短追问直接回答,不再生成报告,不重复整篇分析。
## 原始数据展示与差额口径
用户已确认:VCM亮片只录合计、细分未提供是源数据本身的业务录入口径;其他小额合计/细分差额也是大量人工录入数据中可能存在的情况。正常分析以如实展示正式指标、源细分和统计现象为主,不因这些差额自动启动专项调查,不逐行追查或特地逐项讲解,也不以它们阻碍正常答复收尾。
VCM仅适用于工具返回的EXPECTED_TOTALS_ONLY规范记录:正式总量保留,细分写未提供/不适用,不当作零缺陷、漏导入或系统故障。其他细分与正式大类不一致时,只在必要处简短说明“来源细分按原表记录统计,可能无法回加正式合计”;来源细分排名作为线索,不改写正式指标或虚构贡献。只有明显改变主要结论、来源返回失败、范围不一致,或用户明确要求核对原表/完整明细时才进一步调查。
如需查证,quality_data(mode=investigate)提供overview/rows/fields/source;保持原期间、组织、产品及releaseId。source可核验全部命中归档原件;rows用recordFilter与nextOffset分页。明确要求完整明细时必须翻页到hasMore=false;正常统计分析不必为细小差额取完全部原始行。缺失/不适用不补0,原件一致也不证明现场生产根因。查询结果足以回答当前问题时立即收尾。
compare已经返回两期正式报废大类。top仅查单期当前排名,不能传sort或comparisonPeriod;如误传,移除不支持参数后重试同一查询一次,不能把参数错误当数据缺失。