social-commerce-starter（社交电商小程序一站式搭建 SOP）
从零把一个微信社交电商小程序搭到上线：架构 → 闭环对接 → 三端打通 → 上线门禁 → 冷启动运营。方法论来自真实商城项目的完整交付与验收，全部为通用路径，不依赖任何私有基建。
触发条件
- 「我要做个微信小程序商城 / 社交电商小程序」→ 从 M1 开始走全流程
- 「商城前后端怎么对接 / 接口怎么管理」→ 进入 M1+M2
- 「服务号、小程序、微信小店怎么打通」→ 进入 M3
- 「商城上线前要检查什么 / 帮我检查部署清单」→ 进入 M4（launch_gate.py）
- 「商城上线后怎么运营冷启动」→ 进入 M5
执行步骤
总原则：一次只推进一个模块；每个模块先问清用户现状（全新/已有、已认证/未绑定），信息不足先澄清，不编造。
M1 工程架构分层
按 references/module-spec.md 的 M1 规格，产出四层架构方案：
- env 配置层（环境切换 + Mock 开关 + 超时配置，一处管理所有 Base URL）
- API 分层接口层（按业务模块拆文件：goods/cart/order/user/address，每个接口含方法/路径/入参/返回注释）
- 统一请求封装层（错误拦截规则：200 放行 / 401 清 token 提示重登 / 500 提示服务器异常 / 超时自动重试 ≤2 次递增间隔 / 网络错误提示）
- Store 状态管理层（所有数据变更通过 action 同步后端，禁止页面直改缓存；后端异常降级到本地缓存兜底）
输出标准：目录结构 + 每层职责一句话 + 错误拦截规则表。禁止出现任何真实 IP/域名/云环境 ID，一律用 你的域名 占位。
M2 五大业务闭环对接与验收
用户选定闭环（商品/购物车/地址/订单支付/用户），按 references/module-spec.md M2 规格产出：
- 验证矩阵：
前端触发 → 后端接口 → 数据同步 → 验证结果四列，一行一个功能点；订单闭环矩阵必须包含「防重复提交」与「支付回调幂等（订单号全局唯一）」两行校验点 - 字段映射表：后端 snake_case → 前端 camelCase（如
original_price → originalPrice） - 订单闭环必须运行脚本校验状态机：
python scripts/order_state.py check --transitions "1->2,2->3,3->4"
状态口径唯一：1待付款 2待发货 3待收货 4已完成 5已取消；合法迁移仅 1→2、1→5、2→3、2→5、3→4。脚本结论为权威，脚本报错时把错误原文回传用户并按提示修正，禁止绕过脚本自行断言迁移合法。
M3 微信三端对接与数据同步
按 references/module-spec.md M3 规格：
- 先核对绑定前置条件（小店绑小程序、小店绑服务号、开放平台绑同主体三端拿 UnionID），未完成的列为 P0 行动项
- 方案选型（结论必须唯一且附理由与限制）：A 图文商品卡片（零开发）/ B 小程序内嵌原生组件 store-product / C API 拉商品+自定义详情页。决策依据：开发资源、定制需求、上线时间
- 数据同步策略：商品全量同步 1 次/天（低峰期）+ 增量 webhook + 订单 5 分钟兜底轮询（拉最近 10 分钟窗口防 webhook 丢失）；重试指数退避 1s/2s/4s，最多 3 次，失败告警
- 金额规则硬边界：微信小店价格单位一律为分（整数）。涉及金额的输出必须显式标注单位，如 29.9 元 = 2990 分
M4 上线门禁（确定性校验，必跑）
让用户按模板填写检查清单后运行：
python scripts/launch_gate.py template > checklist.json # 生成 17 项模板
python scripts/launch_gate.py run --input checklist.json --output report.json
退出码语义：0=全部必检项通过 / 1=存在必检项未通过（报告含逐项问题）/ 2=输入错误（JSON 非法或字段缺失，报告含原始错误）。退出码 1 时禁止建议上线；把报告问题列表逐条转给用户修复后复跑。脚本结论为权威。
M5 运营冷启动循环
商品上新 → 素材推广（图文种草+短视频脚本）→ 发布 → 数据复盘 → 迭代。要点：素材一律为草稿由用户审核后自行发布；文案提示极限词与夸大收益合规风险（AI 不代审合规）；发布渠道与节奏由用户定。
输出标准
- 架构方案/验证矩阵/选型结论/门禁报告全部用表格输出，结论先行
- 引用数字（状态码、重试参数、金额）必须与脚本输出或本 SKILL.md 规则一致，不得自行编造
- 每个模块结尾给「下一步动作」一行
边界约束（硬边界，违反即拒绝）
- 不编造接口：本文档引用的微信官方接口名来自公开资料整理；实际对接前必须引导用户到微信官方文档核对最新版本，接口变更不背书
- 凭证零落盘且零复述：AppSecret/支付证书/API Key 不写入任何产物、示例、报告；不得在回复中复述用户贴出的凭证原文（包括「错误示范」代码块），一律用
<你的密钥>占位；用户贴出凭证时提醒撤换并拒绝写入产物 - 不代调用：脚本只做本地确定性校验，绝不代用户请求微信/支付 API；用户要求代调用时给出官方调试工具指引
- 不直接发布/部署：所有上线、发布、部署动作由用户亲手执行，AI 只产出检查结论与草稿
- 合规提示：上架文案涉及极限词（最/第一/绝对）或夸大收益时提示人工审核，不代改判合规结论
- 价格单位为分：见 M3 第 4 条，单位缺失的金额输出视为错误
