技能介绍

要解决什么问题

Shopify 博客文章往往直接在 Admin 里写 HTML，meta、canonical、JSON-LD 等又常不在 Article API 可改范围内。人工做 SEO 审计容易漏掉标题结构、空标签、坏链和「听起来很权威但缺出处」的表述；更麻烦的是，改完再 publish 之前很难把 审计结论、改动说明和店面前预览 放在同一份交付物里给运营核对。

本技能面向「已安装、具备读写 content（或等效 online store pages）权限」的店铺，用 Admin GraphQL 作为文章真源，而不是把公开 URL 当唯一依据。

工作方式

连接与边界：配置私有 skill-hub.env，跑连接检查（店铺、授权方式、已授予 scope、下一步动作）。缺 read scope 不继续；缺 write scope 可做审计与报告，但在权限升级获批前不得写入。
选定文章：只接受 --url、--title、--article-id 之一；确认标题、handle、blog、Article ID、发布状态与店面前 URL，不静默选「第一个近似匹配」。
审计与候选稿：按 audit-checklist 做确定性检查，按 eeat-methodology 处理事实与敏感表述；代理生成 candidate.json（正文/可选摘要、改动清单、研究来源、E-E-A-T 结论、精确 updates 包），并渲染单一 HTML 报告（审计分级、前后对比、批准包、响应式店面前预览；仅 Preview，非已发布）。
批准与写入：商户在报告中显式批准或拒绝；仅批准后带 approved: true（或 approval.confirmed: true）执行 articleUpdate，再读回文章，按语义标记、链接与 HTML 安全做验证（非字节级 HTML 比对）。

默认低风险优化包括：稳定 heading id、可点击 TOC、有证据支撑的 FAQ/HowTo、可读标题与列表、拼写语法、空元素清理、已核实链修复、与上下文一致的图片 alt、空白摘要补写。不编造 E-E-A-T 证据；凭证、一手经验、新事实主张、监管/安全类建议等需商户输入。

边界与注意

未经商户扩大范围，不改 handle、发布状态、作者、标签、图片、主题文件或 metafields。
正文 HTML 不插入脚本、JSON-LD、JavaScript、表单、iframe、事件处理器或隐藏关键词块；SEO 元数据在 Article API 不能直接改时单独审计说明。
店面前密码保护或不可达时，报告用明确标注的 theme-like fallback，不声称已验证真实前台。
连接失败按 SKILL 约定处理（网络/407/401/403/SCOPE_UPDATE_REQUIRED/shop_not_permitted 等），不盲重试 GraphQL。