SuperAPI AI 工具集

retention-orchestrator

通用与其它

查看项目

更新于 10-16 06:14

技能介绍

用途:该技能用于端到端运行完整的留存(retention)流水线,面向任何留存运行请求。它只生成提案,写入 Markdown 报告供人工审核,绝不调用动作端点(不关联优惠券、不暂停、不更新)。

主要能力与流程:拉取队列(churn-cohort-builder)→ 分类原因(cancel-reason-classifier)→ 套用矩阵(offer-recommender)→ 写入 retention-runs/<DATE>/retention-proposals.md。

使用方式:先做预检,确认当前会话具备三个 Zoho Billing 工具:ZohoBilling_get_non_renewing_subscriptions_report、ZohoBilling_get_churned_subscriptions_report、ZohoBilling_list_organizations;缺失则停止并提示在 Settings → Connectors → Zoho Billing 启用。通过 list_organizations 获取 org ID,多个时询问。默认范围同时覆盖流失前(未来 30 天)与流失后(过去 7 天),用户显式指定则遵从。若当日报告已存在,询问覆盖或用 -rerun-<n> 后缀。

步骤:并行拉取两个队列(per_page: 100),写入 cohort-pre_churn.json 与 cohort-post_churn.json,空队列跳过;对每个非空队列运行 classify_reason.py(--cohort、--matrix config/retention-matrix.yaml、--output),未知率超 10% 时更新 YAML 分类并重跑;再运行 apply_matrix.py(含 --cohort-type pre_churn|post_churn),出现 rule_index: -1 则停止(矩阵缺兜底规则);最后按固定章节顺序(discount → pause → downgrade → human_triage → standard_offer → accept)写提案报告,含摘要、建议与备注标记。

限制与边界:仅提案不执行;两个队列皆空时写 empty-run.md 并跳过提案文件;LTV 全为 0 时在备注标记(可能数据未接入);YAML 解析错误则报错停止。具体价格、平台支持等信息暂未提供。