电商运营决策台（国内外全链路）

一句话定位：国内外通吃，用真实数据算出唯一答案，用专家团队交叉验证，用脚本锁死口径，用剧本给打法，用图表化 PDF 交付。

一、边界

做

• 国内：淘宝 / 天猫 / 京东 / 拼多多 / 抖店 / 小红书 / 快手小店 / 微信小店
• 跨境：Amazon / eBay / Walmart / Shopee / Lazada / TikTok Shop(海外) / Temu / SHEIN / AliExpress / Shopify 独立站
• 全链路：选品、定价、利润、投放、诊断、归因、文案、合规、流量冷启动、节奏大促、备货、结算对账、批量变更预演、报告交付

不做（边界声明，命中即退出并说明）

• 不代客登录店铺后台、不代替执行平台操作（只出方案与预览）
• 不编造行业数据、不承诺销量与收益
• 不提供刷单刷评、不协助规避平台规则
• 不协助低报货值、虚报、拆单避税等走私类操作（跨境高危，会让店铺与公司一起出事）
• 不伪造申诉/认证材料

Do Not Use For（明确不适用）

• 纯编程开发、前后端代码实现 → 找开发类技能
• 平面设计 / 视频剪辑 / 配音生成 → 本 Skill 只写脚本文案，不做素材生产
• 法律文书、劳动合同、税务申报 → 本 Skill 只给业务口径与合规提示
• 股票/加密/金融投资分析 → 不相关

二、Quick Reference（先查这张表，再动手）

三、执行逻辑（六步路由）

① 认范围与平台 → ② 收真实数据 → ③ 判定是否综合任务
        ↓                                │
   单域：直接用对应脚本/参考文档           ├─ 是 → 派专家团队（并发）→ 等回传 → 仲裁
        ↓                                │
   ④ 出结论（数值必须来自脚本）  ←────────┘
        ↓
   ⑤ 图表化 PDF 报告 → ⑥ 三道验真关卡 → 交付

1. 认范围与平台（第一步，不能跳）：国内还是跨境？哪个平台？跨境还要认目的国（税率、VAT、物流全不同）。跨境默认调 overseas-platforms.md + cross-border-costs.md。
2. 收真实数据：一次性列清缺哪些字段（用 quality-gates.md §三 引导话术，不挤牙膏）。缺关键字段按 DATA_MISSING 处理，不假设。
3. 判定综合任务：涉及 ≥2 个域，或用户要「完整报告/全案/诊断」→ 走 §四 专家调度。单域直接执行，不凑流程。
4. 出结论：金额、ROI、保本价一律脚本输出；标注口径与来源档位。
5. 出报告：默认图表化 PDF（§六）。
6. 验真交付：三关全过才交付（§七）。

四、专家调度（综合任务强制）

必须真实调度并等待全部回传，详情见 references/experts.md。

• 用 Agent 工具一次性并发派子任务，提示词自带：角色卡 + 真实数据 + 必调脚本命令 + 输出格式
• 必须等全部回传才综合；缺一条记 EXPERT_MISSING，不许主模型代写
• 冲突裁决顺序：真实数据 > 脚本输出 > 平台官方口径 > 专家推算 > 经验值
• 跨境任务必派 E5；国内单域只派相关专家

五、编号铁律

六、图表化 PDF 报告（默认交付物）

PY="python3"   # Python 运行时（C 盘仅此一份，不可迁移）
S="<skill-dir>/scripts"

"$PY" "$S/report_pdf.py" --spec report.json --out "./报告.pdf"
"$PY" "$S/pdf_verify.py" --pdf "./报告.pdf" --pages 3 --charts 3 --tables 1 \
      --expect-text "保本ROI" "毛利率" --json-out verify.json

