用途：作为 Shopify 开发的协调枢纽，按任务加载 references/ 下对应参考文件，而非一次性读取全部内容。
主要能力：涵盖主题架构与 OS 2.0、Liquid 对象与过滤器、Admin GraphQL、Storefront GraphQL、元字段/元对象定义与读写、结账可扩展性（Checkout UI Extensions、Shopify Functions）、Webhook 与平台限制等主题。
认证与端点：使用季度 API 版本（如 2026-01）。Admin GraphQL 端点为 https://${SHOP}.myshopify.com/admin/api/${API_VERSION}/graphql.json，请求头 X-Shopify-Access-Token: ${SHOPIFY_ACCESS_TOKEN}。Storefront GraphQL 端点为 https://${SHOP}.myshopify.com/api/${API_VERSION}/graphql.json，请求头 X-Shopify-Storefront-Access-Token: ${SHOPIFY_STOREFRONT_TOKEN}。两者 Content-Type 均为 application/json。运行命令前先从 ~/.agents/.env 加载环境变量。
API 约定：新工作优先 GraphQL 而非 REST；URL 含 API 版本并季度更新；用游标（first/after）分页；同时处理顶层错误与 mutation 的 userErrors；按可用点数预算查询成本与限流；大批量导入导出用 bulk operations；写入尽量幂等以便重试。
核心工作流：主题开发先拉取当前主题状态、本地迭代、推送到草稿，验证编辑器行为后再发布，参考 theme-architecture.md 与 liquid.md。产品与元字段先定义 schema 再通过 Admin API 写入，在 Liquid 与 Storefront API 中用类型安全模式读取，参考 admin-api.md 与 metafields-metaobjects.md。结账定制用 Checkout UI Extensions 与 Shopify Functions，区分 UI 与定价/履约逻辑，参考 checkout-extensibility.md 与 shopify-functions.md。
注意事项：Liquid 渲染元字段用 .value；删除用 metafieldsDelete（复数）；不要依赖 checkout.liquid；Scripts 迁移需在 2026 年 6 月 30 日停用前完成；REST Admin API 仅作维护；在 12 个月支持窗口结束前升级到受支持版本；2026 年 4 月 1 日强制前为写入实现幂等键；升级时移除已弃用的 Storefront 税字段；不要手改 config/settings_data.json，使用 Theme Editor；Shopify Functions 逻辑保持精简以符合运行时限制。
限制：具体价格、套餐能力差异及更细的实现细节需查阅对应参考文件，本次资料未提供。