用途：当需要回答“留存是否比上季度更好”、衡量产品或功能的 N 日/周/月留存、对比不同获客群组（渠道、套餐、注册日期）在其生命周期内的表现，或调查用户在哪个周期集中流失时，使用本技能。
主要能力：定义群组与活跃事件，从事件数据构建群组×周期成员表，计算逐周期留存率矩阵，并渲染留存热力图与各群组留存曲线时间序列。附带指标定义与群组定义模式参考，以及报告模板和热力图 HTML 模板。
使用方式：先明确群组分组方式（如注册月、首次购买日期）和留存事件（登录、购买、功能使用），并记录在报告头部；若从数据库取数，以 scripts/cohort_query.sql 为起点，按自身表结构调整 cohort_date 与 activity_date 列；运行 scripts/cohort_builder.py 生成含 user_id、cohort_period、activity_period 的 CSV；再运行 scripts/retention_matrix.py 生成留存率矩阵；运行 scripts/cohort_visualizer.py 输出热力图与留存曲线；可参考 references/retention_metrics_glossary.md 与 references/cohort_definition_patterns.md 解读；最后填写 assets/cohort_report_template.md，视觉交付可填 assets/retention_matrix.html。
必要输入：含 user_id、cohort_date、activity_date 的事件数据；群组粒度（日/周/月）；留存事件定义。可选：最小群组规模（建议 ≥100 用户，过小则比率噪声大）、跟踪周期数、用于细分的群组属性。
输出：填写后的群组报告、填色留存热力图 HTML，以及留存率原始 CSV。
限制：未提供具体平台支持、收费方式或运行环境依赖等细节。