用途：基于只读 Shopify Admin 数据生成店铺经营简报，支持日、周、月或有效自定义周期，产物为独立 HTML 报告，涵盖销售、订单、常一起购买的商品、折扣使用频率、物流速度、本期有销量商品的低库存与即将到来的季节准备。
主要能力：脚本通过 Shopify GraphQL 只读查询订单、弃单与商品，生成 HTML 报告；--json 只输出 JSON，不创建文件。默认周期为店铺时区下最近七个完整自然日。
安全边界：不做任何变更、权限释放、主题修改、活动发送或库存更新。店铺数据、订单关联客户数据与报告均为私密，不得粘贴到公开渠道。仅接受 HTTPS <store>.myshopify.com 域名，发送凭据前先校验 DNS，拒绝不安全目标。选定的 SKILL_HUB_SHOPIFY_ACCESS_METHOD 为准，失败后不得回退其他模式或令牌。遇到 GraphQL、权限范围、分页、API 版本或数据完整性错误即停止，不得把缺失数据渲染为零。报告在商家工作目录运行，不放在源码仓库内。
连接方式：shopify_cli_oauth 为默认交互模式；dev_dashboard_client_credentials 用于商家自有长期连接，短时令牌仅存内存；admin_api_access_token 为显式本地 BYOK/测试模式，不会自动启用。最小只读权限为 read_orders,read_products,read_inventory；若需额外受保护数据访问，须说明原因、取得商家批准并在 Shopify 侧解决后重试。
使用步骤：先用 init-env 创建私有模板，避免覆盖已有文件：node <absolute-path-to-skill>/scripts/shopify-operations-brief.mjs init-env --env skill-hub.env；再用 connection-check 做只读连接检查；然后运行 diagnose，例如默认七天报告加 --lang zh-CN，或指定周期与输出路径 --period "2026-07-01..2026-07-31" --output reports/july-brief.html；仅需 JSON 时加 --json。仅在商家审阅并批准替换指定已有 HTML 报告时才使用 --force。
使用前应阅读 references/onboarding-guide.md（连接方式、最小权限、本地设置）、references/metric-definitions.md（指标含义与限制）、references/marketing-calendar.md（季节建议规则），仅在修改仪表盘设计时读 references/design-tokens.md。
限制与错误处理：连接报错仅在请求失败后处理，并保持所选访问方式。网络错误（fetch failed、ETIMEDOUT、ECONNRESET、ENETUNREACH）不得猜测代理端口；若运行环境已配置获批代理可重试一次，否则请商家向该进程暴露代理。407 需在运行环境密钥库修正代理凭据，禁止在对话中粘贴。CLI_NOT_FOUND/ENOENT 属启动器错误，需解析配置的 CLI 入口或平台命令。401/403 或 invalid_client 检查店铺、凭据与应用安装。SCOPE_UPDATE_REQUIRED 需展示具体缺失权限与原因，取得批准并在 Shopify 批准待处理更新后刷新连接再重试只读检查。shop_not_permitted 应改用该店铺许可的应用，不要循环重试。GraphQL 错误修正查询或输入，不得盲目重试。仅在该路径失败且用户同意后才建议其他访问方式。其他收费、价格等信息暂未提供。