技能介绍

你在解决什么问题

在 Shopify 上写东西，真正消耗时间的通常不是「会不会写代码」，而是三件事：Shopify CLI 的命令序列记不清、GraphQL Admin API 该取哪些字段和权限范围拿不准、主题改动到底跑在哪个环境里出了什么问题说不明白。这个技能压缩的就是这部分决策成本——它不科普 Shopify 是什么，而是直接告诉你针对某类构建目标该走哪条路径。

核心能力与关键步骤

技能按构建对象分成三条主线，另有一条贯穿全程的安全清单。

应用（App）：shopify app init → shopify app dev（本地带隧道）→ 在 shopify.app.toml 中配置 access_scopes（如 read_products,write_products,read_orders）→ shopify app deploy。适用于跨店功能、对接外部服务、复杂业务逻辑，以及需要计费的场景。
扩展（Extension）：shopify app generate extension --type checkout_ui_extension，类型也覆盖 admin_action、admin_block、pos_ui_extension、function。适用于改结账流、加后台字段、POS 动作、折扣/支付/配送规则。
主题（Theme）：shopify theme init（可选 Dawn）→ shopify theme dev（在 localhost:9292 预览）→ shopify theme pull --live → shopify theme push --development → shopify theme publish --theme=ID。适用于自定义店面设计与品牌布局。

组合策略很明确：App 负责后端数据，主题扩展负责店面 UI。代码模板与安全清单放在 references/template.md，包括 GraphQL 产品查询、结账 React 扩展、Liquid 商品循环、Webhook 验签。

输出与适用边界

输出是一个结构化工件 ShopifyPlan，字段为 artifact、cli_steps、scopes、api_patterns、notes，可以交给 payment-integration、frontend-development、backend-development 这类下游技能继续消费，同时附带自然语言的安全与限流提醒。

注意点：新开发优先 GraphQL；只取所需字段；大数据集走分页或批量操作；遵守基于成本的限流；密钥入环境变量、验 Webhook 签名、公开应用走 OAuth、权限范围保持最小、嵌入式应用用会话令牌；用开发店测试，并注意移动端、无障碍与 GDPR 校验。

不适用的：非 Shopify 的独立电商，以及纯视觉设计（后者交给设计技能）。