SuperAPI AI 工具集

polaris-app-home-page-patterns

通用与其它

查看项目

更新于 10-16 03:47

技能介绍

用途:这是 Polaris App Home 表面的命名模式索引,涵盖 Shopify 文档中的模板(整页布局)与组合(由 <s-*> Web Components 搭建的多元件配方)。每条目给出结构骨架、意图与反模式,便于代理无需额外取数即可搭建页面。

适用:在 Admin App Home 应用中新建整页(Homepage、Index、Details、Settings);任务点名或暗示已知组合模式(Empty state、Setup guide、Callout card、Metrics card、Resource list 等)。不适用:组件级工作请用 polaris-app-home-web-components;API 级工作(toast、modal、save bar)请用 polaris-app-home-app-bridge。

用法:先匹配模板或组合,以所列骨架为起点;超出骨架的规范细节通过 shopify-dev-mcp → search_docs_chunks(api_name: "polaris-app-home",prompt 用模式名)获取;实现使用 Polaris 组件与 App Bridge API,并结合 Common Composition Idioms 复用积木;用 validate_component_codeblocks(api: "polaris-app-home")校验,同一产物两次失败即停止并上报错误。

路由约定:Homepage → app._index.jsx;Index → app.[resources].jsx(复数);Details → app.[resource].$id.jsx(单数加 id);Settings → app.settings.jsx。

模板与组合:模板含 Homepage、Index、Details(form + s-page + aside + Save Bar + 确认 modal)、Settings(form data-save-bar + 分组 s-section)。组合含 Account connection、App card、Callout card、Empty state、Footer help、Index table、Interstitial nav、Media card、Metrics card、Resource list、Setup guide,各附骨架与 Avoid 提示。

限制:模式是参考示例而非严格模板,可自由改写;须遵守各条目 Avoid 约束(如 Index table 不建议用于小数据集、需分页;Resource list 不用于超大数据集;Setup guide 需持久化关闭状态);Media card 必须保留 accessibilityLabel。资料未提供定价、平台支持范围与效果数据。