私域运营诊断Pro·30天落地执行方案

概述

不是体检，是开方。输入存量现状，输出一份可以直接照着执行的 30 天私域增长方案。

每次调用走 作者后端支付校验（¥29.00/次）：前置检查 → 微信支付下单 + X402 AI 预下单 → 返回 WeixinPay-Required → 用户授权 → 支付成功后交付方案。

Step 0：付费前置检查（必须先做）

先看当前 Agent 的工具列表里有没有 weixinpay_pay（对话内支付授权工具）。这个探测只决定下面走 A 路还是 B 路，不决定是否提供服务：

⚠️ 铁律（这一步最容易被写错）：用户表达购买意愿后，必须立刻给出至少一条可支付途径——对话内支付卡片或收款二维码，二者有其一即可。

禁止因为"没检测到 weixinpay 插件"就终止流程、回复"当前 Agent 暂不支持微信支付付费能力"，或让用户空等。

没有 weixinpay_pay 只说明要走扫码路径，不说明不能卖。

前置检查通过：进入 Step 1 请求资源。

Step 1：请求资源（创建付费订单）

首次请求：调用作者后端统一接口（不带 X-Out-Trade-No Header）创建订单：

POST https://skill.zzcxin.cn/api/payskill/private-domain-diagnosis-pro/invoke
Content-Type: application/json

{
  "query": "帮我出私域 30 天落地执行方案",
  "params": {
    "accounts": "公众号：XX 5粉；社群：3群共200人；星球：0会员",
    "products": "AI工具箱/微信小店/网盘",
    "data_basic": "无标签无用户视图",
    "content_capacity": "中台每日10+篇",
    "container_ready": "企微已认证/已建群",
    "weekly_hours": "5"
  }
}

响应：HTTP 402 Payment Required（触发支付）：

