SuperAPI AI 工具集

recovery-strategy

通用与其它

查看项目

更新于 10-16 06:51

技能介绍

用途:把配置好的恢复矩阵规则应用到 recovery-cohort-builder 产出的标准化队列上,为每条记录追加行动建议,用于流失机会(lost_opportunity)与弃购(abandoned_cart)的挽回决策。支持的行动包括 human_outreach、email_with_discount、email_reminder、email_sequence、accept。

主要能力:纯 YAML 规则评估,无 API 调用。脚本按 YAML 中的 value 与 recency 分档,自顶向下匹配对应矩阵,首个命中规则生效。输出每条记录一个 recommendation 对象,包含 action、params、rationale、rule_index、value_tier、recency_tier。

使用方式:运行脚本

python <skill-path>/scripts/apply_recovery_matrix.py
--cohort <workspace>/recovery-runs/<DATE>/cohort-raw.json
--matrix <workspace>/config/recovery-matrix.yaml
--output <workspace>/recovery-runs/<DATE>/cohort-recommendations.json

之后检查汇总:若 human_outreach 配合 priority: urgent 明显增多,通常属新鲜高价值记录的正常表现;若出现 rule_index: -1,说明 YAML 缺少兜底规则,应停止并提醒用户修正矩阵;若 value_tier 或 recency_tier 为 null,说明上游归一化有问题,需回查队列。最后向用户展示行动计数汇总和按 lost_value DESC 排序的 top-10 预览表,并确认输出路径后再生成报告。

限制与边界:缺失 lost_value 时按 0 处理并归入 low,由兜底规则接管;缺失 days_since_event 时默认 recency: recent;YAML 中未知行动名会原样透传,由编排层上报;无兜底规则时输出 rule_index: -1 并应停止;检测到多币种时忽略币种分档并提示。