v1.4.1 · 业务正确性与自动验收

这次修了什么

v1.4.1 聚焦归因、时间、留存、利润和回本五个业务根基，不再把演示假设包装成事实口径。

• 新增触达—订单、券实例—核销订单、活动参与—订单三条公共事实桥；一笔订单在同一归因口径下最多命中一次。
• 私域与活动指标改为触达后/参与后关联 GMV；没有对照组时增量 GMV 和增量 ROI 保持为空。
• 统一 as_of_date，补齐 SCD2 时间关联、渠道前后窗口和新店 0–89 天边界。
• 重写月度 Cohort 留存与右删失；补门店月份/营业日骨架，保留零销售成本月与零订单日。
• 修复连续亏损、加盟回本起点、投诉-only 日期和券实例有效期。
• 拆分生命周期参数与门店会员占比预警参数；同步 24 张输出样本和当前看板字段文档。
• 新增 9 项业务不变量验收 SQL、32 项自动测试、GitHub Actions 与 SkillHub 发布包漂移门禁。

验证

• 32/32 本地与远端测试通过
• 175/175 SQL 代码块通过 Spark 方言静态解析
• 24 个变更输出与样本 schema 逐列一致
• 55 个结构定义 / 55 个样本 / 25 条 ETL 一致

可信边界

当前验证是 SQL 静态解析、内存语义夹具与样本合同，不等同于真实 Spark 3.4 集群及 129 万订单全量回放。ETL/逻辑SQL、ETL/公共口径 和当前页面文档是 v1.4.1 参考口径；原始 JSON 与页面 JSON 保留为 v1.4.0 历史快照。SQL 仍是上线前必须结合自家数据验证的参考示例，不是换表名即可生产的标准答案。

v1.4.0 能力边界深挖：十类活 + 公式库第 10 册《任务与触达回收》

这一版做了什么

从「会员数仓样板间」升级为「会员运营动作的决策数据层」——除社群与付费投放外，会员全生命周期的经典动作（召回 / 提频 / 防流失 / 新客转化 / 渠道迁移 / 任务分派）都能在库里找到"圈谁 → 何时 → 力度 → 派给谁 → 怎么回收"的完整数据依据链。

新增

• 公式库第 10 册《任务与触达回收》：白盒 NBA 任务池模型（21 列四段：输入/决策/执行/回收）、九类任务 × 优先级 × 圈选依据 × 动作映射对照表、任务生成 SQL 模板、防打扰与优先级仲裁两步收敛、任务漏斗四率回收口径（含归因窗口 / 对照组 / 双维度三坑）、差评客户挽回（从 dwd_评价 圈 P0 任务 + 挽回成功率口径）
• SKILL.md 两类新活：「业务动作要数据依据」与「搭 CDP / 标签体系 / 身份打通」，八类活 → 十类活
• 两张王牌立名片：白盒 NBA 任务池模型；param_ 参数表的阈值定标方法论（分布尾部拐点 + 店型分敏感档）

调整

• 触发词补齐：CDP / 标签体系 / 人群圈选 / OneID / 分群 / 召回 / 提频 / 防流失 / 流失预警 / 渠道迁移 / 任务分派
• 与 majia-siyu 的边界：从互斥改为"同一动作两半"协同——数据依据在本 skill，执行话术在 siyu，双向告知（siyu v1.4.1 已对向落地）
• 三条界外写明：付费投放回流模型 / 秒级实时触发 / 触达通道 API 对接
• RFM 两套口径互指：公式库 02 册（高低二分 8 类，快速起步）vs 样板间 ETL（5 分制 9 类，精细运营）
• 架构图重绘（十类活 + 新边界文案）、全部数字口径同步（公式库 10 册约 3100 行）、术语就地括注人话

数据仍全部为模拟生成，仅结构与口径可引用。

majia-huiyuan v1.3.2

修复

