mcpField
A
afa-scale

afa-scale

github.com/afadtcMarketing & growth17769 installsUpdated 3w ago
Repository

About afa-scale

afa-scale is an AFA DTC supervisory skill for coordinating operations and growth planning. It routes requests across operations, channel expansion, and payment-risk work, and requires an operational-readiness assessment before expansion.

Key features

  1. 01Route operations requests
  2. 02Plan channel and market expansion
  3. 03Route payment-risk requests
  4. 04Coordinate multiple work engines
  5. 05Assess readiness before expansion

Use cases

  1. 01Choose between operations work and channel growth
  2. 02Check readiness before entering a new market
  3. 03Coordinate supply-chain operations with channel planning

Install

Copy the command and run it in a terminal.

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

After installing, type/afa-scalein Claude Code to confirm it loaded.

Details

From the project README

运营与扩张统筹层

层级:Supervisor(中层路由器)· 版本:v2.6 管辖 Worker:afa-ops · afa-expand · afa-payments


1. 定位

运营与扩张统筹层是 AFA DTC 系统的运营与扩张中枢。它不执行具体的供应链管理或渠道拓展操作,而是在 Hub 完成高层意图识别后,接管运营效率优化和业务扩张规划的二级路由和协调。

核心使命:确保供应链运营和渠道扩张这两个规模化引擎协同工作,在运营基础稳固的前提下推动业务扩张,避免「扩张速度超过运营能力」的常见陷阱。

对用户可见输出的铁律:不要向用户暴露内部模块代号、内部路由标签或系统状态码。 如需建议下一步,只能用自然语言或 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-scale
  status: DONE | DONE_WITH_CONCERNS | BLOCKED | NEEDS_CONTEXT
  main_question_answered: true/false
  deferred_goals:
    - "{本轮未展开、需后续处理的次问题}"
  evidence_state_used: sufficient / partial / minimal
  market_scope_used: single_market / multi_market / unknown
  primary_market_used: "{本次结论主要适用的市场}"
  concerns:
    - "{仅 DONE_WITH_CONCERNS 时填写的保留事项}"
  blocked_reason: ""
  unblock_condition: ""
  needs:
    - what: "{仅 NEEDS_CONTEXT 时填写}"
      where: "{去哪里获取,具体到菜单路径}"
  workers_executed: [afa-ops, afa-expand, afa-payments, ...]
  files_written:
    - path: "./brand-brain/{file}.md"
      type: "{profile / asset}"
  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. 路由决策表

3.1 afa-ops 路由(运营效率引擎)
用户意图信号对应 Worker 工作模式前置条件检查
利润、成本、定价、毛利率、单位经济Mode 1: 单位经济审计products.md + COGS 数据
库存、断货、积压、补货、周转Mode 2: 库存健康检查全SKU库存清单 + 90天销售数据
发货、3PL、退货、物流、配送Mode 3: 履约优化3PL费率 + 退货数据
招人、团队、组织架构、外包、VAMode 4: 团队架构规划当前团队结构 + 月收入范围
自动化、工作流、API、集成Mode 5: 自动化蓝图当前手动流程清单
供应商、断供、交期、供应链风险Mode 6: 供应链风险评估供应商清单 + 采购记录
现金流、对账、支付失败、财务Mode 7: 财务运营优化财务数据 + 支付系统报表
对账口径、争议准备金记账Mode 7(财务运营)财务数据
PayPal 纠纷、争议率、冻结、风控→ afa-payments(见 3.3,勿再进 ops)近期争议率 / 事件数
3.2 afa-expand 路由(全渠道扩张引擎)
用户意图信号对应 Worker 工作模式前置条件检查
扩展新渠道、评估渠道、渠道多元化Mode A: 渠道评估products.md + brand-master.md + 当前渠道数据
入驻 Amazon、TikTok Shop、Etsy、WalmartMode B: Marketplace 入驻执行MEURO 评估通过 + 库存确认
做批发、零售商进货、FaireMode C: 批发计划设计COGS 数据 + brand-master.md
跨国扩张、新市场、国际化Mode D: 国际化进入规划brand-master.md + 当前市场数据
线下零售、Pop-up、实体店Mode E: 线下零售进入品牌定位 + 库存能力
渠道表现不好、渠道冲突、蚕食Mode F: 渠道健康审计各渠道收入/毛利/CAC 数据
3.3 afa-payments 路由(支付风控引擎)
用户意图信号对应 Worker 工作模式前置条件检查
争议率高、VAMP、被封号风险Mode A: 争议率健康与 VAMP 自查近期争议率 / TC 事件数
收到 chargeback、要反驳Mode B: chargeback 反驳 SOP订单 / 物流 / 沟通记录
Stripe/PayPal 冻结、Rolling ReserveMode C: 冻结应对网关 / 冻结通知
支付方式选型、BNPL、欺诈过滤Mode D: 支付组合与欺诈过滤目标市场 / 现有网关

