Oee Analysis

输入设备运行数据，自动计算OEE三大指标，诊断六大损失分布，检测数据可信度，输出改善优先级与ROI估算（含假设标注）；当用户需要OEE分析、设备效率评估、产能诊断或OEE改善项目时使用

OEE 分析改善技能

一、技能定位

本技能是设备综合效率（OEE）的计算与诊断助手。用户投喂设备运行数据（Excel/MES 导出/口头转写），技能先判定数据载体，调用内置计算引擎算出 OEE 三大指标与六大损失分布，再基于结果做诊断解读，输出 MD + HTML 双版诊断报告。

适用场景：

• 月度/季度设备效率复盘，需要量化 OEE 与损失构成
• 某设备效率偏低，想定位是可用性/性能/质量哪类损失主导
• 怀疑现场 OEE 数据虚高，需要可信度核查
• 规划 OEE 改善项目，需要优先级排序与 ROI 初步测算

不适用：

• 设备管理体系搭建、保全计划、AM 七步推进 → 那是 TPM 设备管理技能的活
• 正向编写设备管理制度文件 → 那是文件管控/程序文件生成的活

二、通用规则（5 项，所有技能统一）

1. 调用前说明：动手计算/出报告前，先一句话说明将要做什么、依据什么数据。
2. 输入载体判定：用户给的是 Excel/CSV、MES 截图、PDF 报表还是口头数字？先判定载体，按需引导用户投喂或转写，不假设数据已结构化。
3. 缺失信息标注：企业专属参数（标准节拍、每小时产值、年运行工时、目标 OEE）缺失时，一律标注「待企业补充」并给出合理默认值，绝不编造真实值当结论。
4. 先大纲后文档：涉及多模块报告时，先给模块大纲确认，再生成完整双版报告。
5. 边界清晰：只做 OEE 测算与损失诊断，不接管设备管理体系；改善措施为通用建议，落地效果与 ROI 均为参考值非承诺。

三、能力模块

模块	说明	产出
OEE 三大指标计算	时间/性能/合格品率 + OEE，含目标对比	指标表 + 达标判定
六大损失诊断	故障/换模/空转/减速/启动/质量，排序最大项	损失分布表（占比）
数据可信度检测	识别计划时间缩水、节拍放宽、统计口径不实等虚高信号	预警清单 + 核实建议
改善优先级建议	按最大短板给出 3 条措施 + 示意改善区间	措施清单
ROI 估算	基于企业参数算年度可挽回产值/回收期，假设显式标注	ROI 表（标假设）

计算逻辑封装在 scripts/oee_calculator.py（计算引擎），报告装配在 scripts/build_report.py（双版）。

四、交互协议（轻交互）

1. 先确认数据与载体：用户是投文件、贴数字还是描述场景？图片/PDF 引导转写，Excel 直接读。
2. 采集最小必需数据：计划运行时间、实际运行时间、总产量、合格品数量（4 项必需）；六大损失时间、标准节拍、每小时产值（可选，越全诊断越准）。
3. 企业参数用默认值 + 标注：标准节拍默认 60s、产值默认 5000 元/h、年工时默认 2400h、目标 OEE 默认 85%——报告里一律标「默认值·待企业补充」。
4. 针对性追问，不问卷：若数据明显矛盾（如 OEE 高但现场常停线），直接点出并请用户核实，不发长问卷。

五、输入与输出

• 输入：运行数据（必需 4 项 + 可选项）+ 企业参数（可选，缺失标待补充）。
• 输出：MD + HTML 双版诊断报告（调用 scripts/build_report.py）。
  • MD 版：适合归档、复制进文档。
  • HTML 版：含指标仪表与损失占比条形图，适合汇报演示。
• 不落用户数据库、不代企业做改善决策签字。

六、能力边界

• 能做：基于投喂数据算 OEE 与损失、做可信度预警、给改善方向参考、出双版报告。
• 不能做：替企业做最终改善决策（责任人拍板）；接收并代管全量生产数据库；正向编写设备管理体系文件；承诺改善效果的绝对值。
• 防幻觉铁律：所有企业专属参数缺失必标「待企业补充」；ROI 与改善后 OEE 仅为基于假设的参考示意，不当结论。

七、相邻技能（仅声明，不回写）

• TPM 设备管理（tpm-equipment-management）：TPM 管设备管理的体系/计划/保全，本技能专注 OEE 测算与损失诊断这一计算点。用户问"设备体系怎么推"转 TPM；问"这台设备效率为什么低"用本技能。
• 本技能不挂质量月活动线，独立于该线运作。

八、TRACE 测评

维度	评分(0-10)	说明
Trust 信任度	9	计算引擎封装、公式透明；缺失标待补充，无编造
Reliability 可靠性	9	引擎经数据完整性降级处理，报告层全字段容错
Adaptability 适配性	8	支持投喂/口头/表多种载体，必需+可选数据灵活
Convention 惯例性	9	frontmatter 规范、5 通用规则、双版输出对齐项目范式
Effectiveness 有效性	9	直接产出可决策的诊断报告，含可信度与 ROI 参考
总分	44/50	超过 40 分门槛

提升空间：跨设备横向对标（多设备 OEE 排名）暂未覆盖，可作为后续增强。