• 收紧触发范围：聚焦会员指标、RFM、复购/留存公式、SQL、数仓、字段词典、数据质量与会员看板。
• 新增与 majia-siyu 的互斥边界：朋友圈、群发、欢迎语、社群触达、企微动作和私域整盘诊断交给 majia-siyu。
• 同步更新 manifest、README 与功能架构图。

校验

• Agent Skill 规范校验通过。
• OTA 严格发布审计通过。

v1.3.1 · 文档装修：功能架构图 + 英文版 + 品牌后缀

文档装修版（内容零改动，纯展示面升级）：

• 功能架构图：新增 docs/architecture.svg + PNG（Chrome headless 2× 渲染）。一图看全三大资产（样板间 54 数据集/25 ETL/12 看板 · 公式库 9 册 2900 行 · 方法论实录 34 页直播）→ 五层数仓 DIM→DWD→DWS→ADS→DQC → 会员数据顾问八类活 → 与兄弟 skill majia-guanyuan 分工。README 与 SKILL.md（ClawHub 展示页）均以绝对 raw URL 嵌入 PNG。
• README.en.md：新增英文版，品牌后缀「· 马甲实战版」落地。
• 品牌后缀 pixel-perfect：SKILL.md H1 / README 副标题 / README.en 副标题 / GitHub About / ClawHub displayName 五处统一「· 马甲实战版」。
• 版本记录段 README + SKILL.md 均收敛到 ≤3 条，完整历史指向 Releases。

数据、公式、方法论内容与 v1.3.0 完全一致，老用户无需重装。

v1.3.0 · Skill 化：会员运营-马甲实战版

本仓库现在同时是一个 Agent Skill（SKILL.md + manifest.json 在仓库根部），装进 Claude Code / OpenClaw / Codex / WorkBuddy 即变成会员数据顾问。八类活：口径与公式咨询（复购跨天 vs 非跨天 / RFM 8 类×策略 / 核销 / 频次 3 口径）、从零设计会员数据体系（DIM→DWD→DWS→ADS 分阶段最小可用集）、现有体系缺口诊断（54 表 checklist）、生成建表 DDL、按角色规划看板、数据质量排障（NULL 三态 / 字段重名 / 对账）、方法论内训（五步动作链 / 可信四件套 / AI 会闭嘴）、观远 BI 整套复刻。安装：clawhub install majia-huiyuan / gh skill install maojiebc/majia-huiyuan / git clone 到 skills 目录。

v1.2.0 · 直播分享实录入库

新增 分享/区域运营的一天/：2026-07-09 观远「对话 AI Hero」直播（AI 创新赛一等奖作品）的书面整理版，34 页插画板全部嵌入，内容从直播逐字稿蒸馏——区域运营的痛点、AI 跑五步人拍板、可信四件套、三个现场演示案例（归因到人/会闭嘴/会多看一眼）、四类人群落地 FAQ 与当场问答摘编。演示数据环境即本仓库模拟中台，演示数据全部模拟生成。

v1.1.0 · 公式库并入

餐饮 BI 公式实战库从 majia-guanyuan 整体迁入本仓库 公式库/（README + 9 册约 2900 行）：复购（跨天 vs 非跨天）/ RFM 8 类×策略 / 核销折扣 / 通用字段词典 / NULL 三态坑 / DWD 宽表范式 / 39 生产 ETL 索引。README、AGENTS.md、llms.txt 三层导航同步更新。至此「开源会员运营家底」= 模拟中台（结构）+ 公式库（算法）。

v1.0.0 · 会员运营家底首发

整库快照首发：54 个数据集（DIM 10/DWD 16/DWS 16/ADS 8/DQC 1/param 3）、25 条 ETL 加工链、12 张看板。模拟规模：8 万会员 / 1200 门店 / 129 万订单。含结构定义、200 行/表数据样本、口径 SQL、观远原始 JSON，以及 AI Agent 友好层（llms.txt + AGENTS.md）。数据全部模拟生成，MIT 协议。