用途：为 Shopify 店铺中缺少 alt 属性的图片批量补齐替代文本。alt 首先是无障碍要求（屏幕阅读器会朗读），其次是图片 SEO 信号；本技能只填补空白，不重写已有 alt。
主要能力：商品媒体与 Files 库（主题区块、metaobject、富文本、集合横幅）中的图片都是 MediaImage 节点，统一通过 fileUpdate 写入 alt，无需学习单独的商品媒体 alt 变更接口。查找路径有两条：分页商品并读取 product.media（需 read_products）；分页 files 连接（需 read_files）。两者都返回 MediaImage GID，直接交给 fileUpdate。写入需 write_files。
使用方式：两种接入方式。方式 A 使用自定义应用令牌，在后台创建应用并授予最小权限，导出环境变量 SHOPIFY_STORE 与 SHOPIFY_ACCESS_TOKEN（令牌只放环境变量，不写入文件），再调用 GraphQL 端点。方式 B 使用 Shopify CLI OAuth：shopify store auth --store $SHOPIFY_STORE --scopes read_products,read_files,write_files，再用 shopify store execute 执行。方式 B 需先运行 shopify version 确认 CLI 已安装；可搭配官方 AI 工具包插件：claude plugin marketplace add Shopify/Shopify-AI-Toolkit 与 claude plugin install shopify-plugin@shopify-ai-toolkit。
安全准则：只填充缺失项，alt 为 null 或去空白后为空才算候选；先跑只读计数并核对数量是否合理；若用 LLM 生成说明，先用一次 1-token 真实补全验证密钥；逐条记录写入（GID、来源、旧值、新值、状态）；写后通过 Admin API 回读确认，店铺前台有 CDN 缓存不可作为依据；绝不打印或提交令牌。
alt 文本规范：描述图像本身而非营销话术，控制在约 125 字符内，不堆砌关键词，装饰性或重复图片用空 alt，不加“image of”前缀。
限制：这是操作配方而非可长期运行的程序，GraphQL 片段需按当前 schema 改写；版本固定为 Admin API 2025-07，Shopify 按季度弃用版本，使用前应核对 fileUpdate；productUpdateMedia 已弃用。参考文件 references/queries.md 提供两条查找路径的计数、获取、更新与验证配方。