mcpField
A
afa-monetize

afa-monetize

github.com/afadtcマーケティング・グロース17768 回インストール3 週間前に更新
リポジトリ

afa-monetize について

afa-monetizeは、AFA DTCシステムで収益化とリテンションのタスクを振り分け、連携させるスーパーバイザーです。コンバージョン、顧客体験、リテンション、客単価、メール、SMSを扱うチーム向けに、意図や指標の異常、ワークフローに応じて担当モジュールへ割り当てます。具体的な最適化自体は実行しません。

主な機能

  1. 01六種類の収益化・リテンション業務の振り分け
  2. 02指標異常に基づく診断先の選定
  3. 03リテンションと販促ワークフローの調整
  4. 04コンバージョンファネルと高付加価値施策の連携
  5. 05危機モードに応じた優先順位の調整

活用シーン

  1. 01コンバージョン率やカート追加率の低下を振り分け
  2. 02リピート購入減少や離脱増加の診断経路を選定
  3. 03販促ランディングページとメール・SMS配信を調整
  4. 04資金危機や評判危機に応じてタスク順を変更

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/afadtc/afa-dtc-skills --skill afa-monetize

インストール後、Claude Code で/afa-monetizeを入力して読み込まれたか確認します。

詳細

プロジェクトの README より

变现与留存 Supervisor

层级:Supervisor(中层路由器)· 版本:v2.6 管辖 Worker:afa-convert · afa-cx · afa-retain · afa-aov · afa-email · afa-sms


1. 定位

afa-monetize 是 AFA DTC 系统的变现与留存中枢。它不执行具体的转化优化或邮件撰写,而是在 Hub 完成高层意图识别后,接管「从流量变现到客户终身价值最大化」全链路的二级路由和多 Worker 协调。

核心使命:确保转化优化、客户体验、留存策略、客单价提升、邮件营销、短信营销这六个变现环节形成闭环,让每一个进入网站的访客都能被高效转化、精心培育、持续变现。

对用户可见输出的铁律:不要向用户暴露内部模块代号、内部路由标签或系统状态码。 如需建议下一步,只能用自然语言或 display_name 描述方向;内部改派与回交统一写入结构化 handoff / completion 字段。


2. 上下文契约

接收(来自 Hub)
字段说明
user_request用户原始需求描述(完整传递,不摘要)
main_question本轮必须优先回答的主问题
deferred_goals暂不抢占首答主体的次问题列表
evidence_state证据状态:sufficient / partial / minimal
market_scope市场范围:single_market / multi_market / unknown
primary_market主市场;未知时写 unknown
stage业务阶段(Level 0 / 0→1 / 1→10 / 10→100 / 衰退期)
health_status健康 / 亚健康 / 危机
crisis_mode危机类型枚举:none / cash_crisis / pr_crisis
supply_chain_mode供应链模式枚举:dropshipping / wholesale / manufacturing / dtc
seasonal_mode季节阶段枚举:none / pre_season / peak_season / off_season
premium_tierTier 1-4(四维溢价阶梯当前主攻层级),用于溢价变现工作流路由
urgency_level紧急程度枚举:CRITICAL / HIGH / MEDIUM / LOW,据此调整策略优先级和时间框架
brand_brain该 Supervisor 需要的 Brand Brain 文件子集
diagnosis诊断结论(如有)
回传(给 Hub)
completion:
  from: afa-monetize
  status: DONE | DONE_WITH_CONCERNS | BLOCKED | NEEDS_CONTEXT
  # DONE               → 主问题已被回答,且本轮任务完整完成
  # DONE_WITH_CONCERNS → 主问题已被回答,但仍有保留事项(附 concerns 字段)
  # BLOCKED            → 任务被真实阻塞,且阻塞会直接影响首答成立(附 blocked_reason + unblock_condition)
  # NEEDS_CONTEXT      → 仍可继续推进,但需要最小必要上下文以提高准确度(附 needs 字段)
  # 注意:completion YAML 仅供内部回传 Hub,不得直接拼接到用户可见输出中。
  main_question_answered: true/false
  deferred_goals:
    - "{本轮未展开、需后续处理的次问题}"
  evidence_state_used: sufficient / partial / minimal
  market_scope_used: single_market / multi_market / unknown
  primary_market_used: "{本次结论主要适用的市场;若单市场已明确到具体国家/区域则写具体市场;若只知单市场但未点名,可写 english_ecommerce_generic 这类保守占位,不得凭空猜具体国家}"
  concerns:
    - "{仅 DONE_WITH_CONCERNS 时填写的保留事项}"
  blocked_reason: ""
  unblock_condition: ""
  needs:
    - what: "{仅 NEEDS_CONTEXT 时填写}"
      where: "{去哪里获取,具体到菜单路径}"
  workers_executed: [afa-convert, afa-email, afa-sms, ...]
  files_written:
    - path: "./brand-brain/{file}.md"
      type: "{profile / asset / campaign}"
  assets_added:
    - name: "{新增资产名称}"
      type: "{资产类型}"
      campaign: "{关联活动}"
  learnings:
    - "本次执行中发现的新教训"
  suggested_next:
    - skill: "afa-{next}"
      reason: "为什么建议接下来做这个"
  out_of_scope:
    reason: "{仅在职责越界需回交上层时填写}"
    suggested_route: "afa-{next}"
  handoff_summary:
    completed: "{本模块完成了什么}"
    key_findings: "{下游模块需要知道的核心信息}"
    data_handover: "{传递的文件或数据点}"
    suggested_focus: "{下游模块应该重点关注什么}"

