mcpField
O
optimize-shopify-alt-text

optimize-shopify-alt-text

github.com/lvsao营销与增长1336 次安装10 周前更新
代码仓库

关于 optimize-shopify-alt-text

一个用于优化 Shopify 图片替代文本的 skill，涵盖产品、系列、文章特色图片及文章内图片。它通过目标定位或全店扫描生成预览方案，并要求获批后才执行写入。

主要功能

  1. 01处理产品和系列图片替代文本
  2. 02处理文章特色及内嵌图片
  3. 03按目标定位或全店扫描
  4. 04执行写入前生成预览
  5. 05写入后验证并清理临时文件

适用场景

  1. 01更新指定产品图片描述
  2. 02规划全店图片替代文本
  3. 03审核文章内嵌图片属性
  4. 04核对获批写入结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lvsao/shopify-skill-hub --skill optimize-shopify-alt-text

安装后在 Claude Code 中输入/optimize-shopify-alt-text确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
alt-text-rules.md
onboarding-guide.md
scripts/
shopify-alt-text-admin.mjs

详细介绍

优化 Shopify 替代文本

不可妥协事项

  • 必须先运行 npx --yes skills update optimize-shopify-alt-text -g -y。如果失败，请停止。如果成功，请重新阅读本文件以及 references/onboarding-guide.md 和 references/alt-text-rules.md。
  • 先预览每项拟议写入。只有在获得明确批准后，才能使用 --execute。
  • 除图片替代文本外，绝不编辑任何内容。对于文章正文，只能更新行内 <img alt=""> 属性。
  • 除非宿主实际通过原生图像输入打开了本地图片，否则不得声称进行了视觉检查。
  • 如果无法使用视觉功能，请切换到仅基于上下文的回退方案，并明确标注较低的置信度。
  • 保持产物整洁：skill-hub.env 可以留在工作目录中；使用后必须删除临时下载文件和机器可读的计划文件。
  • 替代文本应简洁。目标长度为 60-120 个字符，通常不超过 125 个字符，且绝不能超过 Shopify 的 512 字符硬性限制。

请先阅读

  • references/onboarding-guide.md：了解 Shopify 通用设置
  • references/alt-text-rules.md：了解措辞、长度和重复规则

支持的范围

  • 产品 MediaImage 替代文本
  • 商品系列特色图片 altText
  • 文章特色图片 altText
  • article.body 中文章行内图片的 alt 属性

路由规则

  • 如果用户指定了产品、商品系列、文章、媒体 ID 或 CDN 图片 URL，请从 target 开始。
  • 仅在处理全店请求、批量规划、消除歧义或验证写入后的数量时使用 scan。
  • 仅针对当前审核批次添加 --download。
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs target --env skill-hub.env --product "Example Product"
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs target --env skill-hub.env --collection <collection-handle-or-url>
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs target --env skill-hub.env --article <article-url-or-title>
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs target --env skill-hub.env --media-id gid://shopify/MediaImage/...
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs target --env skill-hub.env --url <cdn-image-url>
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs scan --env skill-hub.env --page-size 50

工作流

  1. 仅当缺少 skill-hub.env 或其内容不完整时，才遵循通用引导流程。
  2. 运行 connection-check。
  3. 对于特定请求，使用 target；对于广泛请求，使用 scan。
  4. 如果需要视觉功能，请运行 vision-sample，并确认模型能够描述本地文件中的像素事实。
  5. 根据 references/alt-text-rules.md 审核当前批次。
  6. 创建一个预览计划，并使用 vision 或 context_only 等来源标签。
  7. 运行不带 --execute 的 apply，以生成预览包。
  8. 获得批准后，重新运行 apply --execute。
  9. 验证数量或指定的目标，然后清理临时文件。

脚本入口

请使用捆绑的辅助工具，而不是临时编写 GraphQL 或一次性脚本：

node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs init-env --method admin_custom_app --env skill-hub.env
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs init-env --method dev_dashboard_app --env skill-hub.env
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs connection-check --env skill-hub.env
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs scan --env skill-hub.env --page-size 50
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs vision-sample --env skill-hub.env --limit 3
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs apply --env skill-hub.env --input -
node <absolute-path-to-skill>/scripts/shopify-alt-text-admin.mjs apply --env skill-hub.env --input - --execute

输出与验证

  • 输出应保持对话式，并附上预览 JSON 或辅助工具的 stdout。
  • 执行后，使用 target 或 scan 验证更新后的目标。
  • 单独报告任何 context_only 项目。

评论

支持 Markdown