用途
afa-retain 是一个面向 DTC（直接面向消费者）品牌的用户留存与 LTV（客户终身价值）增长技能模块，自我定位为「首席留存官」。其职责范围限定在留存健康体检、客户生命周期管理、忠诚度计划设计、订阅防流失、召回体系和群组分析。触发词包括：留存、retention、复购、LTV、流失、churn、会员、订阅、win-back、RFM 分层、repeat purchase、loyalty program、subscription 等。
主要能力
模块按用户意图路由到不同工作模式：
- Mode 1 全面留存体检：留存诊断、复购率分析，加载基准数据与 RFM/LTV 框架。
- Mode 2 生命周期架构设计：设计客户旅程、生命周期自动化、购后序列，基于六阶段生命周期框架。
- Mode 3 忠诚度计划设计：会员体系、忠诚度计划、积分系统。
- Mode 4 流失预防与订阅优化：应对流失率高、订阅取消、Dunning（催付）等场景。
- Mode 5 召回体系编排：召回流失客户、Win-back、再激活。
- 诊断模式：针对留存率下降、LTV 失调、VIP 流失等指标异常，按症状进入对应决策树。
- 群组分析模式：群组分析、队列解读。
底层框架包括：五维留存健康检查（复购行为 / 客户价值 / 流失模式 / 互动健康 / 留存经济学）、RFM+JTBD+LTV 整合分层（11 大客群矩阵）、六阶段客户生命周期、无利润侵蚀 LTV 增长模型。诊断完成后使用 ICE 框架（Impact × Data Basis × Ease）对问题排序，输出优先行动清单。
使用方式
执行前必须加载 Brand Brain 文件：必需 products.md，可选 audience.md、learnings.jsonl、offers.md、brand-master.md；明确禁止使用客户个人隐私数据（PII）和未经脱敏的购买记录。
模块不是独立入口，执行前需承接 Hub / Supervisor 已编译的共享上下文，包括 main_question、goal、deferred_goals、evidence_state、market_scope、primary_market、subscription_mode、lifecycle_stage、seasonal_mode、crisis_mode 等字段。若上游未提供，按最小可执行继承处理，先给保守起步版，并把待校准项放入验证清单。
首次唤醒时输出可见加载状态，显示 products.md 等文件的加载情况与留存数据就绪度。工作流分五个阶段：边界检查与上下文收集、意图路由与模式选择、诊断（指标异常时触发）、框架应用与执行、防护与质量检查。
输出遵循四段式结构（HEADER / CONTENT / FILES SAVED / WHAT'S NEXT），并附内部 completion 回传，包含 status、main_question_answered、evidence_state_used、market_scope_used、primary_market_used 等字段。
适用场景
适用于 DTC 电商品牌的复购提升、会员与忠诚度体系搭建、订阅制防流失、沉睡客户召回、群组留存分析等场景。支持季节性模式（如淡季留存策略）与危机模式（cash_crisis 时转向低成本高回报动作）。
限制
模块仅负责留存与 LTV 领域，若需求属于邮件/短信文案、落地页转化、仪表盘搭建、获客成本或客单价策略等，会通过 out_of_scope 结构化回交上层，不直接回答。不做法律、合规、财务、税务的最终裁决。信息不足时按数据完备度三级降级执行，先给保守可执行版而非直接阻塞。具体收费、价格、平台支持范围等资料暂未提供。