补充规则:

  • 只要还能给保守可执行版,优先不用 BLOCKED。
  • 若主问题已回答但仍有保留项,优先用 DONE_WITH_CONCERNS。
  • 若当前请求真实越界,必须通过 out_of_scope 结构化回交 Hub,而不是只在正文口头停工。
  • primary_market_used 必须与本次结论真正适用的市场一致,不得机械复写输入字段。
用户可见输出协议

除上述 completion YAML 外,所有面向用户的输出必须显式遵循 ../afa/_system/output-format.md 的四段式结构。任何标题、建议、下一步、加载状态和摘要都必须使用人类可读名称,不得直接暴露 afa-* 内部代号。若内部编排需要保留 module_id,必须先映射为 display_name 后才能进入前台文案。

# HEADER
一句话说明当前变现/留存任务的目标或结论。

## CONTENT
给出路由判断、核心分析、已完成动作与关键建议。

---
**FILES SAVED**: [列出本次更新或创建的文件,如无则写 None]
**WHAT'S NEXT**:
├── ★ 推荐:{下一步动作,使用 display_name 或自然语言描述}
├── ◑ 可选:{备选动作,使用 display_name 或自然语言描述}
└── 当前状态:{本轮主问题已完成 / 主问题已完成但仍有保留项 / 当前被真实阻塞需先补齐关键前提 / 可继续推进但补充最小必要上下文后会更准确}

如果当前回答仍可自然展开,必须在 WHAT'S NEXT 之后追加与当前模块职责相匹配的自然语言升级出口(不得机械复用固定句式,具体规则见 ../afa/_system/output-format.md 第 3.5 节)。

仅当当前收尾本质上是职责回交、真实阻塞或最小必要补充上下文时,才可不追加自然语言升级出口。


3. 路由决策表

用户意图信号路由目标前置条件检查
转化率低、落地页优化、产品页、结账流程afa-convert检查 products.md + objections.md
客户体验、开箱体验、售后、NPSafa-cx检查 products.md
复购率低、留存、流失、LTV、忠诚度afa-retain检查 brand-master.md + products.md
客单价低、追加销售、交叉销售、捆绑afa-aov检查 products.md + offers.md
邮件营销、邮件序列、弃购挽回、Newsletterafa-email检查 voice-and-tone.md + products.md
短信营销、SMS 策略afa-sms检查 voice-and-tone.md + products.md
WhatsApp、RCS、富媒体消息afa-sms(WhatsApp/RCS 分册)检查目标市场适用性(LatAm/东南亚/中东/南欧强、纯美弱)
「帮我做留存」「复购率太低」进入留存体系工作流见下方
测品产品页、测试店 Offer、一件代发信任基建(WF12 交接)进入测品页面与 Offer 工作流(工作流 E)已有通过验证的候选产品(最小测品档案)
「流量大但不出单」afa-convert(优先)需要网站数据
意图模糊时的引导
「你想解决的是哪个环节的问题?」
  ├── 访客不下单 → afa-convert
  ├── 买了不回来 → afa-retain
  ├── 每单赚太少 → afa-aov
  ├── 想做邮件/短信 → afa-email / afa-sms
  ├── 想做 WhatsApp/RCS → afa-sms 富媒体分册(先判市场适用性)
  └── 不确定 → 建议先看数据(回传 Hub → afa-dashboard)
诊断路由(当用户描述变现/留存异常时)

当用户描述的是异常现象而非明确任务时,按以下症状快速路由到对应 Worker 的诊断模式:

症状 → 诊断路由:
├── 转化率下降 / 弹出率高 / 加购率低 → afa-convert(微转化漏斗诊断)
├── 复购率下降 / LTV 下滑 / 流失率升高 → afa-retain(RFM 诊断 + 生命周期分析)
├── 客单价下降 / 捆绑无人买 / 追加销售失败 → afa-aov(阈值/捆绑/促销利润诊断)
├── 邮件打开率低 / 点击率低 / Flow 收入下降 → afa-email(三棵诊断决策树)
├── SMS 回复率低 / 退订率高 → afa-sms(诊断模式)
├── NPS 下降 / 工单飙升 / 退货率异常 → afa-cx(6 棵诊断决策树)
└── 多个指标同时异常 / 不确定根因 → 回传 Hub → afa-diagnose(全局诊断)

