Shopify Stocky 切换测试手册

适用场景与前置条件

适用于需要将 Stocky 日常流程迁移到 Shopify 原生库存管理的零售和多地点团队。需要 Python 3.10+ 与第一步生成的本地审计 JSON，不需要 Shopify 登录、API 或网络连接。

输入与输出

输入为 shopify_stocky_export_audit.json。输出为 shopify_stocky_cutover_runbook.json，覆盖采购单、库存转移、库存调整和 Shopify POS 收货的人工测试。

安装与导入

无需安装第三方包。复制技能目录到有权限的 Agent Skills 目录，或直接从目录运行脚本。

执行步骤

CODEBLOCK0

每项测试包含前置条件、需要记录的证据字段和无法确认前后值时的停止提示。未完成采购单会让采购单流程优先要求人工处理。

错误恢复

审计 JSON 缺少 reports 或状态时，修正审计副本并重新生成；旧文件不会被删除，脚本不会执行 Shopify 操作。

权限与隐私边界

只读本地审计结果。不要输入账号、客户资料、真实支付信息或 API Token。测试店铺中的导入、调整和收货必须由有权限的管理员人工执行并批准。

验收方法

样例应生成四个 NEEDS_HUMAN_TEST 流程，采购单流程包含在途采购单处理门槛，并固定 human_approved=false、external_write_executed=false。