用途:为 Shopify Admin App Home 页面编写或编辑 Polaris <s-> Web Components 标记时提供组件目录、规则与常见写法。不适用于购买后扩展、调用 shopify. API 或 useAppBridge、以及搭建首页/详情/设置等页面模式(应分别使用对应技能)。
主要能力:按布局与结构、排版与内容、操作、表单、反馈与状态、媒体与视觉、浮层、表格等分组列出组件及其关键属性与注意事项。例如 <s-page> 作为外层容器并通过插槽配置标题栏;<s-section> 为内容卡片;<s-stack>、<s-grid> 负责布局;<s-button>、<s-link>、<s-clickable> 处理交互;表单类包含文本、选择、日期、颜色等字段;反馈类含 <s-banner>、<s-badge>、<s-spinner>;浮层含 <s-popover>、<s-modal>;表格含 <s-table> 系列。
使用方式:先在组件目录中查找组件,缺失时通过 shopify-dev-mcp 的 search_docs_chunks(api_name: "polaris-app-home")检索,不要用 fetch_full_docs。按规则与常见写法编写标记,再用 validate_component_codeblocks(api: "polaris-app-home")校验;同一产物连续两次校验失败应停止并通过 AskUserQuestion 提示重试、跳过或中止。
限制:不存在 <s-app>、<s-skeleton-body-text>、<s-title-bar>、<s-save-bar> 等组件;<s-link> 仅用于导航;<s-app-nav>、<s-app-window> 属于 App Bridge,不在本技能校验范围;间距与尺寸使用 SpacingKeyword/SizeKeyword 刻度。具体组件属性以资料所列为准,未提及的功能暂未提供。