Similar-Work Rank 是用于工单辅助的确定性技能,核心作用是对某资产的历史工单按与当前工单的相似度进行排序,并基于历史修复记录识别重复出现的故障,以及在存在新修复说明时给出可取代旧方案的修复建议。
用途与运行时机:该技能应在知识检索(knowledge-retrieve)之后、每次运行时执行。它回应用户诸如“最接近的既往修复是什么”“我们之前做过这个吗”“这是不是一次重复故障”等问题。
输入:需要符合 mfg.work-order-assist.v1 契约的载荷,包含 issue_keywords[]、required_parts[]、retrieved.prior_fixes[] 和 history.prior_work_orders[]。
使用方式:先按契约验证载荷,然后运行 scripts/similar_work.py --intake wo-intake.json --out similar-work.json。所有相似度计算均在引擎中完成,模型不得用文字重述或重新计算任何相似度分数,只能逐字引用引擎输出。随后输出填充了 similar_work[] 与 superseding_fix{} 的契约载荷,并附带初步的 next_best_action。
主要能力与输出:similar_work[] 包含 rank、wo_id、similarity_score、shared_signals、outcome、recommended_fix、repeat_failure、confidence、source=engine:similar_work 和 citation;superseding_fix{} 给出取代性修复建议;history.repeat_promotion 记录重复故障的提升结果。
依据要求:每个相似匹配须携带其 CMMS 记录引用;重复故障提升须引用 references/similar-work-rules.md #3.1;取代性修复须引用其修复说明 ID 及 #3.3。
限制与上报:不在此处理备件就绪问题;不得因为 SOP 规定而压制重复故障或取代修复的发现。当最高匹配低于 0.75 置信度、没有可比历史或检测到重复故障时,引擎会向 escalations[] 添加条目,需对外呈现,并将重复故障转交 RCA(参考 similar-work-rules.md #4.1-#4.3)。