争议率根因若在物流/客服,payments 会回交 afa-ops / afa-cx。

3.4 意图模糊时的引导
「你想优化现有运营,还是拓展新渠道/新市场?」
  ├── 优化运营 → afa-ops(根据具体痛点匹配7个模式之一)
  ├── 拓展渠道/市场 → afa-expand(根据具体方向匹配6个模式之一)
  ├── 支付争议/冻结/风控 → afa-payments
  └── 两者都想 → 先执行运营准备度评估(见§5),再规划扩张

4. 多 Worker 协调工作流

工作流 A:渠道扩展(对应 Hub WF8)
触发:用户说「想拓展新渠道」「要不要做亚马逊」「怎么做批发」

执行链:
  Step 1 → afa-expand(Mode A: 渠道评估)
    ├── 当前渠道全景扫描 + HHI 指数
    ├── 候选渠道 MEURO 五维评估
    └── 输出:渠道机会评估报告
    ↓
  ⟐ 用户确认点:展示评估结果,确认用户选择的优先渠道
    ↓
  Step 2 → 根据评估结果分支:
    新广告渠道 → 回传 Hub,建议路由 afa-paid(afa-tt / afa-gg)
    网红营销 → 回传 Hub,建议路由 afa-organic(afa-influencer)
    品牌公关 → 回传 Hub,建议路由 afa-organic(afa-pr)
    线下/批发/亚马逊 → afa-expand(深度规划,Mode B/C/D/E)
    ↓
  Step 3 → afa-ops(运营准备度评估,见§5)
    ├── 确认运营基础能否支撑扩张
    └── 输出:运营准备度报告 + 需要补强的环节
    ↓
  ⟐ 决策点:运营准备度 ≥ 绿灯 → 执行扩张;黄灯 → 先补强再扩张;红灯 → 暂缓扩张
工作流 B:运营体系搭建
触发:用户说「帮我优化运营」「供应链有问题」「退货率太高」

执行链:
  Step 1 → afa-ops(诊断,匹配6大诊断模式之一)
    ├── 利润侵蚀诊断 / 库存健康诊断 / 履约效率诊断
    ├── 客服运营诊断 / 团队瓶颈诊断 / 供应链风险诊断
    └── 输出:运营健康度报告 + 瓶颈定位 + ICE 排序
    ↓
  ⟐ 用户确认点:展示诊断结果和优先级排序,确认优化方向
    ↓
  Step 2 → afa-ops(针对性优化,匹配7大工作模式之一)
    └── 输出:SOP + 改善方案 + 实施时间表 + 验证指标
    ↓
  如果涉及供应链模式升级(如 Dropshipping → DTC):
  Step 3 → afa-expand(供应链升级路径规划)
    └── 输出:升级路线图 + 成本对比
工作流 C:Dropshipping → DTC 过渡
触发:supply_chain_mode = dropshipping 且用户表达升级意愿;
      或 Hub WF12(测试店快速测品)跑出达标赢家后转入(赢家品牌化入口)
      WF12 入口最低门槛:验证档 Scale 出口达成后,连续 2 周 CPA 持续达标或日均 ≥10 单;
      未达门槛只做 Step 1 评估、不启动私标/囤货

执行链:
  Step 1 → afa-ops(Mode 1: 单位经济审计)
    └── 输出:当前供应链成本结构 + 痛点 + 盈亏平衡分析
    ↓
  ⟐ 用户确认点:展示当前成本结构,确认升级意愿和可投入资源
    ↓
  Step 2 → afa-expand(DTC 过渡规划)
    └── 输出:分阶段过渡方案(私标→小批量→自有库存→3PL)
    ↓
  完成后回传 Hub,建议更新 supply_chain_mode;
  来源为 WF12 时,suggested_next 指向品牌基建组工作流 A 的 Step 3(品牌定位)起,
  Step 1-2 以测品期积累的 products.md / competitors.md 为输入

5. 运营准备度评估(扩张前置检查)

当任何扩张计划启动前,必须对以下7个维度进行运营准备度评估:

维度评估标准红灯(暂缓扩张)黄灯(先补强)绿灯(可执行)
物流覆盖能否覆盖新市场/新渠道无法覆盖且无备选方案可覆盖但时效/成本不达标已有成熟物流方案
库存承载库存能否满足增量需求断货率 >5% 或无法增加采购需要额外采购但供应商可支持安全库存充足
客服能力客服能否支持新渠道FRT >4h 且无扩容方案需要增加人力或自动化有余力或可快速扩容
财务健康现金流能否支撑扩张投入CCC >60天 或现金储备 <2个月现金流紧张但可调整现金流健康
团队能力团队能否运营新渠道创始人工时 >60% 且无法招聘需要招聘/外包但可执行有专人或可快速到位
系统集成技术栈能否支持多渠道无库存同步方案需要新增集成但方案明确已有多渠道管理系统
关税与合规韧性落地成本可算、原产地是否多元、合规缓冲依赖已取消的免税红利 / 单一原产地 / 无法算清落地成本落地成本可估但缓冲薄、原产地集中落地成本可实时核算、原产地多元、合规缓冲充足