{
  "code": "PAYMENT_REQUIRED",
  "message": "需要支付后才能获取内容",
  "WeixinPay": {
    "WeixinPay-Required": "xY9zAbc123def456",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "out_trade_no": "WX402_20260816120000abcdef123456",
  "amount": "29.00",
  "currency": "CNY"
}

响应头（Header）同时携带两个关键值（必须提取并保存）：

• WeixinPay-Required：支付码（paymentCode）
• X-Out-Trade-No：订单号（out_trade_no）——支付成功后重试必须携带

重要：X-Out-Trade-No（订单号）不可修改、不可丢失，贯穿 Step 3 履约与 Step 5 退款。

失败响应：

• HTTP 4xx：{"detail": "..."}，展示错误信息并停止
• HTTP 5xx：触发 重试机制（见 Step 4）

Step 2：发起支付（支付触发）

路径 A：有 weixinpay_pay 时（对话内支付）

将 402 响应里的 WeixinPay-Required 值作为 paymentCode，调用 weixinpay_pay 向用户申请支付授权（拉起微信支付 AI 专属卡）。

同时向用户展示订单摘要：

重要：用户授权完成后，必须保留 X-Out-Trade-No（订单号），用于 Step 3 履约与退款追踪。

路径 B：没有 weixinpay_pay、或路径 A 拉起失败时（二维码兜底，必须执行）

不要重试、不要放弃、不要终止，直接切到这条路。

① 取支付链接（两个位置任取其一，内容相同）：

• 402 响应体字段 code_url
• 402 响应头 X-Pay-Code-Url

形态形如 weixin://wxpay/bizpayurl?pr=xxxxxxxx。

② 立即生成二维码发给用户，并把链接原文一并给出（二维码扫不动时可复制到微信）。同时给出订单摘要：

③ 告知用户：用微信扫一扫扫码付款；付完不用告诉 Agent，系统会自动确认到账并继续交付。

④ 轮询确认到账：每隔 3 秒 GET 一次 402 响应里的 query_url（形如 https://skill.zzcxin.cn/api/payskill/order/{{订单号}}），最多 20 次。

⑤ 兜底：轮询 20 次仍是 pending 时，把支付链接与订单号再给用户一次，说明原链接仍可继续付款；不要重新下单（避免用户重复支付）。

路径 B 适用于所有客户端——对话内支付插件只在部分版本与安装方式下注入。

把全部用户挡在路径 A 后面，等于放弃全部成交。

Step 3：订单号传递与履约（⚠️ 必须执行）

支付成功后，必须携带 X-Out-Trade-No Header 重新请求同一个 invoke 接口——body 与第一次请求完全一致，仅通过 Header 传递订单号：

POST https://skill.zzcxin.cn/api/payskill/private-domain-diagnosis-pro/invoke
Content-Type: application/json
X-Out-Trade-No: WX402_20260816120000abcdef123456
WeixinPay-Required: xY9zAbc123def456

{
  "query": "帮我出私域 30 天落地执行方案",
  "params": {
    "accounts": "公众号：XX 5粉；社群：3群共200人；星球：0会员",
    "products": "AI工具箱/微信小店/网盘",
    "data_basic": "无标签无用户视图",
    "content_capacity": "中台每日10+篇",
    "container_ready": "企微已认证/已建群",
    "weekly_hours": "5"
  }
}

成功响应（HTTP 200，原样透传）：

{
  "code": "SUCCESS",
  "message": "付费内容",
  "out_trade_no": "WX402_20260816120000abcdef123456",
  "content": {
    "plan": "…2500-4000字 Markdown 完整落地包（结论/全景/分群/5旅程/日历/数据清单/钩子文案）…",
    "plan_sections": ["结论先行", "存量全景+短板", "四层分群", "5条自动化旅程", "W1-W4日历", "D1-D16清单", "钩子文案库"]
  }
}

未支付响应（HTTP 200，code=PAYMENT_PENDING）：提示"订单未支付成功，请先完成支付"，回到 Step 2 路径 B 继续轮询查单，查单显示 paid 后重做本步。

订单不存在（code=TRADE_NOT_FOUND）：禁止继续，回 Step 1 重新创建订单。

⚠️ 不携带 X-Out-Trade-No Header 重试，永远拿不到付费内容——本步是本技能最容易遗漏的一步，必须执行。

Step 4：支付后重试机制

支付/履约过程中出现以下 可重试错误（用同一 X-Out-Trade-No 重试最多 3 次）：

重试规则：同一 X-Out-Trade-No，间隔 1–3 秒，最多 3 次；3 次仍失败进入 Step 5。

不可重试错误（直接走 Step 5）：INSUFFICIENT_BALANCE、KYA_AUTH_FAILED、TRADE_CLOSED、INVALID_PARAMS。

Step 5：退款 / 异常处理

退款 / 异常处理响应模板：

• "支付完成" — 成功支付
• "履约完成" — 2500-4000 字 Markdown 完整落地包
• "资源获取失败" — 后端服务异常
• "交易号格式异常" — out_trade_no 校验未通过
• "余额不足请充值" — INSUFFICIENT_BALANCE
• "身份校验失败" — KYA_AUTH_FAILED
• "订单号格式异常" — X-Out-Trade-No 非 32 位纯数字时绝对禁止任何后续命令

工作流（交付成功后，本技能在用户视角下做的事）

详细诊断与落地方法论：加载 prompts/diagnose_pro.md 执行（含输入清单、四层分群、旅程设计模板、日历与数据清单规范），以下为概要。

Step 1 · 存量资产全景（人/触点/数据 三维）

Step 2 · 三大结构短板定位

Step 3 · 四层用户分群（新粉 / 活跃 / 付费意向 / 付费会员）

Step 4 · 5 条自动化旅程设计（欢迎/培育/转化/唤醒/挽回，每条含：触发条件 + 内容序列 + 承接钩子）

Step 5 · W1-W4 执行日历（每周动作、每日 10 分钟 SOP、验收指标）

Step 6 · D1-D16 数据需求清单 + 承接钩子文案库

输出

完整 Markdown 落地包（2500-4000 字）：

• 结论先行（问题本质 + 公域/私域整合思路）
• 存量全景 + 短板
• 四层分群表
• 5 条自动化旅程（触发+内容+钩子）
• W1-W4 执行日历 + 验收指标
• D1-D16 数据需求清单
• 承接钩子文案库

内容纪律

1. 用户口述为准：量级/状态以用户提供为准，缺的标"待核实"，不脑补数据
2. 合规底线：不承诺效果、不涉灰产、遵守平台频控
3. 不越位：涉及用户真实业务的具体资产命名（如某号该不该互推）须用户确认
4. 可落地：每条建议对应具体动作或文案

与免费版的关系

免费版（¥0）= 体检报告（存量盘点+Quick Win）；Pro 版（¥1.5）= 在基础上加完整落地（四层分群+5 旅程+30 天日历+数据清单+钩子文案库）。

触发词

"私域诊断 Pro""私域运营方案""私域执行包""30 天私域计划""私域增长方案"。

依赖

• 用户需开通微信支付 AI 专属卡
• 微信支付账户有余额
• 配置：config.yaml（技能根目录）——占位保留，纯提示词技能可留空；若部署到脚本场景则填 platform 段