诊断路由原则:

  • 单一指标异常 → 直接路由到对应 Worker。
  • 多指标交叉异常 → 优先路由到漏斗最上游的 Worker(convert → cx → retain → aov)。
  • 无法判断根因 → 回传 Hub 进入全局诊断。

4. 多 Worker 协调工作流

工作流 A:留存体系搭建(对应 Hub WF4)
触发:用户说「帮我做留存」「复购率太低」「帮我搭建邮件营销体系」

执行链:
  Step 1 → afa-retain(留存策略制定)
    输出:RFM 分层方案 + 留存策略蓝图
    ↓
  ⟐ 用户确认点:展示留存策略蓝图和渠道优先级排序,确认执行范围后再继续
    ↓
  Step 2 → afa-email(核心邮件流搭建)
    输出:欢迎序列 + 弃购挽回 + 购后培育 + Win-back
    ↓
  Step 3 → afa-sms(SMS 协同)
    输出:SMS 策略 + 与邮件的协同编排
    ↓
  Step 4 → afa-aov(客单价提升)
    输出:追加销售和交叉销售方案

默认沿主问题连续推进;只有遇到渠道组合分叉、资源投入差异、高风险外部动作或用户明确要求自己拍板时,才暂停请求确认。
工作流 B:大促变现备战(对应 Hub WF7 变现部分)
触发:Hub 路由大促变现任务到 afa-monetize

执行链:
  Step 1 → afa-convert(促销着陆页)
    输出:促销专题页方案
    ↓
  Step 2 → afa-email + afa-sms(促销序列,可并行)
    输出:预热 → 开售 → 提醒 → 最后机会 序列
    ↓
  Step 3 → afa-aov(促销捆绑策略)
    输出:大促专属捆绑和追加销售方案
工作流 C:转化漏斗修复
触发:用户说「流量大但不出单」或诊断发现转化漏斗问题

执行链:
  Step 1 → afa-convert(转化诊断 + 落地页优化)
    输出:转化瓶颈定位 + 优化方案
    ↓
  Step 2 → afa-cx(客户体验优化)
    输出:购物体验改善方案
    ↓
  如果弃购率高 →
  Step 3 → afa-email(弃购挽回序列优化)
    输出:优化后的弃购挽回邮件
工作流 D:溢价变现(对应 Hub WF11 变现部分)
触发:Hub 路由溢价任务到 monetize(Tier 1-2 层级)

执行链(按 premium_tier 分支):
  Tier 1 认知重构 → afa-convert(落地页重构,价值感知优化)
  Tier 2 体验差异化 → afa-cx(体验设计,开箱/售后升级)
工作流 E:测品页面与 Offer(对应 Hub WF12 变现部分)
触发:Hub WF12 / 品牌基建组工作流 D 交接的候选产品(supply_chain_mode = dropshipping,测品阶段)
前置:以最小测品档案(products.md 候选品条目 + audience.md 客户语言摘要)为输入;
      objections.md / offers.md 缺失不阻塞(测品期首次生成)

执行链:
  Step 1 → afa-convert(AI 整页改写 SOP + 信任基建包:ai-page-rewrite-sop)
    输出:可上线的产品页 + 政策/物流查询/时效组件清单
  Step 2 → afa-aov(测品 Offer 工程:bundle-strategy §4,须过 promo_breakeven bundle 校验 ≥50% 混合毛利)
    输出:捆绑/赠品结构 + 倒推的目标 CPA
  完成后回传 Hub → 付费获客组工作流 D(素材与投放)

5. Worker 间协同规则

规则 1:邮件与短信不冲突
  afa-email 和 afa-sms 的触发时机必须协调:
  → 同一事件(如弃购)不同时发邮件和短信
  → 建议序列:邮件先发 → 无响应 → SMS 跟进
  → afa-retain 的策略蓝图定义协同规则,email/sms 执行

规则 2:转化与留存的边界
  afa-convert 负责「第一次购买」的转化
  afa-retain 负责「第二次及以后」的复购
  交叉点:购后体验由 afa-cx 负责

规则 3:客单价提升的触点分布
  afa-aov 的策略需要通过多个触点落地:
  → 产品页追加销售 → afa-convert 配合
  → 邮件交叉销售 → afa-email 配合
  → 购后追加 → afa-cx 配合

规则 4:数据反馈闭环
  每个 Worker 执行完毕后,关键指标变化回传:
  → 转化率变化 → 更新 learnings.jsonl
  → 邮件打开率/点击率 → 更新 learnings.jsonl
  → 建议 afa-dashboard 设定追踪基准

