SuperAPI AI 工具集

shopify-expert

编程与开发

查看项目

更新于 10-15 14:28

技能介绍

用途

Shopify Expert 是一个面向 Shopify 平台开发的高级技能,定位为资深 Shopify 开发者,专长于主题开发、无头电商(headless commerce)、应用架构以及自定义结账解决方案。它用于构建和调试 Shopify 主题(.liquid 文件、theme.json、sections),开发自定义 Shopify 应用(shopify.app.toml、OAuth、webhooks),并实现结账定制等功能。

主要能力

该技能围绕一套核心工作流组织:

  1. 需求分析——判断主题、应用或无头方案哪种更契合需求。
  2. 架构搭建——使用 shopify theme init 或 shopify app create 进行脚手架初始化;配置 shopify.app.toml 与主题 schema。
  3. 实现——构建 Liquid 模板、编写 GraphQL 查询或开发应用功能。
  4. 验证——运行 shopify theme check 进行 Liquid 检查;若发现错误则修复并重新运行后再继续。运行 shopify app dev 在本地验证应用;在沙箱中测试结账扩展。若任一步验证失败,需先解决所有报告的问题再进入部署。
  5. 部署与监控——主题使用 shopify theme push;应用使用 shopify app deploy;部署后关注 Shopify 错误日志与性能指标。

技能内置按上下文加载的参考指南,包括:Liquid 模板(主题开发、模板定制)、Storefront API(无头电商、Hydrogen、自定义前端)、应用开发(构建 Shopify 应用、OAuth、webhooks)、结账扩展(结账 UI 扩展、Shopify Functions)、性能(主题速度、资源优化、缓存)。

使用方式

技能提供多类代码示例与命令参考:

  • Liquid 示例:带 metafield 访问的产品模板、Online Store 2.0 的集合筛选。
  • Storefront API:按 handle 查询产品的 GraphQL 查询,包含图片变换、变体、metafield 等字段。
  • Shopify CLI 常用命令:主题开发(shopify theme dev、theme check、theme push、theme pull)、应用开发(shopify app create、app dev、app deploy、generate extension)、GraphQL(shopify app generate graphql)。
  • 应用示例:使用 TypeScript 通过 authenticate 进行已认证的 Admin API 请求。

技能还规定了必须遵守与禁止的做法。必须做:主题使用 Liquid 2.0 语法;正确处理 metafield;使用 Storefront API 2024-10 或更新版本;使用 Shopify CDN 过滤器优化图片;遵循 Shopify CLI 工作流;嵌入式应用使用 App Bridge;为 API 调用实现正确的错误处理;遵循 Shopify 主题架构模式;应用开发使用 TypeScript;在沙箱中测试结账扩展;每次主题部署前运行 shopify theme check。禁止做:在主题代码中硬编码 API 凭据;超出 Storefront API 速率限制(2000 点/秒);使用已弃用的 REST Admin API 端点;跳过客户数据的 GDPR 合规;部署未测试的结账扩展;在 Liquid 中使用同步 API 调用(已弃用);忽略主题性能指标;在未加密的情况下将敏感数据存入 metafield。

输出模板要求:实现 Shopify 方案时提供完整的文件结构与命名、带类型的 Liquid/GraphQL/TypeScript 代码、配置文件(shopify.app.toml、schema 设置)、所需的 API 作用域与权限、测试方法与部署步骤。

适用场景

适用于 Shopify 主题开发与调试、无头电商与自定义前端、Shopify 应用开发(含 OAuth 与 webhooks)、结账 UI 扩展与 Shopify Functions、主题性能优化等任务。

限制

资料未提供该技能的收费、价格、平台支持范围或具体效果数据。知识参考涉及 Shopify CLI 3.x、Liquid 2.0、Storefront API 2024-10、Admin API、GraphQL、Hydrogen 2024、Remix、Oxygen、Polaris、App Bridge 4.0、Checkout UI Extensions、Shopify Functions、metafields、metaobjects、主题架构、Shopify Plus 功能等,但未说明各版本的具体兼容性细节。