用途
AI 助手会检查网站的 schema.org/Organization JSON-LD，以确认该网站是真实品牌（而非仿冒品或经销商），并通过 sameAs 将其关联到公开身份（官方社交账号、Wikipedia/Wikidata），同时提供机器可读的 contactPoint。缺少该结构化数据时，智能体可能不愿推荐该店铺或引导买家访问。本技能从店铺数据与用户提供的社交链接构建 Organization JSON-LD 块，并通过受管理的代码片段注入主题布局，修复组织架构数据（org-schema）与机器联系方式（machine-contact），并通过 sameAs 支持 Wikidata QID。
主要能力
- 从店铺查询获取 Organization 核心字段：店铺名称、主域名、联系邮箱。
- 查询主题（MAIN 角色）以获取当前布局文件与片段文件是否已存在。
- 通过 themeFilesUpsert 写入
snippets/agentic-organization-schema.liquid（包含 JSON-LD 脚本），并在layout/theme.liquid的<head>中按需插入受管理的{% render 'agentic-organization-schema' %}行。 - 注入方式为增量修改，使用 # BEGIN/END 标记块与独立片段文件，保证重复运行与回滚干净。
- 支持 dry_run（默认开启）预览片段与注入，不写入实时主题。
- 支持 human 与 json 两种输出格式。
使用方式
前置条件：已认证的 Shopify CLI 会话（shopify auth login --store <domain>），所需 API 权限为 read_themes、write_themes。
通用参数：store（必填，店铺域名，如 mystore.myshopify.com）、format（可选，human 或 json，默认 human）、dry_run（可选，默认 true）。
技能专属参数：theme_id（可选，主题 GID，默认已发布的 MAIN 主题）、logo_url（可选，绝对 Logo URL，若主题设置可用则从中推断）、same_as（可选，官方主页 URL 的逗号分隔列表，如 Instagram、TikTok、LinkedIn、Wikipedia、Wikidata）、contact_email（可选，contactPoint 的客服邮箱，否则使用店铺 contactEmail）、contact_phone（可选，contactPoint 的支持电话）。
工作流步骤：1）对 shop 执行 query，获取店铺名称、主域名、联系邮箱；2）对 themes 执行 query，获取 MAIN 主题下的 layout/theme.liquid 与目标片段文件内容；3）执行 themeFilesUpsert 变更，写入片段并在 layout/theme.liquid 中按需插入 render 行（dry_run 时跳过）。
GraphQL 操作与片段内容详见官方资料，技能会通过 Shopify Admin API（api_version 2025-01）执行上述查询与变更。
适用场景
适用于希望让 AI 购物助手、搜索引擎知识面板等系统将 Shopify 店铺识别为真实可信品牌并愿意推荐的商家。尤其适合需要提供官方社交与维基身份链接、机器可读客服联系方式的店铺。
限制与安全提示
第 3 步 themeFilesUpsert 会写入片段并编辑实时主题的 layout/theme.liquid。尽管修改是增量的（在 <head> 中插入一行 {% render %}），但会立即发布，且对 theme.liquid 的错误编辑可能导致渲染中断。默认 dry_run 为 true，建议先复制主题。仅应在 sameAs 中填写真实、官方的 URL；Wikipedia/Wikidata 链接是极强的身份信号。建议使用绝对 HTTPS 的 Logo URL（方形 PNG 最适合知识面板）。错误处理：THROTTLED 时等待 2 秒重试最多 3 次；ACCESS_DENIED（缺少 write_themes）时中止并输出片段供手动粘贴；布局 upsert 出现 userErrors 时仅写入片段，跳过布局编辑，并提示手动 {% render %} 指令。