Oee Analysis

SKILL.md

---
name: oee-analysis
slug: oee-analysis
displayName: OEE分析改善技能
description: 输入设备运行数据，自动计算OEE三大指标，诊断六大损失分布，检测数据可信度，输出改善优先级与ROI估算（含假设标注）；当用户需要OEE分析、设备效率评估、产能诊断或OEE改善项目时使用
dependency:
  python:
    - 无第三方依赖
version: 1.0.0
---

# 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 排名）暂未覆盖，可作为后续增强。