Community程式設計與開發github.com

shopify/ucp

當使用者想要使用UCP CLI來搜尋、比較、購買或追蹤來自線上商家的商品,或是設定與排解本機UCP設定檔(對於商家範圍的操作是必要的)的相關問題時使用。涵蓋全球商品目錄搜尋(「幫我找低於Y元的X」)、指定商家交易(「從Z.com買這個」)、訂單追蹤、`ucp profile init`、`ucp doctor`、購物車、結帳、訂單及UCP設定/說明。當無法直接透過協定結帳時,會退回至商家託管的轉接流程。

ucp 是什麼?

shopify/ucp 技能為 AI 代理(如 Claude Code、Cursor 或 Cursor 等)提供了一個橋樑,使其能夠透過 UCP(Unified Commerce Protocol)命令列介面與電子商務平台互動。此技能專注於三種主要操作:全球商品目錄搜尋(用於跨商家比價與探索)、指定商家交易(針對特定商家網站進行購買),以及管理個人使用者的 UCP 設定檔。它處理完整的購物流程,包括初始化設定檔(`ucp profile init`)、診斷連線問題(`ucp doctor`)、管理購物車、執行結帳以及追蹤訂單。值得注意的是,當客戶端與商家之間無法直接進行協定內結帳時,此技能會優雅地退回至商家託管的結帳流程,確保購物體驗即使在不完全相容的環境中也能完成。此技能在支援 UCP 協定的任何平台上都能無縫運作。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/ucp

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ucp 是做什麼的?

當使用者想要使用UCP CLI來搜尋、比較、購買或追蹤來自線上商家的商品,或是設定與排解本機UCP設定檔(對於商家範圍的操作是必要的)的相關問題時使用。涵蓋全球商品目錄搜尋(「幫我找低於Y元的X」)、指定商家交易(「從Z.com買這個」)、訂單追蹤、ucp profile init、ucp doctor、購物車、結帳、訂單及UCP設定/說明。當無法直接透過協定結帳時,會退回至商家託管的轉接流程。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

shopify/shopify-admin

Write or explain **Admin GraphQL** queries and mutations for apps and integrations that extend the Shopify admin. Use when the user wants to **understand, design, or generate** the operation itself—even before deciding how to run it. Do **not** choose `admin` first for **app or extension config validation** —use **`use-shopify-cli`**. Do **not** choose `admin` first to **execute** Admin GraphQL **now via Shopify CLI** or for CLI setup/troubleshooting on store workflows—use **`use-shopify-cli`** (store auth/execute, handle/SKU/location lookups, inventory changes).

shopify/shopify-admin-execution

Run a validated Admin GraphQL operation against a specific store using Shopify CLI. Use this when the user wants an executable store workflow, not just the query or mutation text. If the answer should include `shopify store auth` and `shopify store execute`, choose this API. Choose this for 'my store', 'this store', a store domain, product reads on a merchant store, low-inventory lookups, product updates, and warehouse/location inventory changes. Examples: 'Show me the first 10 products on my store', 'Find products with low inventory on my store', 'Set inventory at the Toronto warehouse so SKU ABC-123 is 12'.

shopify/shopify-app-store-review

Run a pre-submission compliance check against your Shopify app's codebase. Reviews App Store requirements and surfaces likely issues before you submit for official review.

shopify/shopify-custom-data

MUST be used first when prompts mention Metafields or Metaobjects. Use Metafields and Metaobjects to model and store custom data for your app. Metafields extend built-in Shopify data types like products or customers, Metaobjects are custom data types that can be used to store bespoke data structures. Metafield and Metaobject definitions provide a schema and configuration for values to follow.

shopify/shopify-customer

The Customer Account API allows customers to access their own data including orders, payment methods, and addresses.

shopify/shopify-dev

Search Shopify developer documentation across all APIs. Use only when no API-specific skill applies.

shopify/shopify-functions

Shopify Functions allow developers to customize the backend logic that powers parts of Shopify. Available APIs: Discount, Cart and Checkout Validation, Cart Transform, Pickup Point Delivery Option Generator, Delivery Customization, Fulfillment Constraints, Local Pickup Delivery Option Generator, Order Routing Location Rule, Payment Customization

