SuperAPI AI 工具集

shopify-liquid

编程与开发

查看项目

更新于 11-17 04:52

技能介绍

用途

shopify-liquid 是一个面向 Shopify 主题开发的技能,帮助开发者或 AI 代理使用 Liquid 模板语言编写符合规范的主题组件。Liquid 是 Shopify 创建的开源模板语言,是 Shopify 主题的基础,用于在商店前台加载动态内容。

主要能力

  • 按标准主题目录结构组织代码:assets(静态资源)、blocks(可复用、可嵌套、可定制的组件)、config(全局主题设置)、layout(页面顶层包装)、locales(翻译文件)、sections(可被商家定制的模块)、snippets(可复用代码片段)、templates(页面结构定义)。
  • 指导编写 sections、blocks、snippets、layout、config、locales、templates 等文件,并说明各自约束:sections 需包含 {% schema %} 标签,块包装元素需使用 {{ block.shopify_attributes }};blocks 可嵌套并使用 {% content_for 'blocks' %};snippets 通过 {% render %} 调用;layout 需包含 {{ content_for_header }} 与 {{ content_for_layout }}。
  • 要求为 snippets 与静态渲染的 blocks 编写 LiquidDoc 头({% doc %} 标签),声明参数与示例。
  • 说明 Liquid 语法要点与限制:无括号条件、无三元运算符、contains 仅适用于字符串、for 循环最多 50 次需配合 paginate、render 为隔离作用域需传参。
  • 介绍常用标签(content_for、form、render、paginate、liquid、schema、stylesheet、javascript、style、layout、doc)与常用过滤器(图像、数组、字符串、数学、金额、日期、颜色、HTML、文件、翻译等)。
  • 要求所有面向用户的文本使用 {{ 'key' | t }} 翻译键,并同步更新 locales/en.default.json。
  • 提出设计与代码规范:现代浏览器特性、WCAG 2.1 无障碍、语义化 HTML、视图过渡 API,以及不写注释、不引用资源文件或 JS/CSS 库等要求。

使用方式

该技能通过 bash 工具执行两个脚本,并要求每次响应都按顺序调用:

  1. 写代码前先检索文档: scripts/search_docs.mjs "<query>" --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION
  2. 依据检索结果编写代码。
  3. 返回代码前进行校验: scripts/validate.mjs --code '...' --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION --artifact-id YOUR_ARTIFACT_ID --revision REVISION_NUMBER

校验有两种模式:完整应用模式(--theme-path 加 --files,适用可访问主题目录的环境)与无状态模式(--filename、--filetype 加 --code,适用仅有代码块的环境)。校验失败时需先检索对应标签或过滤器的正确用法,修正后重新校验,最多重试 3 次;超过 3 次则返回最佳尝试并说明原因。

适用场景

适用于 Shopify 主题开发,尤其是生成和检查 sections、blocks、snippets 等组件代码,以及在编写 Liquid 前查询对象属性、过滤器与 API 用法。

限制

  • 该技能面向主题代码生成与校验,不涉及商店运营、商品管理等其他功能。
  • 依赖 bash 工具及上述两个脚本;未提供脚本时无法按既定流程执行。
  • 脚本会向 Shopify 上报检索查询、校验结果、技能名称/版本、模型与客户端标识等信息,可通过设置 OPT_OUT_INSTRUMENTATION=true 退出上报。
  • 资料未说明该技能的收费、价格或平台支持范围,这些信息暂未提供。