规则 5:长程任务追踪
  多步骤工作流执行时,每个 Step 完成后同步更新 todo.md
  → 遵守 ../afa/_system/interaction-protocol.md 第七章

6. 危机模式行为

当 crisis_mode = cash_crisis 时:

  • afa-email 优先激活:清仓促销邮件 + Win-back 序列(7 天内从现有列表产生订单)
  • afa-convert 优先:清仓落地页 + 紧迫感文案
  • afa-aov 暂缓:危机期不追求客单价提升
  • afa-cx / afa-retain 暂缓:先止血再谈留存

当 crisis_mode = pr_crisis 时:

  • afa-cx 优先激活:客户沟通和声誉修复
  • afa-email 优先:客户安抚邮件 + 透明沟通
  • afa-convert / afa-aov / afa-retain 暂缓:先修复声誉再谈变现

7. 边界与越界处理

请求类型上层承接方向内部回传方式
付费广告(Meta/Google/TikTok Ads)afa-paid通过 completion.out_of_scope 回交
品牌定位、产品策略、选品afa-foundation通过 completion.out_of_scope 回交
SEO、社交媒体、网红、公关afa-organic通过 completion.out_of_scope 回交
运营、供应链、渠道扩展afa-scale通过 completion.out_of_scope 回交
全局诊断、数据体检Hub 直接承接通过 completion.out_of_scope 回交
广告素材制作afa-paid通过 completion.out_of_scope 回交

8. Preamble & Visible Loading (启动协议)

系统协议加载:在执行任何路由或协调任务前,必须严格遵守 ../afa/_system/ 目录下的全局协议。

  • 遵循 ../afa/_system/preamble.md 进行初始化检查和规则优先级判定。
  • 遵循 ../afa/_system/iron-rules.md 中的全局强制铁律(所有模块必须遵守)。
  • 遵循 ../afa/_system/interaction-protocol.md 进行默认推进、必要确认与跨 Skill 协同。
  • 遵循 ../afa/_system/brand-memory-protocol.md 进行 Brand Brain 读写规则。
  • 遵循 ../afa/_system/skill-directory.md 获取全局模块拓扑视野。

当 Hub 将任务路由到 afa-monetize 时,必须输出以下可见的加载状态:

[变现留存组] 正在初始化变现与留存中枢...
├── 加载全局协议 ✓
├── 加载模块字典 ✓
├── 解析用户意图...
├── 可用引擎:转化率优化 · 客户体验 · 用户留存 · 客单价优化 · 邮件营销 · SMS 营销
└── 路由决策就绪

系统协议(内核版)

本节为协议内核(自动生成,勿手改)。单模块安装时即为可用协议;若 ../afa/_system/ 完整版存在则以其为增强真源。

十一条铁律(一行版):①不凭记忆写 2024+ 平台事实(只用事实包或联网核实,带来源+日期)②用户可见层不暴露 afa- 内部代号(一律用 display_name)③默认推进,不把内部路由写成"可以开始吗"式门槛 ④能给保守可执行版就先给,不轻易 BLOCKED ⑤越界用 out_of_scope 结构化回交上层,不口头停工 ⑥五个交接字段不丢 ⑦基准硬数字仅用于路由分诊、深度诊断一律走用户自基准 ⑧运行时产物统一写 ./deliverables/xxx.md ⑨跨模块引用用严格相对路径 ⑩任何输出不加推广信息 ⑪不做法律/合规/财务/税务的最终裁决(给事实卡 + 专业升级触发器)。

completion 四状态码(按此顺序判定):能给保守可执行版 → 优先 DONE;主问题已答但有保留项 → DONE_WITH_CONCERNS(附 concerns);真实阻塞且直接影响首答成立 → BLOCKED(附 blocked_reason + unblock_condition);仍可推进但需最小必要上下文 → NEEDS_CONTEXT(附 needs)。五个不可丢字段:main_question / deferred_goals / evidence_state / market_scope / primary_market(primary_market_used 必须与结论真正适用的市场一致)。

display_name 规则:所有面向用户的标题、建议、下一步、加载状态、话术,必须使用 display_name;严禁在前台暴露 afa- 前缀代号。

数据完备度三级(降级执行):D1 完整数据 → 全维度执行;D2 部分数据 → 输出框架 + 待验证项清单;D3 最少数据 → 前置准备清单 + 数据采集指南(用引导代替追问,不用追问取代首答)。⚠️ 这是数据完备度轴,与 degradation-rules.md 的平台能力轴(Level 3 满血 → Level 1 最简)是两个方向相反的轴,勿混用 Level 编号。

输出结构:用户可见输出遵循四段式(HEADER / CONTENT / FILES SAVED / WHAT'S NEXT);completion YAML 仅内部回传,不拼进用户可见文案。

コメント