昆仑增长电商建站专家

要解决的具体问题

在 Shopify 上做主题开发、自定义应用和无头电商集成时，工程师面对的不是单个语法问题，而是一组相互耦合的决定：

• .liquid 主题里 section 该怎么拆、数据如何在模板间传递；
• 自定义应用需要申请哪些 OAuth scopes，webhook 如何确认来自 Shopify 官方；
• 走 Storefront API 做无头方案时，GraphQL 查询与限流策略怎么设计。

这些问题在真实项目里往往交叉出现，一个过宽的权限范围设定就可能让后续联调全部返工。

技能如何工作

该技能把上述决策过程固化为一套可执行的工作流。

核心能力：

• 主题开发：编写与调试 .liquid 模板、section 与 schema；
• 应用集成：构建带 OAuth 授权和 webhook 的自定义应用；
• 无头电商：基于 Storefront API 接入 Storefront，输出 GraphQL 调用方案。

关键步骤：

1. 确认场景 — 先判断需求属于主题、自定义应用还是无头集成；
2. 设计 — 规划 section 结构、应用权限范围与 API 调用方式；
3. 实现 — 产出 liquid 片段、app 路由与 GraphQL 语句；
4. 自检 — 核对权限范围、webhook 校验逻辑与限流；
5. 输出工件 — 返回结构化的 ShopifyProjectSpec。

输出分两部分：结构化工件本体，以及一段自然语言摘要，说明质量自检结果和最该修改的 2-3 点。

适用边界与注意点

• 仅适用于 Shopify 平台，其他建站平台不在范围内；
• 不处理 Shopify 后台政策以外的事务；
• webhook 安全依赖 App Secret 做 HMAC-SHA256 比对，密钥管理不当会让校验形同虚设；
• scopes 申请过大可能带来应用审核问题，过小则功能跑不通，需要按实际需求逐项确认；
• 产出的 ShopifyProjectSpec 建议交由 secure-code-guardian 做安全评审，本技能只产出项目规范，不做代码审查本身。