用途:为 Zoho Billing 提供端到端挽回流水线,把 recovery-cohort-builder 与 recovery-strategy 合并为一次运行,产出仅供人工审核的 Markdown 建议报告。代理不会发送邮件、应用折扣或修改任何记录,所有输出都是建议文件。
主要能力与流程:
- 拉取报告:调用 ZohoBilling_get_lost_opportunities_report 与 ZohoBilling_get_abandoned_carts_report,时间范围为最近 7 天(to_date 为今天,from_date 为今天减 7 个日历日)。
- 构建队列:将两类记录归一化为统一 schema,按 lost_value 降序排列(流失商机在前,弃购购物车在后),保存到 recovery-runs/<DATE>/cohort-raw.json。若两份报告均为空,向用户写简短说明并停止。
- 应用策略:运行 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。若脚本以退出码 2(缺少 catch-all)结束,停止并提示用户在矩阵 YAML 中添加后再运行。
- 写报告:按固定模板生成 recovery-runs/<DATE>/proposal.md,含摘要表、动作分布、流失商机与弃购购物车分节(按紧急程度分组:人工外联、带折扣邮件、邮件序列/提醒),以及后续步骤。
输出文件:cohort-raw.json(归一化队列)、cohort-recommendations.json(附逐条建议)、proposal.md(可读建议报告)。完成后确认路径并向用户展示摘要表。
适用场景:需要定期复盘流失商机与弃购购物车、按金额优先级安排销售与营销跟进的团队。
限制与边界情况:仅生成建议,不执行任何动作;单一来源为空时正常运行并省略空节;全部为 accept 时仍写报告并标注为健康信号;human_outreach 超过 50% 时向用户提示,可能需调整 YAML 中的价值阈值;日期跨月无需特殊处理,API 接受跨月范围。具体配置项、矩阵规则细节与运行环境要求暂未提供。