SuperAPI AI 工具集

offer-recommender

通用与其它

查看项目

更新于 10-16 06:51

技能介绍

用途:对已分类的订阅群体应用留存决策矩阵(config/retention-matrix.yaml 中的 pre_churn_matrix 或 win_back_matrix),为每行订阅生成推荐对象。纯规则评估,无 API 调用,结果确定,YAML 变更后可重复运行。

主要能力:输出追加到每行的 recommendation 对象,包含 action、params、rationale、rule_index、ltv_tier、ltd_tier。支持的 action 有 discount、pause、downgrade、human_triage、standard_offer、accept。脚本按 YAML 将 ltv(美元)和 ltd(天数)分桶为层级,自上而下遍历矩阵规则,首个匹配规则生效;空匹配 {} 为兜底规则,每个矩阵应以兜底规则结尾。

使用方式:运行 python <skill-path>/scripts/apply_matrix.py,参数为 --cohort、--matrix、--cohort-type(pre_churn 或 post_churn)、--output。随后检查摘要输出:human_triage 激增说明出现矩阵未覆盖的新原因分桶;出现 rule_index: -1 表示缺少兜底规则,应停止流水线并告知用户。最后向用户展示 action 计数摘要和按 MRR 排序的前 5 预览表,并确认输出路径。

限制与边界:缺少 LTV/LTD 时脚本默认按 0 处理,分桶为 low/new,由兜底规则处理;YAML 中未知 action 名称会原样传递,由编排层暴露;无兜底规则时脚本输出 rule_index: -1,需标记并停止。其他收费、平台等信息暂未提供。