shopify/shopify-hydrogen

Hydrogen storefront implementation cookbooks. Some of the available recipes are: B2B Commerce, Bundles, Combined Listings, Custom Cart Method, Dynamic Content with Metaobjects, Express Server, Google Tag Manager Integration, Infinite Scroll, Legacy Customer Account Flow, Markets, Partytown + Google Tag Manager, Subscriptions, Third-party API Queries and Caching. MANDATORY: Use this API for ANY Hydrogen storefront question - do NOT use Storefront GraphQL when 'Hydrogen' is mentioned.

shopify/shopify-liquid

Liquid is an open-source templating language created by Shopify. It is the backbone of Shopify themes and is used to load dynamic content on storefronts. Keywords: liquid, theme, shopify-theme, liquid-component, liquid-block, liquid-section, liquid-snippet, liquid-schemas, shopify-theme-schemas

shopify/shopify-onboarding-dev

Get started building on Shopify. Use when a developer asks to build an app, build a theme, create a dev store, set up a partner account, scaffold a project, or get started developing for Shopify. NOT for merchants managing stores.

shopify/shopify-onboarding-merchant

Set up and connect a Shopify store from your AI assistant. Use when the user wants to: set up my Shopify store, connect my store, install Shopify plugin, get started with Shopify, manage my store, add products to my store, merchant onboarding, start selling online, Shopify setup help, create my first store, how do I set up an online store, import products, migrate from Square, migrate from WooCommerce, migrate from Etsy, migrate from Amazon, migrate from eBay, migrate from Wix, import from Google Merchant Center, migrate from Clover, migrate from Lightspeed, move products to Shopify, import catalog, replatform to Shopify. This is for store owners — not developers.

shopify/shopify-partner

The Partner API lets you programmatically access data about your Partner Dashboard, including your apps, themes, and affiliate referrals.

shopify/shopify-payments-apps

The Payments Apps API enables payment providers to integrate their payment solutions with Shopify's checkout.

shopify/shopify-polaris-admin-extensions

Add custom actions and blocks from your app at contextually relevant spots throughout the Shopify Admin. Admin UI Extensions also supports scaffolding new adminextensions using Shopify CLI commands.

shopify/shopify-polaris-app-home

Build your app's primary user interface embedded in the Shopify admin. If the prompt just mentions `Polaris` and you can't tell based off of the context what API they meant, assume they meant this API.

shopify/shopify-polaris-checkout-extensions

Build custom functionality that merchants can install at defined points in the checkout flow, including product information, shipping, payment, order summary, and Shop Pay. Checkout UI Extensions also supports scaffolding new checkout extensions using Shopify CLI commands.

shopify/shopify-polaris-customer-account-extensions

Build custom functionality that merchants can install at defined points on the Order index, Order status, and Profile pages in customer accounts. Customer Account UI Extensions also supports scaffolding new customer account extensions using Shopify CLI commands.

shopify/shopify-pos-ui

Build retail point-of-sale applications using Shopify's POS UI components. These components provide a consistent and familiar interface for POS applications. POS UI Extensions also supports scaffolding new POS extensions using Shopify CLI commands. Keywords: POS, Retail, smart grid

shopify/shopify-storefront-graphql

Use for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI. NOT for Web Components - if the prompt mentions HTML tags like <shopify-store>, <shopify-cart>, use storefront-web-components instead.

shopify/shopify-use-shopify-cli

Choose when the user needs **Shopify CLI** to run or fix something now: validate app or extension config on disk (`shopify.app.toml`, `shopify.app.<name>.toml`, `shopify.extension.toml`); run or troubleshoot store workflows (`shopify store auth`, `shopify store execute`); inventory or product changes by handle, SKU, or location name; or CLI setup, auth, upgrade issues. Emphasize **commands and operational steps**, not only authoring GraphQL. Skip for API-only understanding or codegen with no CLI execution. Examples: validate configuration before deploy; run an existing query via CLI; list products; missing `shopify store execute`.

相關技能