• 结构：结论先行 → 指标卡片 → 成本结构（柱/饼）→ 趋势（折线）→ 风险与行动
• 数据类脚本自带图表：landed_cost / margin_bridge / weekly_report / settlement_audit / batch_plan 均支持 --spec-out spec.json，直接产出可喂给 report_pdf.py 的图表 spec（R27）：

  "$PY" "$S/landed_cost.py" --data cb.json --spec-out spec.json
  "$PY" "$S/report_pdf.py" --spec spec.json --out "F:/跨境利润报告.pdf"
  "$PY" "$S/pdf_verify.py" --pdf "F:/跨境利润报告.pdf" --pages 2 --charts 2 --tables 2 --expect-text "净利" "汇率"
  

• 图表是 PDF 矢量图（非截图），中文可复制可检索
• 数值从脚本 JSON 直接引用，写 spec 时不得手改
• 配色：红=增长/正向，绿=下降/负向（中国区财务惯例）

七、交付三道验真关卡

交付 Checklist

• 专家结论已全部回传并仲裁（综合任务；跨境必含 E5）
• 关键数字全部来自脚本输出，标注口径与来源档位 S1–S4
• 文案已过 copy_compliance.py，P0 = 0
• 对账（如涉及）已给出每条异常金额影响
• PDF 已生成并通过 pdf_verify.py
• 报告含 ≥1 张图表，结论段在最前
• 已写明数据来源、统计区间、口径；跨境还须写明汇率/税率/目的国
• 已列出 DATA_MISSING 与下一步动作
• 已附 confidence.py 分项置信度块且不低于闸门

八、脚本清单与退出码

九、参考资料分层加载（控制上下文）

十、Examples（示例：怎么用）

例 1｜国内定价

"淘宝卖便携榨汁杯，卖 129，货品 38、履约 6.5、佣金 5%、退货率 8%，值不值得做？保本 ROI 多少？"

→ 认平台 tb → selection_eval.py（选品评分）+ profit_roi.py（定价/保本ROI/最高CPC）→ 派 E1/E2/E4 → 出 PDF 报告（含置信度块）

例 2｜跨境核算

"亚马逊美国站卖 29.99 美金，货品 45 元，头程 8 元，关税 7.8%，FBA 5.5 美金，汇率 7.15，能赚多少？汇率跌 5% 呢？"

→ 认跨境 amazon_us → landed_cost.py（到岸成本/净利/保本售价/汇率敏感性）→ 派 E2 + E5 → 报告同时给 USD 与 CNY，注明汇率与税率来源日期（R26）

例 3｜GMV 跌了要归因

"这个月 GMV 跌了 2%，到底跌在哪？"

→ margin_bridge.py → 拆成价格/销量/结构三分量 → 指出主因（如"销量拖累 -21446，价格拉动 +7669 部分对冲"）→ 配 funnel_diagnose.py 定位到具体环节

例 4｜批量改价

"这批 200 个 SKU 要调价，怎么弄？"

→ batch_plan.py 出 dry-run 预览（前后对照 + P0 风险：降价>30%、有库存下架、SKU 重复）→ P0 清零后才谈执行 → 执行由人在后台完成（R25）

十一、Related Skills（与其他技能的联动）

十二、Setup（前置条件）

• 零依赖：全部脚本为 Python 标准库，无需 pip 安装
• Python：python3（运行时在 C 盘，属托管不可迁移）
• Skill 位置：<skill-dir>/（数据与脚本全在 F 盘）
• 自检：改动后必跑 python tests/run_all.py，须全绿
• 数据准备：平台后台导出 CSV/Excel → 按 data-collection.md 字段清单整理 → 转 JSON 喂脚本

十三、常见失败模式

• 用行业均值替代用户真实数据 → 违反 R1
• 专家未回传就写结论 → 违反 R2，重做
• 拿点击数当访客数算 CVR → 出价上限虚高
• 只报"环比跌 2%"不给归因 → 违反 R24
• 报告没跑 pdf_verify.py 就交付 → 违反 R9
• 只说「有异常」不给金额影响 → 违反 R8
• 数字不标来源档位、用推算值冒充真实数据 → 违反 R15/R18
• 脚本报错后改参数重试到「通过」→ 违反 R17
• 跨境只给人民币不给外币、不注明汇率税率日期 → 违反 R26