SuperAPI AI 工具集

shopify-customer

编程与开发

查看项目

更新于 11-17 03:51

技能介绍

用途:该技能帮助 Shopify 开发者针对最新版 Shopify Customer Account API 编写 GraphQL 查询和变更操作。Customer Account API 与 Admin API 不同:前者供已认证客户管理自己的账户、订单和偏好,后者用于商家店铺管理。

主要能力:技能会先分析开发者想通过 Customer Account API 完成的目标(如查看订单、管理地址、更新支付方式等),然后检索开发者文档寻找相似示例,再输出有效的 GraphQL 操作并附说明。输出时 GraphQL 操作需用 ```graphql 代码块包裹,并附上检索结果中使用的文档链接。

使用方式(资料中的强制流程):

  1. 每次响应都必须调用 bash 工具,先执行 scripts/search_docs.mjs "<query>" 检索文档,不得跳过。检索时搜索操作或组件名称而非完整用户问题,例如查询客户订单历史可检索 "customer orders query",并附带 --model、--client-name、--client-version 参数。
  2. 根据检索结果编写 GraphQL 代码。
  3. 返回代码前必须执行 scripts/validate.mjs,并带上 --code、--model、--client-name、--client-version、--artifact-id、--revision 等参数;artifact-id 为每个代码块生成的稳定随机 ID,重试时复用;revision 从 1 开始,同一产物每次重试递增。
  4. 若校验失败,仔细阅读错误,检索所指类型或属性名的正确值后修复并重新校验,最多重试 3 次;3 次失败后返回最佳尝试并说明原因。不得猜测有效值。
  5. 只有校验通过后才能向用户返回代码。

处理要点:Customer Account API 需要客户认证并在客户上下文中运行;客户只能访问自身数据;订单查询考虑历史、履约状态和退货信息;地址管理区分默认地址与附加地址;支付方式需考虑 PCI 合规;资料更新需验证必填字段和格式;访问客户信息时考虑隐私与数据保护要求。

隐私说明:scripts/search_docs.mjs 会向 Shopify(shopify.dev/mcp/usage)上报检索查询、检索响应或错误文本、技能名称/版本及模型/客户端标识;scripts/validate.mjs 会上报校验结果、技能名称/版本、模型/客户端标识、被校验代码及校验器相关上下文(如 API 名称、扩展目标、文件名、文件类型、主题路径、文件列表、artifact ID 与 revision)。可在环境中设置 OPT_OUT_INSTRUMENTATION=true 退出上报。

适用场景:需要为 Shopify 客户账户前端或集成编写 Customer Account API GraphQL 操作的开发工作。

限制:仅针对 Customer Account API,不适用于 Admin API 的商家店铺管理;功能依赖 bash 工具及上述两个脚本;资料未提供其他平台支持、收费或价格信息。