重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
shopify-developer by tech-leads-club/agent-skills
npx skills add https://github.com/tech-leads-club/agent-skills --skill shopify-developer面向专业 Shopify 开发的全面参考 - API 版本 2026-01。
| 项目 | 值 |
|---|---|
| API 版本 | 2026-01 (稳定版) |
| GraphQL Admin API | POST https://{store}.myshopify.com/admin/api/2026-01/graphql.json |
| Storefront API | POST https://{store}.myshopify.com/api/2026-01/graphql.json |
| Ajax API (主题) | /cart.js, /cart/add.js, |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
/cart/change.js| CLI 安装 | npm install -g @shopify/cli |
| 主题开发 | shopify theme dev --store {store}.myshopify.com |
| 应用开发 | shopify app dev |
| 部署 | shopify app deploy |
| 文档 | shopify.dev |
阅读与你任务匹配的参考文件:
Liquid 模板 - 编写或调试 .liquid 文件:
主题开发 - 构建或自定义主题:
API 集成 - 以编程方式获取或修改数据:
应用开发 - 构建 Shopify 应用:
无服务器逻辑 - 自定义业务规则:
无头电商 - 自定义店面:
优化与故障排除:
| 已弃用 | 替代方案 | 截止日期 |
|---|---|---|
| Shopify Scripts | Shopify Functions | 2025年8月 (迁移),停止服务时间待定 |
| checkout.liquid | Checkout Extensibility | 2024年8月 (Plus),已完成 |
| REST Admin API | GraphQL Admin API | 积极弃用 (暂无移除日期) |
| 旧版自定义应用 | 新认证模型 | 2025年1月 (已完成) |
| Polaris React | Polaris Web Components | 积极迁移中 |
| Remix (应用框架) | React Router 7 | Hydrogen 2025.5.0+ |
三种语法类型:
{{ product.title | upcase }} {# 带过滤器的输出 #}
{% if product.available %}有货{% endif %} {# 逻辑标签 #}
{% assign sale = product.price | times: 0.8 %} {# 赋值 #}
{%- if condition -%}去除空白符{%- endif -%}
关键模式:
{% for product in collection.products limit: 5 %}
{% render 'product-card', product: product %}
{% endfor %}
{% paginate collection.products by 12 %}
{% for product in paginate.collection.products %}...{% endfor %}
{{ paginate | default_pagination }}
{% endpaginate %}
// GraphQL Admin - 始终使用 GraphQL 而非 REST
const response = await fetch(`https://${store}.myshopify.com/admin/api/2026-01/graphql.json`, {
method: 'POST',
headers: {
'X-Shopify-Access-Token': accessToken,
'Content-Type': 'application/json',
},
body: JSON.stringify({ query, variables }),
})
const { data, errors } = await response.json()
if (errors) throw new Error(errors[0].message)
// Ajax API (仅限主题的购物车操作)
fetch('/cart/add.js', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ id: variantId, quantity: 1 }),
})
| 文件 | 行数 | 覆盖范围 |
|---|---|---|
| liquid-syntax.md | ~600 | 标签、控制流、迭代、变量、空白符、LiquidDoc |
| liquid-filters.md | ~870 | 字符串、数字、数组、Shopify 特定、日期、URL、颜色过滤器 |
| liquid-objects.md | ~695 | 所有 Shopify 对象:产品、变体、合集、购物车、客户、订单等 |
| theme-development.md | ~1200 | 文件结构、JSON 模板、区块、块、设置模式、布局 |
| api-admin.md | ~595 | GraphQL 查询/变更、REST (旧版)、OAuth、Webhook、速率限制 |
| api-storefront.md | ~235 | Storefront API、Ajax API、购物车操作、客户账户 API |
| app-development.md | ~760 | CLI、应用架构、扩展、Polaris Web 组件、部署 |
| functions.md | ~300 | 函数类型、Rust/JS 目标、CLI 工作流、Scripts 迁移 |
| hydrogen.md | ~375 | 设置、路由、数据加载、Storefront API、部署 |
| performance.md | ~605 | 图片、JS、CSS、字体、Liquid、第三方脚本、核心 Web 指标 |
| debugging.md | ~650 | Liquid、JavaScript、API、购物车、Webhook、主题编辑器故障排除 |
每周安装量
51
仓库
GitHub 星标数
1.9K
首次出现
2026年2月21日
安全审计
安装于
gemini-cli51
amp51
github-copilot51
codex51
kimi-cli51
opencode51
Comprehensive reference for professional Shopify development - API version 2026-01.
| Item | Value |
|---|---|
| API version | 2026-01 (stable) |
| GraphQL Admin | POST https://{store}.myshopify.com/admin/api/2026-01/graphql.json |
| Storefront API | POST https://{store}.myshopify.com/api/2026-01/graphql.json |
| Ajax API (theme) | /cart.js, /cart/add.js, /cart/change.js |
| CLI install | npm install -g @shopify/cli |
| Theme dev | shopify theme dev --store {store}.myshopify.com |
| App dev | shopify app dev |
| Deploy | shopify app deploy |
| Docs | shopify.dev |
Read the reference file(s) that match your task:
Liquid templating - writing or debugging .liquid files:
Theme development - building or customising themes:
API integration - fetching or modifying data programmatically:
App development - building Shopify apps:
Serverless logic - custom business rules:
Headless commerce - custom storefronts:
Optimisation and troubleshooting :
| Deprecated | Replacement | Deadline |
|---|---|---|
| Shopify Scripts | Shopify Functions | August 2025 (migration), sundown TBD |
| checkout.liquid | Checkout Extensibility | August 2024 (Plus), done |
| REST Admin API | GraphQL Admin API | Active deprecation (no removal date yet) |
| Legacy custom apps | New auth model | January 2025 (done) |
| Polaris React | Polaris Web Components | Active migration |
| Remix (app framework) | React Router 7 | Hydrogen 2025.5.0+ |
Three syntax types:
{{ product.title | upcase }} {# Output with filter #}
{% if product.available %}In stock{% endif %} {# Logic tag #}
{% assign sale = product.price | times: 0.8 %} {# Assignment #}
{%- if condition -%}Stripped whitespace{%- endif -%}
Key patterns:
{% for product in collection.products limit: 5 %}
{% render 'product-card', product: product %}
{% endfor %}
{% paginate collection.products by 12 %}
{% for product in paginate.collection.products %}...{% endfor %}
{{ paginate | default_pagination }}
{% endpaginate %}
// GraphQL Admin - always use GraphQL over REST
const response = await fetch(`https://${store}.myshopify.com/admin/api/2026-01/graphql.json`, {
method: 'POST',
headers: {
'X-Shopify-Access-Token': accessToken,
'Content-Type': 'application/json',
},
body: JSON.stringify({ query, variables }),
})
const { data, errors } = await response.json()
if (errors) throw new Error(errors[0].message)
// Ajax API (theme-only cart operations)
fetch('/cart/add.js', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ id: variantId, quantity: 1 }),
})
| File | Lines | Coverage |
|---|---|---|
| liquid-syntax.md | ~600 | Tags, control flow, iteration, variables, whitespace, LiquidDoc |
| liquid-filters.md | ~870 | String, numeric, array, Shopify-specific, date, URL, colour filters |
| liquid-objects.md | ~695 | All Shopify objects: product, variant, collection, cart, customer, order, etc. |
| theme-development.md | ~1200 | File structure, JSON templates, sections, blocks, settings schema, layout |
| api-admin.md | ~595 |
Weekly Installs
51
Repository
GitHub Stars
1.9K
First Seen
Feb 21, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
gemini-cli51
amp51
github-copilot51
codex51
kimi-cli51
opencode51
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
172,600 周安装
| GraphQL queries/mutations, REST (legacy), OAuth, webhooks, rate limiting |
| api-storefront.md | ~235 | Storefront API, Ajax API, cart operations, Customer Account API |
| app-development.md | ~760 | CLI, app architecture, extensions, Polaris Web Components, deployment |
| functions.md | ~300 | Function types, Rust/JS targets, CLI workflow, Scripts migration |
| hydrogen.md | ~375 | Setup, routing, data loading, Storefront API, deployment |
| performance.md | ~605 | Images, JS, CSS, fonts, Liquid, third-party scripts, Core Web Vitals |
| debugging.md | ~650 | Liquid, JavaScript, API, cart, webhook, theme editor troubleshooting |