用途:用于创建、重设计、重构或审查 Shopify 店面,围绕商业事实组织工作,例如展示哪个商品或集合、顾客选了什么、现在能买什么、哪个价格权威,以及哪些状态应放在 URL、Shopify、服务端缓存或浏览器中。以 Vercel Shop 模板为参考实现,但按当前店面适配行为,而非盲目复制文件。
主要能力:先阅读项目的 AGENTS.md、目标路由、视图契约及其调用的每个操作;在依赖本文前检查模板源码,涉及模板规则、路由与布局外壳、Shopify 边界、Next.js 缓存边界、共享 UI 基元及公开源码回退。按领域与执行上下文组织 lib/,使用 index.ts、server.ts、client.ts、action.ts、types.ts 等上下文文件,避免新增描述性同级文件、扁平根模块、空入口、转发导出或桶文件。默认保留组件内联文案与 lib/content/index.ts 内容函数;不要为单次部署引入 t() 解析器、完整浏览器目录或 next-intl。保持 Shopify 边界明确,使用已安装的 Shopify AI Toolkit 做 API 文档、schema 与操作验证。默认禁用 Shop Agent、顾客认证与 BotID,重设计或本地化不得隐式启用。优先用浏览器反馈闭环验证,先启动本地店面并打开受影响路由,如 agent-browser open http://localhost:3000/...,再等待 networkidle、快照与整页截图,通过 UI 实际执行变体选择、筛选、分页、购物车增删改、认证重定向等交互。
适用场景:首页与营销路由、集合与搜索路由、商品路由、购物车与已认证账户路由、购物车提供者与乐观状态及变更,以及区域商业与本地化改造。
限制与缺失:资料未提供具体的收费、价格、平台支持范围或效果数据,暂未提供。资料仅给出一种静态热点扫描命令:node scripts/audit-storefront.mjs <storefront-root>,并强调其输出仅作为审查提示而非度量。只有在构建、预渲染、缓存、打包、部署行为或发布准备在范围内时才要求生产构建;打包分析或线上字段数据仅用于明确的性能调查。若 agent-browser 不可用,需说明并报告所使用的回退检查方式。