私域运营诊断·存量盘点体检（免费版）

概述

先看清家底，再谈打法。5 分钟跑完一轮私域体检，知道自己的盘子到底有多大、短板在哪、30 天内能做什么。

每次调用走 作者后端订单校验（免费版）：前置检查 → 创建订单（¥0，返回 WeixinPay-Required: FREE，全程无需任何支付授权）→ 携带 X-Out-Trade-No 订单号重试同一接口即交付诊断报告。

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

调用本 Skill 前做一次环境确认：

本技能为免费版（¥0）：全程无需任何微信支付授权。 以下检查只用于确认环境，任何一项"不通过"都不允许终止流程——免费技能必须让用户拿到内容。

禁止因为"没检测到 weixinpay 插件"就终止流程、回复"当前 Agent 暂不支持微信支付付费能力"，或让用户空等。免费技能不依赖任何支付能力：先走 Step 1 拿到订单号，再走 Step 3 带订单号重试即可获取内容。

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

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

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

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

{
  "query": "帮我做私域存量盘点体检",
  "params": {
    "accounts": "公众号：XX 5粉；视频号：XX；社群：3群共200人；星球：0会员",
    "products": "AI工具箱/微信小店/网盘",
    "data_basic": "无标签无用户视图",
    "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": "0.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：免费体验确认（无支付授权）

本技能为免费版（¥0），后端返回 weixinpay_required: "FREE"，不触发任何微信支付授权——直接向用户说明：

• 服务：创信数智 私域运营诊断 – 免费版
• 金额：¥0.00（免费体验）
• 交易号（X-Out-Trade-No）：X-Out-Trade-No

重要：保留 X-Out-Trade-No（订单号）用于 Step 3 履约。X-Out-Trade-No 不可修改、不可丢失。

不要将 FREE 当作真实 paymentCode 触发 weixinpay_pay——本技能无扣费。

Step 3：支付成功后获取资源（⚠️ 必须执行）

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

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

{
  "query": "帮我做私域存量盘点体检",
  "params": {
    "accounts": "公众号：XX 5粉；视频号：XX；社群：3群共200人；星球：0会员",
    "products": "AI工具箱/微信小店/网盘",
    "data_basic": "无标签无用户视图",
    "weekly_hours": "5"
  }
}

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

{
  "code": "SUCCESS",
  "message": "付费内容",
  "out_trade_no": "WX402_20260816120000abcdef123456",
  "content": {
    "report": "…800-1200字 Markdown 诊断报告（结论/全景表/健康度表/三大短板/Quick Win）…",
    "report_sections": ["TL;DR", "存量资产全景表", "触点健康度表", "三大结构短板", "QuickWin清单"]
  }
}

未支付响应（HTTP 200，code=PAYMENT_PENDING）：提示"订单未支付成功，请先完成支付"，回到 Step 2。

订单不存在（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：异常处理（免费技能无退款）

本技能不产生扣费，不涉及退款。交付异常时按以下规则处理：

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

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

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

详细诊断方法论：加载 prompts/diagnose.md 执行（含输入清单、三维盘点、健康度判定、Quick Win 标准），以下为概要。

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

按三维列出表格：

• 人（用户资产）：每个资产的名、定位、量级、状态、私域价值
• 触点：公众号矩阵/社群/星球/工具/落地页，逐个标健康度（✅/⚠️/🔴）
• 数据：粉丝数据/行为数据/标签体系/触达记录，逐项标现状与差距

Step 2 · 三大结构短板定位

从盘点中找出最痛的 3 个结构性短板（缺哪一层）：

• 产能满配但私域空仓（缺收口容器）
• 有触点但无承接钩子（缺落地转化）
• 数据有源未汇（缺统一用户视图）

Step 3 · Quick Win 清单（30 天内可做）

每条 Quick Win 含：动作 + 预期效果 + 优先级。判断标准：30 天内能做完、不依赖大开发、有可感知结果。

输出格式

结构化 Markdown 诊断报告（800-1200 字）：

• 结论先行（TL;DR）
• 存量资产全景表
• 触点健康度表
• 三大短板
• Quick Win 清单

内容纪律

1. 用户口述为准：量级/状态以用户提供为准，缺的标"待核实"，不脑补数据
2. 只诊断不越位：本免费版只给"问题定位 + Quick Win"，不给完整落地执行包（那是 Pro 版）
3. 合规底线：不承诺效果、不涉灰产建议

与 Pro 版的关系

免费版 = 体检报告（¥0）；需要完整落地（分层分群、自动化旅程、30 天执行日历、数据需求清单）时，升级到「私域运营诊断Pro·30天落地执行方案」（¥1.5/次）。

触发词

"私域诊断""私域盘点""存量体检""私域运营诊断""私域家底""摸底私域"。

依赖

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