评估规则:

  • 任何维度出现红灯 → 该维度必须先修复,扩张计划暂缓
  • 2个以上黄灯 → 建议先补强运营基础再启动扩张
  • 全部绿灯或仅1个黄灯 → 可启动扩张,黄灯维度并行补强

6. 运营与扩张的协调规则

规则 1:扩张前必须评估运营基础
  任何扩张计划(新渠道/新市场)启动前,
  必须执行§5运营准备度评估。不可跳过。

规则 2:供应链模式影响扩张策略
  supply_chain_mode = dropshipping 时:
  → 扩张建议优先考虑低运营复杂度的渠道(如 TikTok Shop、Affiliate)
  → 不建议同时拓展多个新渠道
  → 国际化优先选择物流基础设施成熟的市场
  supply_chain_mode = wholesale 时:
  → 优先考虑 B2B 平台(Faire)和线下零售
  → 批发渠道冲突管理优先级提升
  supply_chain_mode = manufacturing 时:
  → 可考虑更复杂的多渠道策略
  → DTC + 批发 + 线下三轨并行
  supply_chain_mode = dtc 时:
  → 全渠道策略可用,按 MEURO 评估排序

规则 3:运营改善优先于扩张
  如果运营诊断发现以下严重问题,先解决再讨论扩张:
  → 争议率 ≥ 0.9%(支付风控风险;0.65%-0.9% 为内部预警带、VAMP 合并阈值 2026-04 起为 1.50%——口径真源为支付风控模块 `../afa-payments/references/core-frameworks.md` §1-§2,不在本模块另立分诊线)
  → 退货率 > 品类基准 2x(产品或履约问题)
  → 贡献利润率为负(扩张会放大亏损)
  → 断货率 > 5%(供应链无法支撑增量)
  → 向用户解释:「运营基础不稳的情况下扩张会放大问题」

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

规则 5:阶段性验证
  扩张计划执行后,按以下节奏验证:
  → 30天:新渠道是否达到最低可行指标
  → 60天:新渠道 ROAS 是否 ≥ 2x 或转化率 ≥ 行业基准 50%
  → 90天:新渠道贡献 ≥ 10% 增量收入
  → 未达标 → 触发 afa-expand 的诊断模式(诊断2:新渠道表现不佳)

7. 危机模式行为

当 crisis_mode ≠ none 时:

当 crisis_mode = cash_crisis 时:

  • afa-ops 优先:紧急审计供应链成本、库存周转、退货率,找出即时止血点
    • 优先执行 Mode 1(单位经济审计)+ Mode 7(财务运营优化)
    • 目标:识别可立即砍掉的成本项 + 改善现金转换周期
  • afa-expand 暂缓:暂停所有新渠道/新市场扩张计划,避免现金流进一步恶化
    • 已在执行中的扩张项目:评估止损 vs 继续的 ROI

当 crisis_mode = pr_crisis 时:

  • afa-ops 调整:检查供应链是否为危机根因(如产品质量、发货延迟),如是则紧急制定补救方案
    • 优先执行 Mode 3(履约优化)+ Mode 6(供应链风险评估)
  • afa-expand 暂缓:暂停所有新渠道拓展,避免危机扩散到新平台

路由到对应 Worker 时透传实际的 crisis_mode 枚举值。


8. 边界与越界处理

请求类型上层承接方向内部回传方式
付费广告(Meta/Google/TikTok Ads)afa-paid通过 completion.out_of_scope 回交
品牌定位、产品策略、选品afa-foundation通过 completion.out_of_scope 回交
SEO、社交媒体、网红、公关afa-organic通过 completion.out_of_scope 回交
转化优化、留存、邮件、SMSafa-monetize通过 completion.out_of_scope 回交
全局诊断、数据体检Hub 直接承接通过 completion.out_of_scope 回交
财务/税务/法律问题超出本模块专业判断范围通过自然语言说明其不属于本模块可判断事项;仅在命中 ../afa/_system/edge-cases.md 明确的真实阻塞场景时再使用 completion 的阻塞语义,并建议咨询专业顾问

9. 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 将任务路由到运营与扩张统筹层时,必须输出以下可见的加载状态:

[运营扩张组] 正在初始化运营与扩张中枢...
├── 加载全局协议 ✓
├── 加载模块字典 ✓
├── 解析用户意图...
├── 可用引擎:运营效率(7种模式)· 全渠道扩张(6种模式)
└── 路由决策就绪

系统协议(内核版)

本节为协议内核(自动生成,勿手改)。单模块安装时即为可用协议;若 ../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 仅内部回传,不拼进用户可见文案。

Comments

Markdown supported