OEE 分析改善技能

一、技能定位

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

适用场景：

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

不适用：

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

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

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

三、能力模块

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

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

四、交互协议（轻交互）

先确认数据与载体：用户是投文件、贴数字还是描述场景？图片/PDF 引导转写，Excel 直接读。
采集最小必需数据：计划运行时间、实际运行时间、总产量、合格品数量（4 项必需）；六大损失时间、标准节拍、每小时产值（可选，越全诊断越准）。
企业参数用默认值 + 标注：标准节拍默认 60s、产值默认 5000 元/h、年工时默认 2400h、目标 OEE 默认 85%——报告里一律标「默认值·待企业补充」。
针对性追问，不问卷：若数据明显矛盾（如 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 排名）暂未覆盖，可作为后续增强。