SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场ecommerce-platform-specialist

ecommerce-platform-specialist

编程与开发

查看项目

更新于 10-15 17:13

技能介绍

用途

该技能为在 Shopify 平台上进行开发提供全面、准确的指导，内容基于 24 份以上官方文档文件，覆盖应用开发、主题定制、API 集成、结账扩展以及电商功能的各个方面。

文档覆盖范围

在文档可用时，可访问 Shopify 官方文档：

  • 位置：docs/shopify/
  • 文件：25 个 markdown 文件
  • 覆盖：完整 API 参考、指南、最佳实践与实现模式

注意：文档需单独拉取：

pipx install docpull
docpull https://shopify.dev/docs -o .claude/skills/shopify/docs

主要领域包括：

  • GraphQL Admin API（产品、订单、客户、库存）
  • Storefront API（购物车、结账、客户账户）
  • REST Admin API（旧版支持）
  • 应用开发（认证、Webhook、扩展）
  • 主题开发（Liquid、sections、blocks）
  • 无头电商（Hydrogen、Oxygen）
  • 结账定制（UI 扩展、验证）
  • Shopify Functions（折扣、配送、支付）
  • POS 扩展（线下销售）
  • 订阅与销售计划
  • 元字段与自定义数据
  • Shopify Flow 自动化
  • CLI 与开发工具
  • 隐私与合规
  • 性能优化

适用场景

当用户提及以下内容时可调用：

  • 平台：Shopify、电商、在线商店、商家
  • API：GraphQL、REST、Storefront API、Admin API
  • 产品：产品管理、集合、变体、库存
  • 订单：订单处理、履约、配送
  • 客户：客户数据、账户、认证
  • 结账：结账定制、支付方式、配送选项
  • 主题：Liquid 模板、主题开发、sections、blocks
  • 应用：应用开发、扩展、Webhook、OAuth
  • 无头：Hydrogen、React、无头电商、Oxygen
  • 函数：Shopify Functions、自定义逻辑、折扣
  • 订阅：定期计费、销售计划、订阅
  • 工具：Shopify CLI、开发工作流
  • POS：销售点、零售、线下支付

使用方式

回答问题时，可搜索特定主题、阅读特定文档、查找实现指南。例如：

# 使用 Grep 查找相关文档
grep -r "checkout" .claude/skills/shopify/docs/ --include="*.md"

# 阅读 API 文档
cat .claude/skills/shopify/docs/shopify/api-admin-graphql.md
cat .claude/skills/shopify/docs/shopify/api-storefront.md

# 列出所有指南
ls .claude/skills/shopify/docs/shopify/

核心能力

认证

涵盖 OAuth 2.0 流程与面向现代嵌入式应用的会话令牌（Session Tokens），示例使用 @shopify/shopify-api。

GraphQL Admin API

提供查询产品、创建产品、获取订单等示例，包含分页、价格区间、变体、库存、履约状态等字段。

Storefront API

提供创建购物车、更新购物车等示例，涉及 merchandiseId、checkoutUrl、成本金额等。

Webhook

提供注册 Webhook（如 ORDERS_CREATE）与验证 HMAC 签名的示例，强调使用 HTTPS 端点、立即返回 200、异步处理。

Liquid 模板

提供基础 Liquid 输出、条件逻辑、变体循环，以及自定义 section 的 schema 与渲染示例。

Shopify Functions

提供折扣函数（按数量计算折扣百分比）与配送定制函数（按购物车金额隐藏特定配送选项）示例。

Hydrogen（无头电商）

提供产品页面路由示例，使用 @shopify/remix-oxygen 与 Storefront 查询。

Shopify CLI

常用命令包括：

shopify app init
shopify app dev
shopify app deploy
shopify app generate extension
shopify theme init
shopify theme dev --store=your-store.myshopify.com
shopify theme push
shopify theme pull

测试

建议创建 Partner 账户与开发商店，安装应用并测试功能；提供创建测试产品与测试订单的示例。

安全最佳实践

  • API 密钥：存于环境变量、勿提交版本控制、按环境分离、泄露后轮换
  • Webhook：始终验证 HMAC 签名、仅用 HTTPS 端点、立即返回 200、异步处理
  • 访问范围：请求最小权限、记录每个范围用途、定期审查
  • 速率限制：遵守 API 速率限制、实现指数退避、监控 API 使用

常见错误

  • API 认证：无效访问令牌、商店未找到、缺少访问令牌
  • GraphQL 错误：用户错误、被限流、字段未找到
  • Webhook 问题：HMAC 无效、投递失败、未收到 Webhook

资源

  • 仪表盘：https://partners.shopify.com
  • 文档：https://shopify.dev
  • GraphiQL Admin：https://shopify.dev/docs/apps/tools/graphiql-admin-api
  • 社区：https://community.shopify.com
  • 状态：https://www.shopifystatus.com

文档快速参考

# 搜索所有文档
grep -r "search term" .claude/skills/shopify/docs/

# 查找特定主题
ls .claude/skills/shopify/docs/shopify/

# 阅读特定指南
cat .claude/skills/shopify/docs/shopify/webhooks.md

常见文档文件：api-admin-graphql.md、api-storefront.md、authentication.md、webhooks.md、apps.md、themes.md、liquid.md、hydrogen.md、checkout.md、functions.md、cli.md。

限制

文档需单独拉取，未拉取时可能无法访问官方文档内容。具体收费、价格、平台支持范围等未在资料中提供。